Open Source Robotics

精选高质量开源机器人项目、工具和软件,推动机器人社区发展。

rosbag

  • 又称: ROS bag, rosbag2, ros2 bag, bag file
  • 类别: Software & tooling › Tools & formats
  • 标签: ros, data-logging, datasets, debugging, robot-software

用于录制来自话题的带时间戳消息并在之后回放的 ROS 工具和文件格式;在 ROS 2 中由 rosbag2 通过 ros2 bag 命令提供。

定义

rosbag 把在选定 ROS 话题上发布的消息,例如相机图像、激光雷达扫描、关节状态、坐标变换和指令,连同它们的时间戳和消息类型一起,记录到一个称为 bag 的文件中。同一个工具也可以回放 bag,以记录时的速率或更快、更慢的速率,把消息重新发布到原来的话题上,使其他节点就像机器人正在运行一样接收到它们。可以查看 bag 包含的话题、消息数量和时长,按选定的话题或时间范围进行过滤,并通过 Python 和 C++ 客户端库在代码中直接读取。

rosbag 始于 ROS 1,在那里 rosbag record 和 rosbag play 写入和读取 .bag 格式。ROS 2 用 rosbag2 取代了它,通过 ros2 bag 命令使用,它把录制逻辑与可插拔的存储后端分离开来。早期的 ROS 2 版本把 bag 存储在 SQLite3 数据库中,较新的版本默认使用 MCAP,这是一种为带时间戳的多模态机器人数据设计的开放容器格式。ROS 1 和 ROS 2 的 bag 不能直接互换,尽管存在转换工具。录制选项包括压缩、按大小或时长拆分文件,以及与发布者相匹配的服务质量设置。

bag 是采集现场数据以用于调试、离线开发和数据集构建的常用方式。回放 bag 让工程师能够在完全相同的输入上重新运行感知或估计代码、比较不同版本的算法,并在没有机器人的情况下复现故障。有几点需要注意:回放时可以发布时钟话题,此时节点应使用仿真时间;动态和静态坐标变换都必须录制;会发布与 bag 相同话题的节点在回放期间不能运行;高频传感器数据流会很快占满磁盘。对于大规模学习,bag 通常会被转换为为随机访问和批量加载而设计的格式,因为 bag 的布局是为顺序录制和回放而设计的。

为何重要

几乎每个基于 ROS 的机器人都依赖录制的数据来进行调试和开发。bag 使人能够复现机器人感知到了什么、做了什么,用真实传感器数据离线测试改动,并构建数据集,因此录制、回放和转换 bag 是 ROS 的基本实践。

主要应用

  • 通过回放录制的传感器数据调试机器人行为
  • 感知、定位和 SLAM 的离线开发与调优
  • 在固定的真实世界数据上对算法做回归测试
  • 为机器人学习采集示范数据集和传感器数据集
  • 用于事故分析的现场日志记录
  • 以 ROS 原生形式共享基准数据集

实际应用

一个测试户外移动机器人的团队在每次现场运行时都录制一个 bag,其中包含激光雷达扫描、相机图像、惯性测量单元(IMU)数据、轮式里程计、坐标变换以及发送给底盘的指令,每隔几分钟拆分一次文件并进行压缩。当机器人的定位在一次运行中发生漂移时,一名工程师回到办公室后用仿真时间回放这个 bag,在录制的传感器话题上运行修改后的定位节点,同时不使用原来的定位输出,并在可视化工具中比较两条轨迹。修复在多个 bag 上都有效后,这些 bag 就成为持续集成中的回归测试。为了训练一个感知模型,团队把选定的话题转换为一种可按帧随机访问的数据集格式。

常见误解

  • rosbag 是 ROS 2 的工具 — 它起源于 ROS 1,ROS 2 提供了一个重新设计的版本 rosbag2,通过 ros2 bag 命令使用
  • 回放的 bag 表现得和实机一样 — 回放是开环的,因此修改过的节点无法影响录制的传感器数据或机器人录制下来的运动
  • 录制所有话题总是稳妥的选择 — 高频图像和点云会很快占满存储,并可能导致消息丢失,因此应有意识地选择话题、压缩和拆分方式
  • bag 文件是现成的训练数据格式 — 它们是为顺序录制和回放而设计的,大规模学习通常会把它们转换为支持高效随机访问的格式

谁需要了解

  • ROS 开发者和机器人软件工程师
  • 感知和 SLAM 工程师
  • 现场测试和验证工程师
  • 构建数据集的机器人学习工程师

相关技术

  • ROS 2
  • rosbag2
  • MCAP
  • SQLite
  • RViz
  • tf2

相关术语

  • ROS
  • SLAM
  • Sensor Fusion
  • Extrinsic Calibration
  • Digital Twin

相关项目

  • LeRobot: HuggingFace ML library for real-world robotics in PyTorch
  • Rerun: Time-aware visualizer and data store for multimodal robotics data
  • Cartographer: Google's real-time 2D and 3D SLAM system for multi-platform robotics
  • OpenMower: Open-source project converting commercial mowers into autonomous RTK-GPS guided robots
  • ROS 2: Next-gen Robot Operating System for real-time production robotics
  • PlotJuggler: Fast time-series visualization tool for ROS topics, rosbags, and robot debugging

视频

  • Rosbags | ROS Tutorial for Beginners: ROBOMECHTRIX
  • ROS2 Rosbag to Record Data And Playback Data: Kevin Wood | Robotics & AI

本网站需要 JavaScript 才能正常运行。请启用 JavaScript 以浏览我们的开源机器人项目。