Forecast

Forecast projects selected variables forward in time, returning a trajectory for each with a confidence band that widens further into the future. It is the temporal counterpart of Prediction: where Prediction answers "what outcome is most likely for this input?", Forecast answers "how will these variables evolve over the next n steps?"

Forecast is available on temporal Digital Twins — those built on time-series data. The system auto-detects a time column and sets the twin's type to Temporal when you create it; no separate setup is needed. For the workflow that produces a twin in the first place, see Step 5: Build Digital Twin.

---

Starting a simulation

Open a temporal Digital Twin, open the Simulate tab, then click New Simulation. The type picker for a temporal twin differs from the static one: it offers a parallel family of time-aware simulations — Forecast, Temporal Intervention, Temporal Optimization, Temporal Best Action, Temporal Explanation, Time-Series Root Cause Analysis, Time-Series Anomaly Scan & Diagnosis, and Causal Health Monitor.

The temporal twin's simulation menu, with generated Quick Start suggestions above the type cards. Choose Forecast to project variables forward in time.

Choose Forecast to open the setup.

---

Step 1: Select forecast targets

The forecast targets are the time-series variables you want projected forward. Each selected target is forecast independently across the horizon. Pick as many as you need — every target appears as its own chart in the result.

---

Step 2: Forecast horizon

The horizon sets how many time steps ahead the simulation covers. The bar shows your training range against the forecast range, so you can see how far past the data you are projecting. A horizon of 60 days on a model trained over 364 days, for example, extends two months beyond the last observation.

Forecasting far beyond the training range is possible, but the confidence band widens the further out you go — the model is honest about growing uncertainty.

---

Step 3: Forecast from (optional)

By default the forecast begins at the last date in the training data. Set a start time here — relative to the last training date, or a custom date — to begin the projection earlier or later.

---

Step 4: Confidence level

The default of 0.95 means the model is 95% confident the actual value will fall within the shown band. Higher confidence widens the band; lower narrows it. Leave the default unless you have a specific reason to change it.

The start of the Forecast setup: pick the targets to project — each selected target becomes its own chart in the result.

---

Running the forecast

Select the twin versions to run on, review the configuration summary, and click Run Simulation. Validate checks the setup without running it.

The configuration summary confirms what is being forecast, over what horizon, at what confidence — the last check before running.

---

Reading the result

The result page opens with an AI summary of the forecast, a per-target summary of net change, and one chart per target.

A completed Forecast. Each target gets its own chart with the projected trajectory and its confidence band; the summary table reports the net change over the horizon.

Each chart plots the variable's history up to the forecast start, then the projected trajectory with its confidence band shaded around it. The band widens with the horizon, reflecting accumulating uncertainty. Per-chart controls surface the underlying reasoning:

• Changepoints — the points where the trajectory shifts direction or slope.

• Why — the causal drivers behind the projected movement.

• Bounds — toggle the confidence band on and off.

The Forecast Summary reports the net change for each target over the horizon, and the Forecast Results Table holds the underlying values for export. The whole run exports as PDF.

---

Other Simulation Types

Forecast is the temporal analogue of Prediction; a temporal twin's menu offers time-aware versions of the other types too — see Temporal Simulations. The static types are:

• Prediction — the most likely outcome for a specific input.

• Intervention — change a variable and observe propagation.

• Optimization — find the input combination that best meets a goal.

• Best Action — the minimum change needed to reach a target.

• Explanation — the drivers and impacts behind an outcome.

See Simulation Types for the full picture and Step 6: Run Simulations for the general overview.