Skip to content

Updating for libEnsemble v0.9.3

Stephen Hudson edited this page Oct 13, 2022 · 1 revision

Note: This is expected API and/or other usage changes for an upcoming release, and details could change.

Manager poll changes

The manager_poll executor function now outputs integer (enumerated) types instead of strings.

These types can be found in the message_numbers module, with the MAN_SIGNAL_ prefix.

Currently, these are MAN_SIGNAL_FINISH and MAN_SIGNAL_KILL. The user function can respond to these in any way but indicates a request by the manager to kill running applications, and in the case of MAN_SIGNAL_FINISH, to inform that the ensemble is shutting down.

Note that a new executor function that may be easier to use is added manager_kill_received(), which simply returns a boolean indicating whether a kill signal (either of the above) has been received from the manager.

Zero resource workers

num_resource_sets

Specifying the num_resource_sets libE_specs option instead of zero_resource_workers is now recommended except when using a fixed worker/resource mapping. Use persis_info["gen_resources"] to assign persistent generator resources (default is zero).

Also the command line option --nsim_workers (parsed by the parse_args module), now sets num_resource_sets to the number specified, and adds one worker by default for the gen.