cras_bag_tools

Czech-army knife for working with ROS BAG files.

Python Modules

Several useful functions are exported as Python submodules as module cras_bag_tools:

• fix_msg_defs: Fix message definitions in a bag file according to local definitions.
• topic_set: Efficient data structure to hold a static set of topics with super-fast is-in-set queries.
• tqdm_bag: Bag file reader that shows progressbars when loading index or reading messages.

Scripts

merge_bag

Merge two or more bag files into one.

Usage

rosrun cras_bag_tools merge_bag [-v] [-c] [-b] OUT_BAG IN_BAG [IN_BAG ...]

• OUT_BAG: Output bag file.
• IN_BAG: Input bag file(s).
• -v, --verbose: Verbose output.
• -c, --compress: Compress output bag with LZ4 compression.
• -b, --bz2: Compress output bag with BZ2 compression.

size_per_topic

Print total cumulative serialized message size per topic.

Usage

rosrun cras_bag_tools size_per_topic [-c] [-a] BAG

• BAG: Bag file.
• -c, --csv: Output as CSV.
• -a, --sort-alphabetical: Sort by topic names (default is by topic sizes).

fix_msg_defs

Sometimes it can happen that wrong textual definitions of messages are stored in bag files (although the MD5 sums are correct). Such bag files can have problems when they are processed using scripts like rosbag etc. This script fixes the definitions using the definitions from the local catkin workspace.

The fix is done inplace, so it changes the original bag file.

Usage

rosrun cras_bag_tools fix_msg_defs BAGFILE [TOPIC [TOPIC ...]]

• BAGFILE: The bag file to fix.
• TOPIC: Any number of topic names to fix. If not set, all topics are fixed. The topics are sensitive to the starting slash (not) being present.

Note If there is a mismatch between the stored and local MD5 sum of the message definition, it will not be fixed and a warning will be printed.

Note If a definition cannot be found locally for some message type, a warning will be printed and this definition will not be fixed.

Changelog for package cras_bag_tools

2.3.9 (2024-02-27)

• Removed catkin_lint buildfarm hacks.
• Contributors: Martin Pecka

2.3.8 (2024-01-12)

2.3.7 (2024-01-09)

2.3.6 (2024-01-09)

2.3.5 (2023-11-21)

2.3.4 (2023-10-25)

2.3.3 (2023-10-06)

2.3.2 (2023-10-06)

2.3.1 (2023-07-13)

2.3.0 (2023-07-12)

• Increased minimum CMake version to 3.10.2.
• Contributors: Martin Pecka

2.2.3 (2023-06-16)

2.2.2 (2023-05-15)

2.2.1 (2023-05-15)

2.2.0 (2023-04-09)

• Updated build files
• Contributors: Martin Pecka

2.1.2 (2023-02-10)

2.1.1 (2023-02-08)

2.1.0 (2023-02-08)

• Move merge_bag higher in readme.
• Added size_per_topic.
• Improved structure, added merge_bag.
• Contributors: Martin Pecka

2.0.10 (2022-11-24)

2.0.9 (2022-11-24)

2.0.8 (2022-11-24)

2.0.7 (2022-11-24)

2.0.6 (2022-11-24)

2.0.5 (2022-10-23)

2.0.4 (2022-10-14)

2.0.3 (2022-10-07)

2.0.2 (2022-08-29)

2.0.1

1.0.0

• Quit if bag does not exist.
• Be less verbose.
• Added cras_bag_tools.
• Contributors: Martin Pecka