The package includes tools for experimentation on simulation models. In the current version experimentation on top of OSP models is implemented. The package introduces a json5-based file format for experiment specification. Based on this specification
- a system model link is stored
- active variables are defined and alias names can be given
- the simulation base case variable settings are defined
- a hierarchy of sub-cases can be defined with their dedicated variable settings
- the common results to be retrieved from simulation runs is defined
Other features are
- alias variables can address multiple components of the same type, ensuring efficient experimentation.
- alias variables can vectors, even in FMI2 models. It is possible to set/get slices of such vectors
- variable settings can be time-based, enabling the definition of scenarios
- variable retrievals (results) can be time-based (in general and per case), enabling efficient model verification
The package does not support systematic variable sweep with respect to sets of variables. Such sweeps should be performed with separate tools. The package might be compared with navigating through a huge house, where the cases represent the various rooms, while searching for object in a given room is left to separate tools.
The package is designed as support tool for Assurance of Simulation Models, see DNV-RP-0513.
The package is currently under development. More instructions and documentation will be added.