Visualize Messages from Live ROS or ROS 2 Topics

Connect to Source ROS or ROS 2 Network

To connect the ROS Data Analyzer app to a live ROS or ROS 2 network, use the Open > Live Network Data option from the app toolstrip.

Open live network in ROS Data Analyzer

To visualize topics in a live ROS network, provide the ROS Master URI in the Enter Network Details dialog box after clicking Live ROS network data. The default ROS Master URI is set to http://localhost:11311. You can also choose from the latest 10 ROS Master URI entries stored in the dropdown.

ROS Master URI in ROS Data Analyzer

To visualize topics in a live ROS 2 network, provide the ROS Domain ID. The default ROS Domain ID is set to 0. You can also choose from the latest 10 ROS Domain ID entries stored in the dropdown, similar to ROS Master URI.

ROS 2 Domain ID for ROS Data Analyzer

The toolstrip also contains the list of supported visualizers under the Visualize tab, and allows you to choose the layout between Default and Grid.

View Live Network Details

The details of live network are found on the left side under the app toolstrip.

Upon accessing a live network for visualization, the toolstrip automatically configures itself, displaying the Start icon.
The Topic List shows the available topics in the ROS or ROS 2 live network. Click Refresh to update the Topic List with latest topics added to the opened live network.
The Source Details lists the ROS Master URI if you have opened a live ROS network. In case of a live ROS 2 network, it shows the ROS Domain ID.

app interface at opening of live network

Create Visualizers for Topics

You can configure the grid layout from the Layout tab and choose one or multiple viewers to visualize the messages in a topic. Choose the data source that you want to visualize from the dropdown of the selected viewer and click Start icon from the toolstrip to commence the visualization of the live network topic. Upon initiating the visualization, the Start icon transitions to a Stop icon which enables you to halt the visualization at any specific instant.

Types of Viewer

Viewer	Viewer Icon	Interface	Description
Image Viewer			Load a bag file containing `sensor_msgs/Image` or `sensor_msgs/CompressedImage` message type. Select Image Viewer from the toolstrip and choose the data source from the drop down to visualize the image. Use the top-right corner options to zoom in and out, and pan the image in all directions.
Point Cloud Viewer			Load a bag file containing `sensor_msgs/PointCloud2` message type. Select Point Cloud Viewer from the toolstrip and choose the data source from the drop down to visualize the point cloud message. Use the top-right corner options to zoom in and out, pan, and rotate the message in 3D.
Laser Scan Viewer			Load a bag file containing `sensor_msgs/LaserScan` message type. Select Laser Scan Viewer from the toolstrip and choose the data source from the drop down to visualize the laser scan message. Use the options on the top to zoom in and out, pan, and rotate the message 3D.
Odometry Viewer			Load a bag file containing `nav_msgs/Odometry` message type. Select Odometry Viewer from the toolstrip and choose the data source from the drop down to visualize the odometry message. See the indicator to view the instantaneous location of the robot in the trajectory. Use the top-right corner options to zoom in and out, and pan in all directions.
XY Plot Viewer			Load a bag file containing `geometry_msgs/Point` or `nav_msgs/Odometry` message type. Select XY Plot Viewer from the toolstrip and choose the data source from the drop down to visualize how the numeric message field changes across the XY axes. See the indicator to view the instantaneous location of the robot across the XY axes. Use the top-right corner options to zoom in and out, and pan in all directions.
Time Plot Viewer			Load a bag file containing `geometry_msgs/Point` or `nav_msgs/Odometry` message type. Select Time Plot Viewer from the toolstrip and choose the data source from the drop down to visualize how the numeric message field changes with respect to time. See the indicator to view the instantaneous location of the robot. Use the top-right corner options to zoom in and out, and pan in all directions.
Message Viewer			Load a bag file containing any message type. Select Message Viewer from the toolstrip and choose the data source from the drop down to visualize the raw message stored in the rosbag.
Map Viewer			Load a bag file containing `sensor_msgs/NavSatFix` or `gps_common/GPSFix` message types. Select Map Viewer from the toolstrip and choose the data source from the drop down to visualize the GPS message. See the indicator to view the instantaneous location of the GPS coordinate in the trajectory. Use the top-right corner options to zoom in and out, and pan in all directions.
Marker Viewer			Load a bag file containing `visualization_msgs/Marker` or `visualization_msgs/MarkerArray` message types. Select Marker Viewer from the toolstrip and choose the data source from the drop down to visualize the marker message. Also, specify the frame ID which you want to be the global frame for marker visualization. Use the top-right corner options to zoom in and out, pan, and rotate the message in 3D. From the Tools section on the app toolstrip, you can: Toggle the marker visualizer view between 2-D and 3-D axes. Select two marker points and measure distance between them. Use the data tips option in the top-right corner to select the two points of interest.

Example

Visualize Messages from Topic in Live ROS 2 Network

Open Live Script

This example shows how to create a ROS 2 node, publish messages to a topic in that node and visualize those messages live in the ROS Data Analyzer app.

Create a ROS 2 node in the network specified by the default Domain ID 0.

node = ros2node("myNode")

node = 
  ros2node with properties:

    Name: '/myNode'
      ID: 0

Create a ROS 2 publisher object to publish messages on a topic of the mesage type std_msgs/Int32. Add the topic to the network topic list.

pub = ros2publisher(node,"myTopic","std_msgs/Int32")

pub = 
  ros2publisher with properties:

        TopicName: '/myTopic'
      MessageType: 'std_msgs/Int32'
          History: 'keeplast'
            Depth: 10
      Reliability: 'reliable'
       Durability: 'volatile'
         Deadline: Inf
         Lifespan: Inf
       Liveliness: 'automatic'
    LeaseDuration: Inf

You can now see the list of topic names in the publisher pub registered in the ROS 2 network.

ros2 topic list

/myTopic
/parameter_events
/rosout

Create an empty message determined by the topics published by the ROS 2 publisher pub.

msg = ros2message(pub)

msg = struct with fields:
    MessageType: 'std_msgs/Int32'
           data: 0

Create for loop to change the message being published to pub every second with an increment of 1.

for ctr=1:1000
    msg.data=int32(ctr);
    pub.send(msg)
    pause(1)
end

Open ROS Data Analyzer using this command in the Command Window. You can also open the app from the Apps tab in MATLAB® toolstrip.

rosDataAnalyzer

Open the live ROS 2 Network from the app toolstrip and you can verify the topics present in this live network under Topic List.

Select the Message Viewer from the Visualize tab and select the data source /myTopic from the dropdown of the viewer. Click the Start icon from the Visualization tab in the toolstrip to visualize the messages in this live network. You can stop the visualization at any specific time by clicking the Stop icon.

Next Steps

Load and Play ROS or ROS 2 Bag File