3.1. Getting Started with Data Visualization¶
3.1.1. Preparation¶
Launch RTI Shapes Demo and publish a few squares with different colors.
3.1.2. Step 1: Switch to the Data Visualization Perspective¶
Click on the Switch to Data Visualization Perspective button
on the toolbar or select the Data Visualization
Perspective entry under the Visualization menu.
In the Data Visualization Perspective, some Administration related views are hidden; to see them, click on the corresponding view icon in the toolbar or the View menu. To switch back to the Administration perspective, click on the Administration perspective button on the top-right corner:
![Switch perspective](../_images/switch_perspective.png)
3.1.3. Step 2: Open the Topic Data Tab¶
From the DDS Logical View, click on the Square Topic to open the Topic View. In the Data Visualization perspective, it will automatically switch to the Topic Data tab, as seen below:
![Empty topic data tab](../_images/empty_topic_data_tab.png)
3.1.4. Step 3: Subscribe to a Topic¶
Click on the Subscribe… button or right-click
on the Topic in the DDS Logical View and select Subscribe. This
will open the Create Subscription Dialog
seen below. You may expand the Advanced Settings to set the QoS,
Content Filter, or DataWriter Filter for the subscription. Click OK
to subscribe to the Topic.
![Subscription dialog creation](../_images/create_subscription_dialog1.png)
3.1.5. Step 4: Use the Topic Data Tab and Sample Inspector¶
After the Topic has been subscribed to, the Instances Table will show the latest data of all the instances that have been discovered so far. Select a row in the table to see the full data structure of the instance’s live data in the Sample Inspector view.
![Topic data sample inspector](../_images/topic_data_sample_inspector.png)
You can add and remove columns to the Instances Table by clicking on
the Select Fields… button .
3.1.6. Step 5: Use the Sample Log¶
The Sample Log view logs every sample that has been received from selected Topics.
![Sample log image](../_images/samplelog_shot1.png)
3.1.6.1. Configure the Sample Log¶
Click on the Sample Log button on the toolbar or the
Sample Log entry in the Visualization menu. This will open a new Sample
Log view and its configuration dialog. In the configuration dialog, from the
Topics tab, you may select one or more Topics to log. In the Visible
Columns tab, you can select the columns that are visible in the table. You
can open the configuration dialog at any time by clicking on the Configure…
button
.
![Sample configure dialog](../_images/samplelog_configure_dialog1.png)
3.1.6.2. Add Topics to a Sample Log¶
To directly visualize a Topic in a new Sample Log, right-click on a Topic or instance and select Visualize > Sample Log. If there are existing Sample Logs that are not logging this Topic, you can also use “Drag and Drop” or the Add to Existing View context menu to add the Topic to one of the existing Sample Logs. You may also add a DataWriter, DataReader, instance or field to a Sample Log, which will add the related Topic to the Sample Log.
3.1.6.3. Inspect a Sample¶
Select a row in the Sample Log to see its full data structure and values in the
Sample Inspector. When the Sample Log becomes
full, the oldest samples will be deleted when new samples arrive. Toggle the
pause button to pause table updates. While paused, newly arriving
samples are still logged in the background. Toggle the pause button again to
resume updates.
3.1.7. Step 6: Use the Time Chart¶
A Time Chart is a type of view that plots numeric fields in chart. It also supports saving and loading historical data.
3.1.7.1. Configure the Time Chart¶
Click on the Time Chart button on the toolbar or the
Time Chart entry in the Visualization menu. This will open a new Time
Chart view and its configuration dialog. The Select Signals dialog allows
you to select the signals to be plotted. First, you need to select the Topic.
Then the instances table will show all the instances that have been discovered
so far. Then you can select the instances and fields to be plotted.
Only numeric fields can be chosen.
After the signals are selected, it will automatically create corresponding traces in the Time Chart Configuration dialog, as seen below. Each trace has some properties, such as Trace Color, Point Style, etc. You can select the trace from the Traces list and set its properties. You can add more Y axes to the chart from the Axes tab.
For the time axis, there are two modes:
Auto Scale: Automatically sets the time axis range to show all the samples in the plot buffer upon an update.
Fixed Time Window: Sets the time axis to a fixed time range.
![Time chart configuration](../_images/timechart_configure1.png)
You can open the configuration dialog at any time by clicking on the
Configure… button .
3.1.7.2. Add Signals to the Time Chart¶
To directly plot signals in a new Time Chart, right-click on one or multiple live numeric fields in the Sample Inspector and select Visualize > Time Chart. If there are existing Time Charts that are not plotting this field, use Drag and Drop or the Add to Existing View context menu to add the Topic to one of the existing Time Charts. You may also add Topics or instances to a time chart; in this case, the configuration dialogs will pop up and the Topics or instances will be preselected.
![Time chart from sample inspector](../_images/timechart_from_sampleinspector.png)
3.1.7.3. Use the Time Chart Toolbar¶
The Time Chart’s toolbar allows you to manipulate the chart at
runtime. When one of the zoom buttons is selected, the
chart will stop auto-scaling or auto-scrolling so you can perform zoom or
panning operations by clicking on the plot or axes. Use the mouse wheel
to zoom in/out on plot area or axes. You can click on the toggled zoom
button again or the arrow button
to exit zooming and
restart auto-scaling or auto-scrolling.
3.1.7.4. Plot Historical Data¶
Historical data can be easily loaded by moving the bottom scroll bar
or clicking on the Switch to History Mode button .
3.1.8. Step 7: Set Preferences¶
![Preferences dialog](../_images/preferences_dialog1.png)
Data Visualization can be customized to suit your needs through the Preferences dialog.