rosbag2_storage_rrd
將 ROS 2 bag 直接錄製為 Rerun 的 .rrd 格式
授權條款
Apache 2.0, MIT
雙重授權:儲存庫同時附有 LICENSE-APACHE 與 LICENSE-MIT,使用者可擇一採用。已於 2026-09-10 核對。
概述
rosbag2_storage_rrd 是一個儲存外掛,讓 ros2 bag record -s rrd 寫出 Rerun .rrd 檔案,而非一般的 SQLite 或 MCAP。產生的 bag 可以直接在 Rerun 檢視器中開啟,也仍能透過 ros2 bag play 重播到 ROS 節點圖,因此檢視不再需要額外的轉換步驟。它也能在錄製進行時串流到運作中的檢視器,並將訊息定義、QoS 與型別雜湊值儲存在檔案中,讓 bag 能自我描述。一層精簡的 C++ pluginlib 介接層位於 Rust 核心之上,以 staticlib 形式連結,因此整個外掛就是一個共享函式庫,沒有額外的執行期產物。
有趣的設計選擇在於,你可以決定檔案要針對什麼最佳化。有三種表示法可用,且可以組合:原始位元組以求錄製速度、Rerun archetype 以求最快的查詢與視覺化,以及反射式 Arrow 欄位作為無損的折衷方案。ros2 bag convert 可在事後新增或移除表示法,因此快速錄製的檔案之後可以再補充內容,而不必重新錄製。設定 recording id 後,bag 會成為 Rerun segment 的其中一層,這意味著之後可以加入額外的層,而不必動到原始檔案。
在寫入路徑上,每個主題會緩衝訊息,並透過 Rerun SDK 的 RecordingStream 以欄式 Arrow 區塊寫出;若設定了 server_uri,第二條串流會將相同的區塊傳送到即時檢視器,而停止回應的檢視器只會產生警告,絕不會造成 bag 錯誤。在讀取路徑上,檔案尾端的索引負責規劃播放與跳轉。解碼與視覺化來自 Rerun 的 ROS 2 訊息反射與 lens,與 Rerun 的 MCAP 支援背後是同一套程式碼,因此外掛本身只負責緩衝、寫出以及 rosbag2 的介面約定。它以 colcon 建置為 ament 套件;由 CMake 驅動 cargo,而除了 package.xml 原本要求的項目之外,唯一的相依項目就是 Rust 工具鏈。
為何重要
要查看機器人實際錄下了什麼,向來都得先把資料匯出到別處。讓 bag 本身成為視覺化格式就省去了這一步,而以 rosbag2 儲存外掛而非獨立工具的形式實現,意味著既有工作流程中的任何部分都不需要改變——同樣的 ros2 bag record、info、play 與 convert 指令都照常運作。錄製時串流到即時檢視器,則是改變行為而不只是節省時間的部分:你可以看著一次執行出錯,而不是事後才發現。
解決的問題
ROS 2 bag 是很好的錄製格式,卻是很差的檢視格式,因此要查看它,就得將它轉換成檢視器看得懂的格式,並讓兩份副本保持同步。這個專案讓錄下的檔案本身就是檢視器原本就能讀取的格式,同時不必放棄重播到 ROS 節點圖的能力。
重點
- ros2 bag record -s rrd 就是全部的介面——外掛直接嵌入 rosbag2,因此 info、play 與 convert 一如往常地運作
- bag 可直接在 Rerun 檢視器中開啟,也仍能逐位元組地重播到 ROS 節點圖
- 三種可混合使用的表示法:原始位元組以求錄製速度、Rerun archetype 以求查詢與視覺化速度,反射式 Arrow 欄位則作為無損的折衷方案
- 設定 server_uri 後,相同的區塊會在錄製時串流到運作中的檢視器;停止回應的檢視器只會產生警告,絕不會造成 bag 錯誤
- 自我描述的檔案:訊息定義、QoS 與型別雜湊值都隨 bag 一起保存
- C++ pluginlib 介接層位於以 staticlib 形式連結的 Rust 核心之上,因此可作為單一共享函式庫部署,沒有額外的執行期產物
- 解碼沿用 Rerun 的 ROS 2 訊息反射與 lens,與 Rerun 的 MCAP 支援背後是同一條路徑,而非另一套實作
適用對象
- 花在檢視 bag 的時間比錄製還多的 ROS 2 開發者
- 已在使用 Rerun、希望機器人日誌能與其他資料在同一個檢視器中呈現的團隊
- 評估 bag 儲存格式的機器人資料與基礎架構工程師
- 在除錯間歇性行為時,寧可即時觀看執行過程、而非事後查看的任何人
限制
- 明確標示為實驗性:README 警告 .rrd 的佈局與設定鍵可能變更且沒有遷移途徑,並應預期各版本之間會有破壞性變更
- Rust 相依套件以 git 鎖定在尚未發布的 rerun-io/rerun main 分支某次提交上,因此在下一個 Rerun 版本發布之前,檢視器必須從同一個版本安裝
- 撰寫本文時僅推出十天,只有四次提交、沒有發布標籤,星數為 7——這只是搶先一覽,而非可以拿來當作標準的東西
- 僅支援 ROS 2 Lyrical,已在 macOS arm64 與 Linux x86_64/aarch64 上測試
- 不支援以 APPEND 模式重新開啟 bag,而含有 wstring 欄位的定義會以原始 CDR 形式保存
- 定義無法被解碼的主題(例如 ros2idl 型別)可以正確重播,但在檢視器中無法查看其內容