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 は、カメラ画像、LiDAR スキャン、関節状態、座標変換、指令など、選んだ ROS トピックに配信されたメッセージを、そのタイムスタンプとメッセージ型とともに、bag と呼ばれるファイルに記録する。同じツールで bag を再生でき、記録時のレート、またはそれより速いか遅いレートで元のトピックにメッセージを再配信するので、ほかのノードはロボットが動いているかのようにそれを受け取る。bag はトピック、メッセージ数、長さを調べたり、選んだトピックや時間範囲に絞り込んだり、Python と C++ のクライアントライブラリを通じてコードから直接読み込んだりできる。

rosbag は ROS 1 で始まり、そこでは rosbag record と rosbag play が .bag 形式を書き込み、読み込んでいた。ROS 2 ではこれが rosbag2 に置き換えられ、ros2 bag コマンドで使う。rosbag2 は記録のロジックを差し替え可能なストレージバックエンドから切り離している。初期の ROS 2 リリースは bag を SQLite3 データベースに保存していたが、より新しいリリースは、タイムスタンプ付きのマルチモーダルなロボットデータ向けに設計されたオープンなコンテナ形式である MCAP を既定とする。ROS 1 と ROS 2 の bag はそのままでは互換性がないが、変換ツールはある。記録のオプションには、圧縮、サイズや長さによるファイル分割、パブリッシャーに合わせるためのサービス品質の設定がある。

bag は、デバッグ、オフラインでの開発、データセットの作成のために現場のデータを取得する通常の方法である。bag を再生すれば、エンジニアは知覚や推定のコードを同一の入力で再実行し、アルゴリズムの版を比較し、ロボットなしで故障を再現できる。いくつか注意すべき点がある。再生時にはクロックトピックを配信でき、その場合ノードはシミュレーション時間を使うべきである。動的な座標変換と静的な座標変換の両方を記録しなければならない。bag と同じトピックを配信するノードは再生中に動かしてはならない。高レートのセンサーストリームはディスクをすぐに埋める。大規模な学習のためには、bag はランダムアクセスとバッチ読み込み向けに作られた形式に変換されることが多い。bag のレイアウトは逐次的な記録と再生のために設計されているからである。

重要な理由

ROS ベースのロボットのほぼすべてが、デバッグと開発を記録データに頼っている。bag があれば、ロボットが何を感知し何をしたかを再現し、実際のセンサーデータで変更をオフラインでテストし、データセットを作れる。そのため bag の記録、再生、変換は ROS の基本的な作業である。

主な用途

  • 記録したセンサーデータの再生によるロボットの動作のデバッグ
  • 知覚、自己位置推定、SLAM のオフラインでの開発と調整
  • 固定した実世界データでのアルゴリズムの回帰テスト
  • ロボット学習のためのデモンストレーションとセンサーのデータセットの収集
  • 事故分析のための現場でのログ記録
  • ROS ネイティブな形式でのベンチマークデータセットの共有

実際の使われ方

屋外移動ロボットをテストしているチームが、現場での走行のたびに、LiDAR スキャン、カメラ画像、慣性計測装置(IMU)のデータ、ホイールオドメトリ、座標変換、ベースに送った指令を含む bag を記録し、数分ごとにファイルを分割して圧縮する。走行中にロボットの自己位置推定がドリフトすると、エンジニアはオフィスに戻ってからシミュレーション時間でその bag を再生し、元の自己位置推定の出力を除いたうえで、記録されたセンサートピックに対して修正した自己位置推定ノードを実行し、2 つの軌跡を可視化ツールで比較する。修正が複数の 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を有効にしてください。