Documentation Status

Cannot load information on name: rqt_bag, distro: electric, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.
rqt_common_plugins: rqt_action | rqt_bag | rqt_bag_plugins | rqt_console | rqt_dep | rqt_graph | rqt_image_view | rqt_launch | rqt_logger_level | rqt_msg | rqt_plot | rqt_publisher | rqt_py_common | rqt_py_console | rqt_reconfigure | rqt_service_caller | rqt_shell | rqt_srv | rqt_top | rqt_topic | rqt_web

Package Summary

Released Continuous integration Documented

rqt_bag provides a GUI plugin for displaying and replaying ROS bag files.

rqt_common_plugins: rqt_action | rqt_bag | rqt_bag_plugins | rqt_console | rqt_dep | rqt_graph | rqt_image_view | rqt_launch | rqt_logger_level | rqt_msg | rqt_plot | rqt_publisher | rqt_py_common | rqt_py_console | rqt_reconfigure | rqt_service_caller | rqt_shell | rqt_srv | rqt_top | rqt_topic | rqt_web

Package Summary

Released Continuous integration Documented

rqt_bag provides a GUI plugin for displaying and replaying ROS bag files.

Cannot load information on name: rqt_bag, distro: jade, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.

rqt_bag supersedes rxbag, which is deprecated since ROS groovy.

launch top window

Overview

rqt_bag is an application for recording and managing bag files. Primary features:

  • show bag message contents
  • display image messages (optionally as thumbnails on a timeline)
  • plot configurable time-series of message values
  • publish/record messages on selected topics to/from ROS
  • export messages in a time range to a new bag

rqt_bag can be extended via a plugin mechanism. Core plugins are contained in the rqt_bag_plugins package available in the rqt_common_plugins metapackage.

Migration from rxbag

Usage

To run

$ rqt_bag

The main window shows a timeline representing the stream of messages contained in the bag file, listed by topic.

To stop recording

You can stop recording by re-clicking the red circle button.

Description for GUI components

Timeline

The messages are shown at the timestamp stored in the bag file. This timestamp may differ from the message's Header timestamp (if any), e.g. rosbag record stores the time the message was received.

Right-clicking on the timeline opens a menu with options for opening detailed message views, choosing which topics to display thumbnails for, managing re-publishing of messages, and exporting a time range of messages to another bag.

Toolbar

At the top of the timeline window is a toolbar for controlling the playhead and zooming the display:

From left to right, the buttons on the toolbars allow you to:

  • record mode
  • load file
  • save currently selected region to a bag file
  • move playhead to start of timeline
  • rewind or slow playback
  • play/pause
  • fastforward or slow rewind
  • move playhead to end of timeline
  • zoom in
  • zoom out
  • reset zoom level to full bag
  • toggle thumbnail display

Status Bar

At the bottom of the window is a status bar:

From left to right, these indicators display:

  • progress for background tasks
  • timestamp of playhead
  • time in human readable form
  • elapsed time in seconds from start of timeline
  • current playback speed

Message Views

Message views display information about the message immediately preceding the position of the timeline playhead (the vertical red line.) The message datatype determines which message views are available.

For details on common message views such as images and plotting, see rqt_bag_plugins.

Every message view has a toolbar for stepping the playhead forward to the next message on the topic, back to the previous message, or to the first and last messages in the bag.

raw

Every topic has an option of displaying a raw view of the message. This displays the fields of the message in a tree view:

Also, the following keyboard shortcuts can be used:

Ctrl-A

Select all fields in message

Ctrl-C

Copy selected fields to clipboard

Plugin API

rqt_bag currently has a proof-of-concept plugin API, which is used in the rqt_bag_plugins package.

Wiki: rqt_bag (last edited 2014-03-11 16:57:02 by DorianScholz)