> For the complete documentation index, see [llms.txt](https://docs.rootcause.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rootcause.ai/more-details/digital-twin.md).

# Digital Twin

A Digital Twin is a causal model of your business or system. Unlike traditional predictive models that learn correlations, a Digital Twin understands cause and effect — enabling simulation, optimization, and counterfactual reasoning.

Building and using a Digital Twin covers Steps 4–6 of the [seven-step workflow](/start-here/workflow.md): Build Causal Graph, Build Digital Twin, and Run Simulations.

***

### Building

[**Creating a Digital Twin**](/user-guide/creating-digital-twin.md) — Select a Data View, configure model settings, and train the twin. This is where causal discovery runs.

[**Causal Graph**](/user-guide/causal-graph.md) — Read, interpret, and refine the discovered cause-and-effect graph with domain knowledge.

***

### Using

[**Simulations**](/user-guide/simulations.md) — Run what-if scenarios, optimize decisions, find root causes, and predict outcomes.

***

### Comparing

[**Model Comparison**](/more-details/digital-twin/model-comparison.md) — Put two Digital Twin versions side by side to understand exactly what changed in structure and parameters.

***

### The Digital Twin interface

Once created, you interact with a Digital Twin through five sections — panel twins add a sixth. The twin's **Home** shows the causal graph with a side panel of cards — Configuration, Versions, Simulations, Graph explorer, Model evaluation — and opening a card switches the view; the URL tracks the active section (`?tab=…`):

| Section                           | Purpose                                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Home                              | The causal graph, model status, and the cards linking to every other section                                |
| Config                            | The data, fields, and algorithms behind the current version (read-only; **Modify model** opens the builder) |
| Relationships                     | View and edit causal relationships                                                                          |
| Evaluation                        | Model quality metrics                                                                                       |
| Simulations                       | Run all simulation types                                                                                    |
| Environments *(panel twins only)* | Per-environment insights                                                                                    |

Selecting a node or edge on the causal graph opens a details panel with **Path Analysis** and **Model Probabilities** views — plus **Seasonal Trends** on temporal twins and **Environment Analysis** on panel twins. [Version History](/more-details/digital-twin/version-history.md) opens from the **Versions** card on Home, and two twins or versions can be compared side by side on the separate Compare page — see [Model Comparison](/more-details/digital-twin/model-comparison.md).

<figure><img src="/files/lWmrXR4b3B8sbRtL0AXH" alt="Digital Twin Home showing the causal graph and side-panel cards for Configuration, Versions, Simulations, Graph explorer, and Model evaluation"><figcaption><p>A trained Digital Twin's Home. The cards on the right report 19 variables and 31 relationships, version v1.0.0, and a 69.6% model fit — and open each section.</p></figcaption></figure>