Documentation Home Page OPAL-RT Dashboard Home Page
Pour la documentation en FRANÇAIS, utilisez l'outil de traduction de votre navigateur Chrome, Edge ou Safari. Voir un exemple.

5. Connecting Data Points

A connection describes the transfer of data between two data points.

A data point is a property of a model which can be probed and have its value set by or sent to another component of the simulation.

Page Content

Data Point Picker

The data point picker is the UI tool used to create connections.

Not all data points can be connected together. Data points are pre-filtered in the data point picker.

It is accessible everywhere in Dashboards.

ConnectionTable.png
Connection.png

Creating a Connection

To create a connection, click on the “+” icon in the sidebar, and mouse over the desired data point to connect to, where another “+” icon will appear. Click on it to create the connection.

The available connections are filtered based on their compatibility. See the Connections section above for more details.

Connecting Vector Data Points

Connecting vector data points and vector data point elements is done through the data point picker as well.

Vector data points can be differentiated from other data points by their picker button: which has both data point picker button (left) and the expand/collapse button (right).

If there is a connection, this will also be displayed here as well (displaying count if there are multiple connections)

Expanding it will give the data point picker buttons of each vector element.

By selecting the we open the data point picker for the vector data point. The available data points are only vector data points of matching size.

By hovering on a row, a "+" button will show up and can be selected to create a new connection. The vector can also be opened for viewing.

By selected the "+" of one of the children of a vector data point, the data point picker open for that specific vector element.

The data points available are other vector elements (which can be viewed and selected by opening the collapsed vector data point parents) or widget data points.

A count is visible by parent data points (in vectors and in tree tables) to help keep track of connections. These can always be viewed in the Connection view as well.

Active and Not Active

A data point can have many connections, but only the active connections change the data point’s value.

Also, note that one PARAMETER, INPUT or OUTPUT data point can have an active connection to more than one widget or input.

This means, for example, that a parameter can be connected to multiple widgets, but a widget can only have one active connection.

Deleting a Connection

Simply mouse over a connection to find the delete button.

Connection List

This list shows all active connections of a project and can be filtered and sorted.

Data Point Compatibility

Note that none of the following information is absolutely essential to know in order to use Dashboards and make connections between data points.

As mentioned previously, the data points list in the data point picker is pre-filtered, in order to offer the best user experience.

However, the following rules can be useful to understand why you’re only seeing certain data points when trying to make a connection.

A COMMAND can be connected to a PARAMETER data point.

In this type of connection, both ends receive updates and send updates to each other. Any number of COMMAND data points can be connected to a single PARAMETER data point. In this case, the latest available COMMAND value changes the PARAMETER value. COMMAND data points are found in command widgets (see the “Commands” section in the Libraries – Widgets Library).

A DISPLAY can be connected to an INPUT, or an OUTPUT data point.

In this type of connection, the DISPLAY data point receives updates from the data point it is connected to. Any number of DISPLAY data points can connect to a single PARAMETER data point. DISPLAY data points are found in display widgets (see the “Displays” section in the Libraries – Widgets Library).

From / Datapoint1

Direction of value update

To / Datapoint2

From / Datapoint1

Direction of value update

To / Datapoint2

PARAMETER



COMMAND WIDGET

("Data" row)

INPUT

OUTPUT

DISPLAY WIDGET

MULTI-DISPLAY WIDGET

("Data" row)

Precisely, to be compatible, data points must: 

  • Follow the rules of the compatibility table below (ex: OUTPUT DISPLAY);

  • Have a compatible data type (REAL, BOOLEAN);

  • Have the same size if they are not a scalar;

  • Not be in the same standard model or Simulink model;

  • Not be already present in the “To” column (one connection).

  • If connecting a vector element, it must be connected to either another vector element or a widget

OPAL-RT TECHNOLOGIES, Inc. | 1751, rue Richardson, bureau 1060 | Montréal, Québec Canada H3K 1G6 | opal-rt.com | +1 514-935-2323