Simulation Diagrams

Beginner

Simulation Diagrams

A simulation diagram is a canvas tied to one scenario. It shows your agents, the links between them, and (optionally) charts and interactive controls — all updating live as you scrub through time.

Create or open a diagram

  1. In the Tree View, find your scenario and expand its Diagrams branch
  2. Use the + button to create a new diagram, or click an existing one

A scenario can have several diagrams. Use them like dashboards: one for the structural view, one for the financial KPI view, one for the supply chain map — whatever you need.

Place agents and links

  • Drag an agent from the Simulation Toolbox onto the canvas — each drop creates a new placement
  • Hover an agent on the canvas to see connection handles; drag to another agent to draw a link
  • Use the same selection, drag, and alignment shortcuts you already know from modeling diagrams

Links between two placed agents appear automatically once both ends are visible. Move agents around to create the layout that tells your story best.

Navigate through time

The time slider at the top of the canvas controls which timestep is displayed. As you drag the slider:

  • Agents that don't yet exist at that timestep are hidden
  • Property-driven styling (color, badge, border) updates to reflect the agent's state at that moment
  • Charts redraw with the data up to that point
  • Interactive sliders and checkboxes show their current setting

This is what a live twin really looks like — your knowledge graph evolving in front of you.

Hide what you don't need

A simulation diagram doesn't have to show everything. You can:

  • Remove an agent from this diagram without deleting it from the scenario (keeps the agent live, just not visible here)
  • Hide individual links to declutter
  • Place chart widgets that summarize many agents at once instead of showing each one individually

Treat diagrams as views — different audiences, different focus.

Next steps

  • Adding Charts, Sliders, and Checkboxes — go beyond the structural view
  • Writing Property Formulas — give your agents behavior worth visualizing
  • Reading Connected Agents in Rhai — coordinate behavior across links