> For the complete documentation index, see [llms.txt](https://www.opal-rt.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.opal-rt.com/docs/rt-lab/simulation-control-monitoring-and-logging/interact-using-dashboards/interact-with-data-points-via-panels.md).

# Interact with Data Points via Panels

Panels are managed under **Boards** in the navigation pane on the left of the Dashboards interface. A panel corresponds to a custom control panel that displays an interactive widget diagram.

## Set up a panel for acquisition and interaction

{% stepper %}
{% step %}

### Add a panel

Under the **Boards** section, click **+**, select **Panel**, enter a name and optional description, then click **Create**. The new panel opens directly in **Edit** mode so you can start configuring it immediately.
{% endstep %}

{% step %}

### Add widgets to the panel

Access the [**widget library**](https://www.opal-rt.com/docs/rt-lab/simulation-control-monitoring-and-logging/interact-using-dashboards/interact-with-data-points-via-panels/widget-library-and-parameters.md) using the large **+** button at the lower-left of the editing workspace and drag and drop the widgets you need into the **Diagram**. Rearranging and resizing widgets is done directly within the **Diagram**. Widgets fall into three categories:

* **Commands** – interactive controls (knobs, sliders, buttons).
* **Displays** – numeric and textual outputs.
* **Graphics** – plots and advanced visual components.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-1e438bcdc86dbedde2823d7b55c2d16defa60370%2FDH-panels.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Connect data points to widgets

1. **Left-click a widget** to select a widget. A **link** icon appears next to the widget.

   <figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-39bb21cdce0d5a4e9d06901672cf8dc5597fc958%2Fimage%20(228).png?alt=media" alt=""><figcaption></figcaption></figure>
2. **Click the link icon** to open the connection window. In the pop-up window, the list of available model connections, referred to **data points**, automatically adapts to the selected widget. **Parameters** and **control signals** are shown for **Command widgets**, while **output signals** appear for **Graphic and Display widgets**.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-6a6ba84bb1188a30879c468340547598a12b38c4%2Fimage%20(229).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="danger" %}
If you use **multiple subsystems** in the model, note that each widget can only be linked to a single subsystem. To connect data points from different subsystems, you **must use separate widgets**.
{% endhint %}

3. **Double-click the desired data point** to finalize the connection. **For vector data points**, each vector includes a data-point picker button and an expand/collapse control. Expanding the vector displays picker buttons for each individual element, allowing selective connections. Alternatively, double-clicking the entire vector connects all its data points at once.
4. **Repeat** for all widgets until your layout is fully wired.
   {% endstep %}

{% step %}

### Manage connections: delete, deactivate, or reactivate

1. **Left-click a widget** to select a widget and **click the link icon** to open the connection window.
2. To **delete a connection**, hover over the connection until the **trash icon** appears, then click it.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-3d854c6b79cefa05d1aeaf5148c73cf661b20d9c%2FDH-delete-connection.gif?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. To **deactivate or reactivate a connection**, simply uncheck or check the box to the left of the connection.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-de3c16d35170db7f146cdea552ae21c00bacd1b0%2FDH-connections.png?alt=media" alt=""><figcaption></figcaption></figure>

4. To view all existing connections, click **Connections** in the navigation menu. This opens a complete list of connections for easy review and management.

<figure><img src="https://96827845-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRdpSk8kjn20gXAexnt6%2Fuploads%2Fgit-blob-83f039d7ac0467139c09ce2b1f3cf00e1b3c7efc%2FDH-connections2.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Edit widgets parameters

* **Double-click a widget** to view and modify its [parameters](https://www.opal-rt.com/docs/rt-lab/simulation-control-monitoring-and-logging/interact-using-dashboards/interact-with-data-points-via-panels/widget-library-and-parameters.md) in the sidebar. Data points can also be connected from here if needed.
* **Right-click a widget** to open its context menu, where you can perform additional actions such as **Snap to Grid**, **Lock**, **Copy**, **Cut**, **Delete**, **Bring to Front**, **Send to Back**, **Rotate**, **Comment Out**, and **Comment Through**.
* **Undo/Redo:** Revert multiple actions using **Ctrl + Z**, and reapply them with **Shift + Ctrl + Z**. Each panel maintains its own independent undo/redo history. When an action is undone, the view automatically pans to and highlights the affected widget.

{% hint style="danger" %}
Stopping or starting a simulation clears the undo/redo history for all panels due to current system limitations.
{% endhint %}
{% endstep %}

{% step %}

### Toggle from Edit mode to Operate mode

Switch between modes using the **Edit/Operate toggle** in the toolbar.

* In **Edit mode**, you can add, connect, move, modify, or delete widgets.
* In **Operate mode**, editing is disabled and you can interact with widget values. The sidebar is hidden since widgets are not editable.

The selected mode applies to all panels in the same window. For example, switching one panel to **Operate** sets all panels in that window to Operate mode. To use a different mode, right-click the panel in the navigation menu to open its context menu, then select **Pop Out**. A popped-out panel operates independently, so its mode can differ from the main window without affecting other panels.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.opal-rt.com/docs/rt-lab/simulation-control-monitoring-and-logging/interact-using-dashboards/interact-with-data-points-via-panels.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
