Struct CUDAEnsemble::EnsembleConfig

Nested Relationships

This struct is a nested type of Class CUDAEnsemble.

Struct Documentation

struct EnsembleConfig

Execution config for running a CUDAEnsemble

Public Types

enum ErrorLevel


enumerator Off
enumerator Slow
enumerator Fast

Public Functions


Public Members

std::string out_directory = ""

Directory to store output data (primarily logs) Defaults to “” (the working directory, no subdirectory)

std::string out_format = "json"

Output format This must be a supported format e.g.: “json” or “xml” Defaults to “json”

unsigned int concurrent_runs = 4

The maximum number of concurrent runs Defaults to 4

std::set<int> devices

The CUDA device ids of devices to be used If this is left empty, all available devices will be used Defaults to empty set (all available devices)

flamegpu::Verbosity verbosity = Verbosity::Default

If true progress logging to stdout will be suppressed Defaults to false

bool silence_unknown_args = false

Suppresses warning for unknown arguments passed to the CUDAEnsemble during initialisation. Useful for when arguments are passed to user defined models but should not be considered by the FLAME GPU API.

bool timing = false

If true, the total runtime for the ensemble will be printed to stdout at completion This is independent of the EnsembleConfig::quiet Defaults to false

ErrorLevel error_level = Slow

Off: Runs which fail do not cause an exception to be raised. Failed runs must be probed manually via checking the return value of calls to CUDAEnsemble::simulate() Slow: If any runs fail, an EnsembleException will be raised after all runs have been attempted, before CUDAEnsemble::simulate() returns. Fast: An EnsembleException will be raised as soon as a failed run is detected, cancelling remaining runs. Defaults to Slow

bool truncate_log_files = false

If true, all log files created will truncate any existing files with the same name If false, an exception will be raised when a log file already exists

const bool block_standby = false

Prevents the computer from entering standby whilst the ensemble is running


This feature is currently only supported by Windows builds.

const bool mpi = false

Flag which denotes whether MPI support is enabled


This cannot be changed at runtime, depends on compilation settings.

bool telemetry = false