# Home Tab

The Home tab is your command center for a Digital Twin. It provides an at-a-glance overview of your model's status and quick access to the most common actions.

When you first open a Digital Twin, you land here. It's designed to answer the immediate questions: What version am I looking at? Is the model ready to use? What can I do next?

(SCREENSHOT: Home tab showing the Digital Twin overview with version selector and quick actions)

***

### Twin Overview

At the top of the Home tab, you'll see key information about your Digital Twin:

**Name and Type**

The twin's name appears prominently, along with a badge indicating whether it's a **Static Model** or **Time Series Model**. Static twins analyze cross-sectional data; temporal twins capture time-based dynamics.

**Tags**

Tags help organize twins across your workspace. Click **Edit** to add or modify tags—useful for categorizing by project, team, or analysis type.

**Created Date**

Shows when this Digital Twin was first created.

(SCREENSHOT: Twin header showing name, type badge, tags, and edit button)

***

### Active Version

Digital Twins support multiple versions, and this section shows which one you're currently viewing.

**Version Selector**

Click the version dropdown to switch between versions. Each version represents a different causal discovery run—perhaps with different data, different included fields, or different constraints.

**Version Details**

For the active version, you'll see:

| Metric        | Description                               |
| ------------- | ----------------------------------------- |
| Version       | The version number (e.g., v1.0.0)         |
| Variables     | Number of variables included in the model |
| Relationships | Number of causal relationships discovered |
| Status        | Current state of the model                |

**Status Values:**

* **Ready for analysis** – The model is fully trained and can run simulations
* **Directions unresolved** – Some relationships have ambiguous direction (CPDAG state) and need resolution
* **Model not trained** – The causal graph exists but the probabilistic model hasn't been fit yet
* **Graph not constructed** – Causal discovery hasn't been run yet

(SCREENSHOT: Version selector dropdown and version details panel)

**View All Versions**

Click "View All Versions" to see a visual diagram of your version history, showing how versions branch and relate to each other.

(SCREENSHOT: Version visualizer showing branching version history)

***

### Quick Actions

The quick actions panel provides one-click access to common tasks. Available actions depend on your model's current status.

**Always Available:**

| Action                     | Description                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Configure Digital Twin** | Go to the Config tab to modify settings, add constraints, or change included fields |
| **View Relationships**     | Open the Relationships tab to explore the causal graph                              |

**Available When Model Is Trained:**

| Action                    | Description                                 |
| ------------------------- | ------------------------------------------- |
| **Run Prediction**        | Predict outcomes for specific inputs        |
| **Optimize Variables**    | Find optimal settings to achieve objectives |
| **Test Interventions**    | Simulate what-if scenarios                  |
| **Generate Best Actions** | Find minimum changes to reach a target      |
| **Model Evaluation**      | View accuracy and performance metrics       |
| **View All Runs**         | See history of all simulation runs          |

(SCREENSHOT: Quick actions panel with enabled and disabled states)

***

### When Actions Are Disabled

If some actions are grayed out, the model needs attention:

**Edge Resolution Required**

If the causal graph contains bidirectional relationships (the algorithm couldn't determine direction), you'll see a prompt to resolve them. Click "Resolve Relationships" to go to the Relationships tab and manually specify directions.

**Model Training Required**

If the graph is complete but the model hasn't been trained, you'll need to train it before running simulations. This typically happens automatically after edge resolution.

(SCREENSHOT: Disabled actions overlay with resolution prompt)

***

### Editing Twin Details

Click **Edit** in the header to modify:

* **Name** – Rename the Digital Twin
* **Tags** – Add, remove, or modify tags

Changes are saved when you click **Save**. Click **Cancel** to discard changes.

(SCREENSHOT: Edit mode showing name input field and tag editor)

***

### Next Steps

From the Home tab, you'll typically:

* Review the version status to understand if the model is ready
* Use quick actions to jump directly to analysis
* Navigate to the [Config Tab](/more-details/digital-twin/tabs/config-tab.md) if you need to modify settings
* Go to [Relationships Tab](/more-details/digital-twin/tabs/relationships-tab.md) if edges need resolution


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rootcause.ai/more-details/digital-twin/tabs/home-tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
