Open Source Robotics

Uma coleção selecionada de projetos, ferramentas e software de robótica de código aberto de alta qualidade.

MCAP

Formato de arquivo aberto e bibliotecas para logs de robôs, padrão nos bags do ROS 2

Licença

MIT

Código: MIT, conforme o arquivo LICENSE na raiz do repositório no GitHub. Pacotes: a biblioteca C++, os pacotes TypeScript, os pacotes Python e os crates Rust também declaram MIT. Especificação: a especificação do formato e a documentação ficam no mesmo repositório, sob a mesma licença. Nome e logotipo: MCAP e seu logotipo pertencem à Foxglove e não são concedidos pela licença do código. Verificado em 2026-11-10 com LICENSE, cpp/mcap/LICENSE, os arquivos LICENSE dos pacotes TypeScript, os arquivos setup.cfg do Python e os arquivos Cargo.toml do Rust.

Visão geral

MCAP é um formato de arquivo contêiner aberto para gravar dados de publicação-assinatura com carimbo de tempo e vários canais, o tipo de log que um robô escreve enquanto funciona. Um arquivo pode conter mensagens em várias serializações ao mesmo tempo, como ROS 1, ROS 2, Protobuf, FlatBuffers ou JSON, e carrega o esquema de cada mensagem, de modo que pode ser decodificado sem o código original. Os dados são gravados apenas por acréscimo, em blocos que podem ser comprimidos com zstd ou LZ4, e um índice no final permite que os leitores saltem para um tópico ou intervalo de tempo sem percorrer o arquivo inteiro. A Foxglove desenvolve o MCAP de forma aberta sob a licença MIT, com bibliotecas em C++, Go, Python, Rust, Swift e TypeScript e uma ferramenta de linha de comando para inspecionar, filtrar, mesclar e reparar arquivos. Desde a versão ROS 2 Iron Irwini, de 23 de maio de 2023, é o formato de armazenamento padrão do rosbag2, a ferramenta de gravação do ROS 2. Em novembro de 2026 a Foxglove apresentou um conjunto de benchmarks compartilhado para suas bibliotecas e os ganhos de velocidade de escrita que mediu com ele.

MCAP (pronuncia-se "em-cap") é um formato de arquivo e um conjunto de bibliotecas para registrar dados de robôs, desenvolvido de forma aberta pela Foxglove, uma empresa que também vende uma plataforma comercial de dados para robótica. Antes, o formato em que uma equipe gravava dependia do seu framework: o ROS 1 tinha seus arquivos .bag, difíceis de usar fora do ROS, o ROS 2 gravava bancos de dados SQLite que não traziam as próprias definições de mensagens, e muitas outras equipes criavam formatos binários internos. A avaliação de formatos existentes da Foxglove não encontrou nenhum que servisse bem à robótica, e o MCAP foi projetado para preencher essa lacuna. Sua especificação, sua documentação e seu código-fonte são públicos, e o formato tem seu próprio tipo de mídia registrado, application/vnd.mcap.

Um arquivo MCAP é uma sequência de registros. As mensagens são agrupadas em canais, como o tópico de um sensor, e cada canal aponta para um esquema que descreve suas mensagens. O formato não se importa com a forma como as mensagens são serializadas: o registro de codificações conhecidas inclui mensagens do ROS 1 e do ROS 2, Protobuf, FlatBuffers, JSON Schema, CBOR e Cap'n Proto, e um mesmo arquivo pode misturá-los. Como os esquemas ficam guardados no arquivo, uma gravação pode ser decodificada anos depois numa máquina que nunca teve os pacotes de mensagens originais. Os gravadores apenas acrescentam dados, o que mantém a gravação rápida e permite recuperar um arquivo gravado pela metade se o robô perder energia. As mensagens podem ser agrupadas em blocos comprimidos com zstd ou LZ4, cada um com uma soma de verificação opcional, e uma seção de resumo opcional no final indexa blocos, canais, metadados e anexos. Esse índice permite que um leitor busque um tópico ou uma janela de tempo sem ler o restante do arquivo, inclusive pela rede.

Há bibliotecas para C++, Go, Python, Rust, Swift e TypeScript, todas testadas contra a especificação, embora a matriz de suporte mostre que nem todas oferecem os mesmos recursos de leitura. O pacote Python inclui utilitários para dados do ROS 1, do ROS 2 e Protobuf. A ferramenta de linha de comando do MCAP, instalada com Homebrew ou baixada como binário de uma versão, mostra estatísticas de arquivos, filtra, mescla, ordena, comprime e recupera arquivos, e converte gravações ROS 1 .bag e ROS 2 .db3 para MCAP. Em 2026 a Foxglove a reescreveu de Go para Rust, com a mesma interface.

No ROS 2, o rosbag2 grava por meio de plugins de armazenamento, e seu plugin MCAP passou a ser o padrão com a versão Iron Irwini de 23 de maio de 2023, depois de um pull request que substituiu o SQLite como padrão. O SQLite continua disponível como opção. Muitos visualizadores e ferramentas para dados de robôs abrem arquivos MCAP, entre eles o próprio aplicativo da Foxglove, Lichtblick, BAGEL, PlotJuggler e Rerun.

Em 9 de novembro de 2026 a Foxglove publicou Measuring and improving MCAP performance, sobre um conjunto de benchmarks compartilhado adicionado no pull request 1611. Ele passa as bibliotecas de C++, Rust, Go, Python e TypeScript por três cenários com dados idênticos byte a byte: um milhão de mensagens de 100 bytes num único canal em cada modo de armazenamento (sem blocos, com blocos, zstd e LZ4); uma gravação simulada de robô de 10 segundos com 5 canais, de um sensor inercial a 200 Hz a quadros de câmera de 512 KB, cerca de 102 MB no total; e leituras dessa gravação filtradas por tópico, por intervalo de tempo ou pelos dois. Cada execução confere os bytes gravados e o número de mensagens lidas de volta, e registra o tempo, o tamanho do arquivo e o pico de memória. Pelas medições da própria Foxglove, num AMD Ryzen AI MAX+ 395 fixado em 3,0 GHz e gravando num sistema de arquivos em RAM, as gravações LZ4 em C++ no teste de um milhão de mensagens estão cerca de 8 vezes mais rápidas do que em janeiro de 2026, e o tempo de gravação do Rust nesse teste caiu para menos da metade. Parte do ganho vem de novos padrões, e não de código mais rápido: Go e C++ agora usam a configuração LZ4 mais rápida, que deixa os arquivos de 15% a 30% maiores, enquanto o C++ passou para o nível 3 no zstd, com arquivos cerca de 31% menores ao custo de gravações mais lentas. Os resultados publicados cobrem apenas a gravação, e a Foxglove aponta a biblioteca Python como muito mais lenta que as outras com mensagens pequenas.

Por que importa

É gravando que equipes de robótica depuram, investigam incidentes e coletam dados de treinamento, e um log só serve se as ferramentas ao redor conseguirem lê-lo. MCAP é o arquivo que o ROS 2 grava quando alguém executa ros2 bag record numa versão atual, e o formato que visualizadores como Lichtblick, PlotJuggler e Rerun aceitam, por isso é muito usado para logs de robôs, dentro e fora do ROS. É aberto sob MIT, tem uma especificação escrita e um tipo de mídia registrado, e carrega os próprios esquemas, de modo que dados gravados hoje ainda poderão ser decodificados depois sem o código que os gerou. A Foxglove, uma empresa comercial, cuida do projeto, e o conjunto de benchmarks compartilhado no repositório dá a qualquer pessoa uma forma comum de verificar o desempenho das bibliotecas no próprio hardware, em vez de depender dos números da Foxglove. O plugin rosbag2 para o formato RRD do Rerun é uma alternativa para equipes que querem guardar seus bags pensando em consultas e visualização, mais do que em velocidade de gravação.

Problema que resolve

Logs de robôs misturam muitos fluxos de dados com frequências e tamanhos diferentes, e antes do MCAP o arquivo em que uma equipe gravava dependia do seu framework: bags do ROS 1 difíceis de ler fora do ROS, bancos SQLite do ROS 2 que não traziam as próprias definições de mensagens, ou formatos internos que cada ferramenta precisava aprender. O MCAP oferece um contêiner aberto e autodescritivo que grava rápido, resiste a gravações interrompidas, aceita qualquer serialização no mesmo arquivo e pode ser consultado por tópico e tempo por meio de um índice, com bibliotecas em seis linguagens para que as ferramentas o leiam e gravem sem que cada uma construa o próprio parser.

Pontos principais

  • Um formato de arquivo contêiner aberto para dados de publicação-assinatura com carimbo de tempo, como logs de robôs, com especificação pública e o tipo de mídia application/vnd.mcap
  • Independente da serialização: ROS 1, ROS 2, Protobuf, FlatBuffers, JSON e outros num só arquivo, com cada esquema guardado dentro dele
  • Gravação apenas por acréscimo, recuperação de arquivos interrompidos, compressão por blocos com zstd ou LZ4 e um índice para ler por tópico ou intervalo de tempo
  • Bibliotecas em C++, Go, Python, Rust, Swift e TypeScript, além de uma ferramenta de linha de comando agora escrita em Rust
  • Formato de armazenamento padrão do rosbag2 desde o ROS 2 Iron Irwini, lançado em 23 de maio de 2023
  • Um conjunto de benchmarks compartilhado para cinco das bibliotecas, com resultados de gravação da própria Foxglove publicados em 9 de novembro de 2026
  • Licença MIT, desenvolvido de forma aberta pela Foxglove

Para quem é

  • Desenvolvedores de ROS 2 que gravam, reproduzem e convertem bags
  • Equipes de robótica fora do ROS que precisam de um único formato de log para dados mistos de Protobuf, JSON ou FlatBuffers
  • Desenvolvedores de ferramentas de dados, visualizadores e pipelines que precisam ler e gravar logs de robôs
  • Equipes que coletam dados de robôs para aprendizado de máquina e querem gravações autodescritivas e indexadas

Limitações

  • A Foxglove, uma empresa comercial, cuida do formato e da maioria das bibliotecas, e sua própria plataforma de dados para robótica é um produto comercial
  • Nem todas as bibliotecas oferecem os mesmos recursos: a matriz de suporte indica, por exemplo, que o Rust não tem leitura ordenada por carimbo de tempo e o Swift não tem leitura indexada sem ordem
  • Os números de desempenho da publicação de novembro de 2026 são da própria Foxglove, medidos numa máquina AMD Ryzen AI MAX+ 395 que gravava num sistema de arquivos em RAM
  • Esses resultados cobrem só a gravação; a velocidade de leitura não faz parte da comparação publicada
  • A biblioteca Python é muito mais lenta que as outras com mensagens pequenas, segundo a própria Foxglove
  • Os padrões dos gravadores, como compressão e divisão em blocos, ainda diferem entre linguagens, então os mesmos dados podem gerar tamanhos de arquivo e velocidades diferentes
  • O índice fica na seção de resumo no final do arquivo, então uma gravação interrompida antes de ser fechada não tem índice até ser recuperada com a CLI

Este site requer JavaScript. Por favor, habilite o JavaScript para explorar nossos projetos de robótica.