MCAP
Formato di file aperto e librerie per i log dei robot, predefinito per le bag di ROS 2
Licenza
MIT
Codice: MIT, secondo il file LICENSE nella radice del repository GitHub. Pacchetti: anche la libreria C++, i pacchetti TypeScript, i pacchetti Python e i crate Rust dichiarano MIT. Specifica: la specifica del formato e la documentazione si trovano nello stesso repository, con la stessa licenza. Nome e logo: MCAP e il suo logo appartengono a Foxglove e non sono concessi dalla licenza del codice. Verificato il 2026-11-10 su LICENSE, cpp/mcap/LICENSE, i file LICENSE dei pacchetti TypeScript, i file setup.cfg di Python e i file Cargo.toml di Rust.
Panoramica
MCAP è un formato di file contenitore aperto per registrare dati publish-subscribe con timestamp su più canali, il tipo di log che un robot scrive mentre funziona. Un file può contenere messaggi in più serializzazioni contemporaneamente, come ROS 1, ROS 2, Protobuf, FlatBuffers o JSON, e porta con sé lo schema di ogni messaggio, così da poter essere decodificato senza il codice originale. I dati vengono scritti solo in aggiunta, in blocchi che si possono comprimere con zstd o LZ4, e un indice alla fine permette ai lettori di saltare a un topic o a un intervallo di tempo senza scorrere tutto il file. Foxglove sviluppa MCAP in modo aperto con licenza MIT, con librerie in C++, Go, Python, Rust, Swift e TypeScript e uno strumento a riga di comando per esaminare, filtrare, unire e riparare i file. Dalla release ROS 2 Iron Irwini del 23 maggio 2023 è il formato di archiviazione predefinito di rosbag2, lo strumento di registrazione di ROS 2. A novembre 2026 Foxglove ha presentato un banco di prova comune per le sue librerie e i miglioramenti nella velocità di scrittura misurati con esso.
MCAP (si pronuncia "em-cap") è un formato di file e un insieme di librerie per registrare i dati dei robot, sviluppato in modo aperto da Foxglove, un'azienda che vende anche una piattaforma commerciale di dati per la robotica. Prima, il formato in cui un team registrava dipendeva dal suo framework: ROS 1 aveva i suoi file .bag, difficili da usare fuori da ROS, ROS 2 scriveva database SQLite che non contenevano le proprie definizioni dei messaggi, e molti altri team creavano formati binari interni. La valutazione dei formati esistenti di Foxglove non ne ha trovato nessuno adatto alla robotica, e MCAP è stato progettato per colmare questa lacuna. La specifica, la documentazione e il codice sorgente sono pubblici, e il formato ha un proprio tipo di media registrato, application/vnd.mcap.
Un file MCAP è una sequenza di record. I messaggi sono raggruppati in canali, ad esempio il topic di un sensore, e ogni canale rimanda a uno schema che descrive i suoi messaggi. Al formato non importa come i messaggi siano serializzati: il registro delle codifiche note comprende messaggi ROS 1 e ROS 2, Protobuf, FlatBuffers, JSON Schema, CBOR e Cap'n Proto, e uno stesso file può mescolarli. Poiché gli schemi sono salvati nel file, una registrazione si può decodificare anche anni dopo su una macchina che non ha mai avuto i pacchetti di messaggi originali. Chi scrive si limita ad aggiungere, il che mantiene veloce la registrazione e permette di recuperare un file scritto a metà se il robot perde l'alimentazione. I messaggi si possono raggruppare in blocchi compressi con zstd o LZ4, ciascuno con un checksum facoltativo, e una sezione di riepilogo facoltativa alla fine indicizza blocchi, canali, metadati e allegati. Questo indice permette a un lettore di recuperare un topic o una finestra di tempo senza leggere il resto del file, anche attraverso una rete.
Esistono librerie per C++, Go, Python, Rust, Swift e TypeScript, tutte verificate rispetto alla specifica, anche se la matrice di supporto mostra che non offrono tutte le stesse funzioni di lettura. Il pacchetto Python aggiunge strumenti per i dati ROS 1, ROS 2 e Protobuf. Lo strumento a riga di comando di MCAP, installabile con Homebrew o scaricabile come binario di una release, mostra le statistiche di un file, filtra, unisce, ordina, comprime e recupera i file, e converte in MCAP le registrazioni ROS 1 .bag e ROS 2 .db3. Nel 2026 Foxglove lo ha riscritto da Go in Rust, con la stessa interfaccia.
In ROS 2, rosbag2 registra tramite plugin di archiviazione, e il suo plugin MCAP è diventato quello predefinito con la release Iron Irwini del 23 maggio 2023, dopo una pull request che ha sostituito SQLite come scelta predefinita. SQLite resta disponibile come opzione. Molti visualizzatori e strumenti per i dati dei robot aprono i file MCAP, tra cui l'app di Foxglove stessa, Lichtblick, BAGEL, PlotJuggler e Rerun.
Il 9 novembre 2026 Foxglove ha pubblicato Measuring and improving MCAP performance, su un banco di prova comune aggiunto con la pull request 1611. Fa passare le librerie C++, Rust, Go, Python e TypeScript attraverso tre scenari con dati identici byte per byte: un milione di messaggi da 100 byte su un solo canale in ogni modalità di archiviazione (senza blocchi, a blocchi, zstd e LZ4); una registrazione simulata di un robot di 10 secondi con 5 canali, da un sensore inerziale a 200 Hz a fotogrammi di telecamera da 512 KB, circa 102 MB in totale; e letture di quella registrazione filtrate per topic, per intervallo di tempo o per entrambi. Ogni esecuzione controlla i byte scritti e il numero di messaggi riletti, e registra tempo, dimensione del file e picco di memoria. Secondo le misure della stessa Foxglove, su un AMD Ryzen AI MAX+ 395 bloccato a 3,0 GHz e scrivendo su un file system in RAM, le scritture LZ4 in C++ nel test del milione di messaggi sono circa 8 volte più veloci rispetto a gennaio 2026, e il tempo di scrittura di Rust in quel test si è più che dimezzato. Una parte del guadagno viene da nuove impostazioni predefinite più che da codice più veloce: Go e C++ usano ora l'impostazione LZ4 più rapida, che rende i file più grandi dal 15% al 30%, mentre C++ è passato al livello 3 per zstd, con file più piccoli di circa il 31% al prezzo di scritture più lente. I risultati pubblicati riguardano solo la scrittura, e Foxglove indica la libreria Python come molto più lenta delle altre con messaggi piccoli.
Perché è importante
È registrando che i team di robotica fanno debug, indagano sugli incidenti e raccolgono dati di addestramento, e un log è utile solo se gli strumenti intorno sanno leggerlo. MCAP è il file che ROS 2 scrive quando qualcuno lancia ros2 bag record su una release attuale, e il formato che visualizzatori come Lichtblick, PlotJuggler e Rerun accettano, quindi è molto usato per i log dei robot, dentro e fuori ROS. È aperto con licenza MIT, ha una specifica scritta e un tipo di media registrato, e porta con sé i propri schemi, così i dati registrati oggi si potranno decodificare anche in futuro senza il codice che li ha prodotti. Foxglove, un'azienda commerciale, ne cura lo sviluppo, e il banco di prova comune nel repository offre a chiunque un modo condiviso per verificare le prestazioni delle sue librerie sul proprio hardware invece di affidarsi ai numeri di Foxglove. Il plugin rosbag2 per il formato RRD di Rerun è un'alternativa per i team che vogliono archiviare le loro bag pensando alle interrogazioni e alla visualizzazione più che alla velocità di registrazione.
Il problema che risolve
I log dei robot mescolano molti flussi di dati con frequenze e dimensioni diverse, e prima di MCAP il file in cui un team registrava dipendeva dal suo framework: bag ROS 1 difficili da leggere fuori da ROS, database SQLite di ROS 2 che non contenevano le proprie definizioni dei messaggi, o formati interni che ogni strumento doveva imparare. MCAP offre loro un contenitore aperto e autodescrittivo che scrive velocemente, sopravvive alle registrazioni interrotte, accoglie qualsiasi serializzazione nello stesso file e si può consultare per topic e per tempo tramite un indice, con librerie in sei linguaggi perché gli strumenti possano leggerlo e scriverlo senza costruire ciascuno il proprio parser.
Punti chiave
- Un formato di file contenitore aperto per dati publish-subscribe con timestamp come i log dei robot, con specifica pubblica e tipo di media application/vnd.mcap
- Indipendente dalla serializzazione: ROS 1, ROS 2, Protobuf, FlatBuffers, JSON e altro in un solo file, con ogni schema salvato all'interno
- Scrittura solo in aggiunta, recupero dei file interrotti, compressione a blocchi con zstd o LZ4 e un indice per leggere per topic o intervallo di tempo
- Librerie in C++, Go, Python, Rust, Swift e TypeScript, più uno strumento a riga di comando ora scritto in Rust
- Formato di archiviazione predefinito di rosbag2 da ROS 2 Iron Irwini, uscito il 23 maggio 2023
- Un banco di prova comune per cinque delle librerie, con i risultati di scrittura della stessa Foxglove pubblicati il 9 novembre 2026
- Licenza MIT, sviluppato in modo aperto da Foxglove
A chi si rivolge
- Sviluppatori ROS 2 che registrano, riproducono e convertono bag
- Team di robotica fuori da ROS che hanno bisogno di un unico formato di log per dati misti Protobuf, JSON o FlatBuffers
- Sviluppatori di strumenti per i dati, visualizzatori e pipeline che devono leggere e scrivere log di robot
- Team che raccolgono dati dei robot per il machine learning e vogliono registrazioni autodescrittive e indicizzate
Limiti
- Foxglove, un'azienda commerciale, cura il formato e la maggior parte delle librerie, e la sua piattaforma di dati per la robotica è un prodotto commerciale
- Le librerie non offrono tutte le stesse funzioni: la matrice di supporto indica, per esempio, che Rust non ha la lettura ordinata per timestamp e Swift non ha la lettura indicizzata non ordinata
- I dati sulle prestazioni dell'articolo di novembre 2026 sono della stessa Foxglove, misurati su una macchina AMD Ryzen AI MAX+ 395 che scriveva su un file system in RAM
- Quei risultati riguardano solo la scrittura; la velocità di lettura non fa parte del confronto pubblicato
- La libreria Python è molto più lenta delle altre con messaggi piccoli, per ammissione della stessa Foxglove
- Le impostazioni predefinite di scrittura, come compressione e suddivisione in blocchi, differiscono ancora tra i linguaggi, quindi gli stessi dati possono dare dimensioni dei file e velocità diverse
- L'indice si trova nella sezione di riepilogo alla fine del file, quindi una registrazione interrotta prima della chiusura non ha indice finché non viene recuperata con la CLI