rosbag2_storage_rrd
Registra bag ROS 2 direttamente nel formato .rrd di Rerun
Licenza
Apache 2.0, MIT
Doppia licenza: il repository include sia LICENSE-APACHE sia LICENSE-MIT, e l'utente può scegliere l'una o l'altra. Verificato il 2026-09-10.
Panoramica
rosbag2_storage_rrd è un plugin di archiviazione che fa sì che ros2 bag record -s rrd scriva file Rerun .rrd invece dei consueti SQLite o MCAP. Il risultato è un bag che si può aprire direttamente nel visualizzatore Rerun e che si può comunque riprodurre nel grafo ROS con ros2 bag play, così l'ispezione smette di essere una fase di conversione separata. Può anche trasmettere a un visualizzatore in esecuzione mentre la registrazione è in corso, e salva nel file le definizioni dei messaggi, la QoS e gli hash dei tipi, così il bag descrive sé stesso. Un sottile strato C++ pluginlib si appoggia su un nucleo Rust, collegato come staticlib, quindi il plugin è un'unica libreria condivisa senza artefatti di runtime aggiuntivi.
La scelta progettuale interessante è che si decide per cosa è ottimizzato il file. Sono disponibili tre rappresentazioni, combinabili tra loro: byte grezzi per la velocità di registrazione, archetype Rerun per le query e la visualizzazione più rapide, e colonne Arrow riflesse come via di mezzo senza perdita. ros2 bag convert può aggiungere o rimuovere rappresentazioni a posteriori, così una registrazione veloce può essere arricchita in seguito anziché ripetuta. Impostare un recording id rende il bag uno strato di un segmento Rerun, il che significa che si possono aggiungere altri strati in seguito senza toccare il file originale.
In scrittura, ogni topic mette in buffer i messaggi e li scarica come chunk Arrow colonnari attraverso il RecordingStream dell'SDK Rerun; con un server_uri configurato, un secondo flusso porta gli stessi chunk a un visualizzatore attivo, e un visualizzatore che smette di rispondere può produrre solo un avviso, mai un errore del bag. In lettura, l'indice nel footer del file pianifica la riproduzione e i salti. La decodifica e la visualizzazione provengono dalla reflection dei messaggi ROS 2 e dalle lens di Rerun, lo stesso codice alla base del supporto MCAP di Rerun, quindi il plugin gestisce solo buffering, scaricamento e il contratto rosbag2. Si compila come pacchetto ament con colcon; CMake gestisce cargo, e una toolchain Rust è l'unica dipendenza oltre a quelle già richieste da package.xml.
Perché è importante
Guardare ciò che un robot ha effettivamente registrato ha sempre significato esportarlo prima altrove. Fare del bag stesso il formato di visualizzazione elimina questo passaggio, e farlo come plugin di archiviazione rosbag2 anziché come strumento separato significa che nulla in un flusso di lavoro esistente deve cambiare: gli stessi comandi ros2 bag record, info, play e convert continuano a funzionare. La trasmissione a un visualizzatore attivo durante la registrazione è la parte che cambia il modo di lavorare, non solo il tempo risparmiato: si può vedere una run andare storta invece di scoprirlo dopo.
Il problema che risolve
Un bag ROS 2 è un buon formato di registrazione e un cattivo formato di ispezione, quindi guardarne uno significa convertirlo in qualcosa che un visualizzatore comprende e tenere allineate due copie. Questo plugin fa del file registrato ciò che il visualizzatore legge già, senza rinunciare alla riproduzione nel grafo ROS.
Punti chiave
- ros2 bag record -s rrd è l'intera interfaccia: il plugin si inserisce in rosbag2, quindi info, play e convert continuano a funzionare come sempre
- I bag si aprono direttamente nel visualizzatore Rerun e si riproducono comunque byte per byte nel grafo ROS
- Tre rappresentazioni combinabili: byte grezzi per la velocità di registrazione, archetype Rerun per la velocità di query e visualizzazione, colonne Arrow riflesse come via di mezzo senza perdita
- Impostando un server_uri, gli stessi chunk vengono trasmessi a un visualizzatore in esecuzione durante la registrazione; un visualizzatore che smette di rispondere produce un avviso, mai un errore del bag
- File autodescrittivi: definizioni dei messaggi, QoS e hash dei tipi viaggiano all'interno del bag
- Uno strato C++ pluginlib su un nucleo Rust collegato come staticlib, quindi si distribuisce come un'unica libreria condivisa senza artefatti di runtime aggiuntivi
- La decodifica riusa la reflection dei messaggi ROS 2 e le lens di Rerun, lo stesso percorso alla base del supporto MCAP di Rerun, anziché una seconda implementazione
A chi si rivolge
- Sviluppatori ROS 2 che passano più tempo a ispezionare bag che a registrarli
- Team che usano già Rerun e vogliono i log dei propri robot nello stesso visualizzatore di tutto il resto
- Ingegneri dei dati e dell'infrastruttura robotica che valutano i formati di archiviazione dei bag
- Chiunque debba fare il debug di comportamenti intermittenti e preferisca osservare una run dal vivo anziché dopo
Limiti
- Esplicitamente sperimentale: il README avverte che il layout .rrd e le chiavi di configurazione potrebbero cambiare senza un percorso di migrazione, e che ci si devono aspettare modifiche incompatibili tra una release e l'altra
- Le dipendenze Rust sono fissate via git a un commit non rilasciato del main di rerun-io/rerun, quindi il visualizzatore deve essere installato dalla stessa revisione fino alla prossima release di Rerun
- Ha dieci giorni al momento della stesura, con quattro commit, nessun tag di release e 7 stelle: è un primo sguardo, non qualcosa su cui standardizzarsi
- Solo ROS 2 Lyrical, testato su macOS arm64 e Linux x86_64/aarch64
- La riapertura di un bag in modalità APPEND non è supportata, e una definizione che contiene un campo wstring viene conservata come CDR grezzo
- Un topic la cui definizione non può essere decodificata, per esempio i tipi ros2idl, si riproduce correttamente ma è opaco nel visualizzatore