Skip to content

Run Multi-execution experiments🔗

Modelon Impact offers the possibility to create and run multi-experiments for a given model. This lets the user investigate the parameter space of the model and gain an understanding of its behavior relative to certain parameters.

  1. Go to Experiment mode.

  2. Press the + New experiment link to add a new experiment. Give it a suitable name using the context menu of the experiment list item.

  3. Experiments are saved automatically when edited. In order to rename an experiment, click on the Edit icon that appears when hovering over the experiment name or select "Rename" by right-clicking on the experiment.

  4. Select a component on the canvas by clicking on it.

  5. There are two operators to help set up multi-execution exeperiment:

    • range(start_value,end_value,no_of_steps)
    • choices(value_1,value_2,value_n)

  6. The range and choices operator can only be set in experiment mode. Applying it in another mode, will result in an error message.

    • range

    Set a range of values for a parameter range(start_value,end_value,no_of_steps). Notice how it appears in the Modifications tab in the Experiment widget.

    In the case below, the J parameter will be swept from 1 to 5 in 10 steps.

    • choices

    choices defines an arbitrary sequence to sweep, that is enables different values for a parameter regardless of relationship to each other.

    With choices the user can run multiple experiments setting free and arbitrary set of values. Choices is applied to parameters on component level and, when possible, on model level.

    Select a component and set values to be simulated for a parameter choices(value_1,value_2,value_n).

    By using choices on another parameter, Modelon Impact will combine the number of values and produce the equivalent number of simulations.

Note

Range can be set for as many parameters as you like. Note, however, that all combinations of settings are simulated so the number of simulations increases rapidly with the number of range parameters.

  • Parameter_1: choices(a1,a2,a3)
  • Parameter_2: choices(b1,b2)

  • Simulations: a1b1, a1b2,a2b1, a2b2, a3b1, a3b2.

    values_a x values_b = 3 x 2 = 6 simulations.

  1. Use the Simulate button to run the multi-execution.

  2. The results can be viewed in plots and stickies just like a single simulation. Plots will show the curves from all simulation cases for each variable.

Multiexecution plot

  1. Running an experiment shifts the canvas mode from Experiment mode to Result mode as soon as the execution is completed. It is not possible to access the Experiment widget from Result mode. To run other defined experiments, go back to Experiment mode.

  2. A case slider is activated next to the time slider to select which case is shown on stickies. Together with the time slider, values for a specific time can be viewed for a selected case.

Warning

A syntax error will generate an error message and the experiment will not run. Note that a red exclamation mark next to result means that one or more cases failed. Right click on the case to show simulation log.

Set Up Simulation | Dynamic Simulation | Steady State | Cancelled | Simulation Setting | MultiExecution