Exit Criteria

The following criteria (or termination tests) can be used to configure when to stop a workflow.

Can be constructed and passed to libEnsemble as a Python class or a dictionary. When provided as a Python class, all data is validated immediately on instantiation.

pydantic model libensemble.specs.ExitCriteria

Specifications for configuring when libEnsemble should stop a given run. Equivalent to an exit_criteria dictionary.

Fields:

• sim_max (int | None)

• gen_max (int | None)

• wallclock_max (float | None)

• stop_val (Tuple[str, float] | None)

field gen_max: int | None = None

Stop when this many new points have been generated by generator functions

field sim_max: int | None = None

Stop when this many new points have been evaluated by simulation functions

field stop_val: Tuple[str, float] | None = None

Stop when H[str] < float for the given (str, float) pair

field wallclock_max: float | None = None

Stop when this much time (in seconds) has elapsed since the manager initialized

See also

From test_persistent_aposmm_dfols.py.

    exit_criteria = {
        "sim_max": 1000,
        "wallclock_max": 100,
        "stop_val": ("f", 3000),
    }