Skip to main content

Running a Simulation

Simulations are a powerful tool for understanding complex systems, supporting decision-making, and exploring alternative outcomes. By stepping through modeled processes, you can reveal cause-and-effect relationships, timelines, and key parameters. Running simulations allows you to explore different scenarios, analyze uncertainties, and test hypotheses.

Simulation Results

In the simulation window, you’ll see all primitives you’ve defined as output parameters.

Results can be visualized in two main ways:

Time Series

  • Displays how data changes over time in a line chart
  • Hover to see specific values
  • Toggle series on or off by clicking the legend

Scatter Plot

  • Shows agent behaviors and state changes on a grid
  • Hover to see specific values
  • Toggle series on or off by clicking the legend
warning

A simulation can only run if at least one output parameter is defined and there are no logic or syntax errors in the model.

Validation

Even if your model runs without errors, you should still critically assess whether its behavior is realistic and represents the real-world system appropriately.

Check

By default, stock values can mathematically drop below zero. For certain variables—like a population count—this wouldn’t make sense.

  • Compare your results with real measurements or statistical data to check whether proportions and magnitudes seem reasonable
  • Consult subject matter experts to verify that the model and its outputs are plausible and technically sound
  • Use historical data to see if your model can reproduce known developments
  • Perform a sensitivity analysis to see how small parameter changes impact model behavior
Challenges

Model validation is not always straightforward. You may lack reliable real-world data, your model might be intentionally abstract and difficult to compare, or you may be modeling social behavior—which can be especially tricky to define.