Open Source Robotics

Una raccolta curata di progetti, strumenti e software di robotica open source di alta qualità per la comunità della robotica.

rosbag

  • Detto anche: ROS bag, rosbag2, ros2 bag, bag file
  • Categoria: Software & tooling › Tools & formats
  • Tag: ros, data-logging, datasets, debugging, robot-software

Lo strumento e il formato di file di ROS per registrare messaggi con timestamp dai topic e riprodurli in seguito; in ROS 2 è fornito da rosbag2 tramite il comando ros2 bag.

Definizione

rosbag registra i messaggi pubblicati su topic ROS selezionati, come immagini della telecamera, scansioni lidar, stati dei giunti, trasformazioni e comandi, in un file chiamato bag, insieme ai loro timestamp e tipi di messaggio. Lo stesso strumento riproduce un bag, ripubblicando i messaggi sui loro topic originali alla frequenza registrata oppure più velocemente o più lentamente, così che gli altri nodi li ricevano come se il robot fosse in funzione. I bag si possono ispezionare per vederne i topic, il numero di messaggi e la durata, filtrare per topic o intervalli di tempo selezionati e leggere direttamente da codice tramite le librerie client Python e C++.

rosbag è nato in ROS 1, dove rosbag record e rosbag play scrivevano e leggevano il formato .bag. ROS 2 lo ha sostituito con rosbag2, usato tramite il comando ros2 bag, che separa la logica di registrazione da back end di archiviazione intercambiabili. Le prime release di ROS 2 memorizzavano i bag in database SQLite3, e le release più recenti usano per impostazione predefinita MCAP, un formato contenitore aperto progettato per dati robotici multimodali con timestamp. I bag di ROS 1 e ROS 2 non sono direttamente interscambiabili, anche se esistono strumenti di conversione. Le opzioni di registrazione comprendono la compressione, la suddivisione dei file per dimensione o durata e le impostazioni di qualità del servizio per adeguarsi ai publisher.

I bag sono il modo abituale per acquisire dati sul campo per il debug, lo sviluppo offline e la creazione di dataset. Riprodurre un bag permette agli ingegneri di rieseguire codice di percezione o di stima su input identici, confrontare versioni di algoritmi e riprodurre guasti senza il robot. Alcuni punti richiedono attenzione: la riproduzione può pubblicare un topic di clock, e i nodi devono allora usare il tempo simulato; vanno registrate sia le trasformazioni dinamiche sia quelle statiche; i nodi che pubblicherebbero gli stessi topic del bag non devono girare durante la riproduzione; e i flussi di sensori ad alta frequenza riempiono rapidamente i dischi. Per l'apprendimento su larga scala, i bag vengono spesso convertiti in formati pensati per l'accesso casuale e il caricamento a batch, perché la struttura del bag è progettata per la registrazione e la riproduzione sequenziali.

Perché è importante

Quasi ogni robot basato su ROS dipende da dati registrati per il debug e lo sviluppo. I bag permettono di riprodurre ciò che il robot ha percepito e fatto, testare modifiche offline su dati reali dei sensori e costruire dataset, quindi registrarli, riprodurli e convertirli è pratica di base in ROS.

Applicazioni principali

  • Debug del comportamento del robot riproducendo dati dei sensori registrati
  • Sviluppo e taratura offline di percezione, localizzazione e SLAM
  • Test di regressione degli algoritmi su dati reali fissi
  • Raccolta di dataset di dimostrazioni e di sensori per il robot learning
  • Registrazione sul campo per l'analisi degli incidenti
  • Condivisione di dataset di benchmark in forma nativa ROS

In pratica

Un team che collauda un robot mobile per esterni registra un bag a ogni uscita sul campo con scansioni lidar, immagini della telecamera, dati IMU, odometria delle ruote, trasformazioni e i comandi inviati alla base, suddividendo i file ogni pochi minuti e comprimendoli. Quando la localizzazione del robot deriva durante un'uscita, un ingegnere tornato in ufficio riproduce il bag con il tempo simulato, esegue un nodo di localizzazione modificato sui topic dei sensori registrati escludendo l'uscita di localizzazione originale, e confronta le due traiettorie in un visualizzatore. Una volta che la correzione funziona su diversi bag, quei bag diventano test di regressione nell'integrazione continua. Per addestrare un modello di percezione, il team converte i topic selezionati in un formato di dataset che consente l'accesso casuale per frame.

Idee sbagliate comuni

  • rosbag è uno strumento di ROS 2 — è nato in ROS 1, e ROS 2 ne fornisce una versione riprogettata, rosbag2, usata tramite il comando ros2 bag
  • Un bag riprodotto si comporta come il robot dal vivo — la riproduzione è ad anello aperto, quindi i nodi modificati non possono influire sui dati dei sensori registrati né sul moto registrato del robot
  • Registrare tutti i topic è sempre la scelta sicura — immagini e nuvole di punti ad alta frequenza riempiono rapidamente lo spazio di archiviazione e possono causare la perdita di messaggi, quindi topic, compressione e suddivisione vanno scelti deliberatamente
  • I file bag sono un formato di dati di addestramento pronto all'uso — sono progettati per la registrazione e la riproduzione sequenziali, e l'apprendimento su larga scala di solito li converte in formati con un accesso casuale efficiente

Chi dovrebbe saperlo

  • Sviluppatori ROS e ingegneri del software robotico
  • Ingegneri di percezione e di SLAM
  • Ingegneri di test sul campo e di validazione
  • Ingegneri di robot learning che costruiscono dataset

Tecnologie correlate

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

Termini correlati

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

Progetti correlati

  • 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

Video

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

Questo sito richiede JavaScript. Attiva JavaScript per esplorare i nostri progetti di robotica open source.