Simulation Functions

Below are example simulation functions available in libEnsemble. Most of these demonstrate an inexpensive algorithm and do not launch tasks (user applications). To see an example of a simulation function launching tasks, see the Electrostatic Forces tutorial.

Important

See the API for simulation functions here.

Simple simulation functions

Ideal for simple debugging of generator processes or system testing.

• Borehole function
• Borehole function with kills
• Chwirut1 vector-valued function
• Inverse Bayesian likelihood
• Norm
• Rosenbrock test optimization function
• Six Hump Camel
• Test noisy function
• Test periodic function

Functions that run user applications

These use the executor to launch applications and in some cases handle dynamic CPU/GPU allocation.

The Variable resources module contains basic examples, while the Template examples use a simple MPI/OpenMP (with GPU offload option) application (forces) to demonstrate libEnsemble’s capabilities on various HPC systems. The build_forces.sh file gives compile lines for building the simple forces application on various platforms (use -DGPU to build for GPU).

• Variable resources
• Template for CPU executables
• Template for CPU executables with input file
• Template for GPU executables
• Template for GPU executables with dynamic resources
• Template with dynamic resources (CPU app and GPU app)
• WarpX Example

Special simulation functions

• Mock simulation evaluations (re-run using history file)