Creating Twins and Scenarios

Set up your first twin, give it a timeline, then add one or more scenarios to compare alternatives.

A twin is a slice of your model brought to life over time. A scenario is a specific projection within a twin — its timeline, its assumptions, its data. You'll usually create the twin once and add several scenarios to compare alternatives.

Create a twin

1. In the Model Navigator, find the Twins section.
2. Click + (or right-click → Add Twin). A twin called New Twin appears and is selected.
3. In the Properties panel at the bottom, give it a meaningful name, such as "HR Operations" or "Widget-A Supply Chain", and optionally a description.

Twins created by the AI assistant may show a Scope (Node Types) (which node types the twin is about) and a Linked Node (the one element it represents, such as a specific company). Both are informational.

Create a scenario

1. Expand the twin and click + next to Scenarios (or right-click the twin → Add Scenario).
2. Name it, e.g. "Baseline 2026", "Aggressive Hiring" or "Shanghai Disruption".
3. In the Properties panel, under Time Configuration, set Start, End and dt (the step size, e.g. 1, 0.5, 0.25).

Start, end and dt decide how many timesteps the scenario has, and so how many columns the time series grid shows for every agent. Many models start at 1 rather than 0.

Dates instead of numbers: give the twin a Time unit and a First step date, and choose a Step for each scenario, such as 1 month. dt is then derived for you, and every timestep gets a calendar date. See Putting a Twin on a Calendar.

Many scenarios per twin

This is where what-if comparison shines. You typically build the twin once (the structure stays the same) and add several scenarios where the assumptions vary:

Each scenario keeps its own timeline, agents, and links — they don't interfere with each other. Start with one scenario; add more as the questions emerge.

Parameter sets

To vary assumptions rather than structure, use parameter sets: in the twin's properties, under Parameter Sets, click + New set. A set stores only what differs from the default and inherits everything else (see Entering Time Series Data).

Next steps

• Adding Agents to a Scenario — populate the scenario with live elements
• Entering Time Series Data — record values over time
• Putting a Twin on a Calendar — give your timesteps real dates