Main Content

ROS Bag Viewer

Visualize messages in ROS or ROS 2 bag file

Since R2023a

expand all in page

Description

The ROS Bag Viewer app enables you to visualize messages in a ROS or ROS 2 bag file. You can create multiple viewers within the app and visualize different ROS or ROS 2 messages simultaneously.

You can open the following viewers using the app, which support the given message types in the table.

Types of Viewer

ViewerViewer IconInterfaceDescription
Image ViewerImage Viewer Icon

Image viewer in ROS Bag Viewer App

  1. Load a ROS bag file containing sensor_msgs/Image or sensor_msgs/CompressedImage message type.

  2. Select Image Viewer from the toolstrip and choose the data source from the drop down to visualize the image.

  3. Use the top-right corner options to zoom in and out, and pan the image in all directions.

Point Cloud ViewerPoint cloud Viewer Icon

Point Cloud Viewer in ROS Bag Viewer App

  1. Load a ROS bag file containing sensor_msgs/PointCloud2 message type.

  2. Select Point Cloud Viewer from the toolstrip and choose the data source from the drop down to visualize the point cloud message.

  3. Use the top-right corner options to zoom in and out, pan, and rotate the message in 3D.

Laser Scan ViewerLaser Scan Viewer Icon

Laser Scan Viewer of the ROS Bag Viewer App

  1. Load a ROS bag file containing sensor_msgs/LaserScan message type.

  2. Select Laser Scan Viewer from the toolstrip and choose the data source from the drop down to visualize the laser scan message.

  3. Use the options on the top to zoom in and out, pan, and rotate the message 3D.

Odometry ViewerOdometry Viewer Icon

Odometry Viewer of the ROS Bag Viewer App

  1. Load a ROS bag file containing nav_msgs/Odometry message type.

  2. Select Odometry Viewer from the toolstrip and choose the data source from the drop down to visualize the odometry message.

  3. See the indicator to view the instantaneous location of the robot in the trajectory.

  4. Use the top-right corner options to zoom in and out, and pan in all directions.

XY Plot ViewerXY Plot Viewer Icon

XY Plot Viewer of ROS BAG Viewer App

  1. Load a ROS bag file containing geometry_msgs/Point or nav_msgs/Odometry message type.

  2. 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.

  3. See the indicator to view the instantaneous location of the robot across the XY axes.

  4. Use the top-right corner options to zoom in and out, and pan in all directions.

Time Plot ViewerTime Plot Icon

  1. Load a ROS bag file containing geometry_msgs/Point or nav_msgs/Odometry message type.

  2. 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.

  3. See the indicator to view the instantaneous location of the robot.

  4. Use the top-right corner options to zoom in and out, and pan in all directions.

Message ViewerMessage viewer Icon

Message Viewer of the ROS Bag Viewer App

  1. Load a ROS bag file containing any message type.

  2. Select Message Viewer from the toolstrip and choose the data source from the drop down to visualize the raw message stored in the rosbag.

For each viewer, you can filter the supported messages in the bag file for visualization. You can fast forward, and rewind based on the message timestamp or elapsed time while playing the bag file. You can also pause, and play the bag frame-by-frame. The app also displays information about the bag file contents after loading the bag file. You can also save a snapshot of the visualization window at any particular instance of time.

ROS Bag Viewer app interface

Open the ROS Bag Viewer App

  • MATLAB® Toolstrip: On the Apps tab, under Robotics and Autonomous Systems, click the app icon ROS Bag Viewer app icon.

  • MATLAB command prompt: Enter rosbagViewer.

Examples

Programmatic Use

expand all

rosbagViewer opens the ROS Bag Viewer app, which enables you to visualize messages in a ROS or ROS 2 bag file.

Version History

Introduced in R2023a

expand all

See Also

| | | |