ros2bag

Open and parse ros2bag log file

Description

The ros2bag object contains all the messages from the ROS 2 bag log file.

Creation

Syntax

bag = ros2bag(folderpath)

Description

bag = ros2bag(folderpath) creates a ros2bag object, bag, that contains all the messages from the ROS 2 bag log file located at path folderPath. The folderpath input sets the value of the FilePath property.

ROS 2 bag files are used for storing ROS 2 message data. They are used primarily to log messages transmitted over a ROS 2 network. You can use these bag files for offline analysis, visualization, and storage.

Note

If the ROS 2 bag log file contains custom messages, create custom messages for MATLAB using ros2genmsg function before creating the ros2bag object.

Properties

FilePath — Path to ROS 2 bag files

character vector

This property is read-only.

Path to the ROS 2 bag files, specified as a character vector.

Data Types: char

StartTime — Timestamp of first message

scalar

This property is read-only.

Timestamp of the first message, specified as a scalar in seconds.

Data Types: uint64

EndTime — Timestamp of last message

scalar

This property is read-only.

Timestamp of the last message, specified as a scalar in seconds.

Data Types: uint64

NumMessages — Number of messages

scalar

This property is read-only.

Number of messages, specified as a scalar.

Data Types: double

AvailableTopics — Table of available topics

table

This property is read-only.

Table of available topics, specified as a table. Each row in the table lists one topic, the number of messages for this topic, the message type, and the message definition.

Data Types: table

MessageList — List of messages

table

This property is read-only.

List of messages, specified as a table. Each row in the table lists one message.

Data Types: table

Object Functions

readMessages	Read messages from ros2bag object
select	Select subset of messages in ros2bag

Examples

Read Messages from ROS 2 Bag Log File

Extract the zip file that contains the ROS 2 bag log file and specify the full path to the log folder.

unzip('ros2_netwrk_bag.zip');
folderPath = fullfile(pwd,'ros2_netwrk_bag');

Create a ros2bag object that contains all messages in the log file.

bag = ros2bag(folderPath);

Get information on the contents of the ros2bag object.

bag2info = ros2("bag","info",folderPath)

bag2info = struct with fields:
         Path: '/tmp/Bdoc22a_1891349_146723/tp4bb54338/ros-ex96596996/ros2_netwrk_bag/ros2_netwrk_bag.db3'
      Version: '1'
    StorageId: 'sqlite3'
     Duration: 207.9020
        Start: [1x1 struct]
          End: [1x1 struct]
         Size: 16839538
     Messages: 166867
        Types: [4x1 struct]
       Topics: [4x1 struct]

Get all the messages in the ros2bag object.

msgs = readMessages(bag);

Select a subset of the messages, filtered by topic.

bagSel = select(bag,"Topic","/odom");

Get the messages in the selection.

msgsFiltered = readMessages(bagSel);

Version History

Introduced in R2021a

R2022a: folderpath Input

Behavior changed in R2022a

• The ros2bag object in Foxy can accept file name of the ROS 2 bag log file (.db3) as the folderpath input, when there is no metadata.yaml file.

• If there is metadata.yaml file along with the .db3 file in a folder, it accepts the folder name as the folderpath input.

R2022a: ROS 2 Bag Log File Version

Behavior changed in R2022a

The ros2bag object in Foxy can accept different versions of bag file from version 1 to 4.

R2022a: Empty Messages

Behavior changed in R2022a

The ros2bag object in Foxy discards empty messages recorded on a topic. Whereas in Dashing the ros2bag object accepts /rosout and /param_events topics.