Open Source Robotics

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

rosbag

  • Também chamado: ROS bag, rosbag2, ros2 bag, bag file
  • Categoria: Software & tooling › Tools & formats
  • Tags: ros, data-logging, datasets, debugging, robot-software

A ferramenta e o formato de arquivo do ROS para gravar mensagens com carimbo de tempo de tópicos e reproduzi-las depois; no ROS 2, é fornecido pelo rosbag2 por meio do comando ros2 bag.

Definição

rosbag grava as mensagens publicadas em tópicos ROS selecionados, como imagens de câmera, varreduras de lidar, estados das juntas, transformações e comandos, em um arquivo chamado bag, junto com seus carimbos de tempo e tipos de mensagem. A mesma ferramenta reproduz um bag, republicando as mensagens em seus tópicos originais na taxa gravada ou mais rápido ou mais devagar, de modo que outros nós as recebem como se o robô estivesse funcionando. Bags podem ser inspecionados quanto a seus tópicos, contagens de mensagens e duração, filtrados por tópicos ou intervalos de tempo selecionados e lidos diretamente por código por meio de bibliotecas cliente em Python e C++.

O rosbag começou no ROS 1, em que rosbag record e rosbag play gravavam e liam o formato .bag. O ROS 2 o substituiu pelo rosbag2, usado por meio do comando ros2 bag, que separa a lógica de gravação de back ends de armazenamento plugáveis. As primeiras versões do ROS 2 armazenavam bags em bancos de dados SQLite3, e versões mais recentes usam por padrão o MCAP, um formato contêiner aberto projetado para dados robóticos multimodais com carimbo de tempo. Bags do ROS 1 e do ROS 2 não são diretamente intercambiáveis, embora existam ferramentas de conversão. As opções de gravação incluem compressão, divisão de arquivos por tamanho ou duração e configurações de qualidade de serviço para combinar com os publicadores.

Bags são o modo usual de capturar dados de campo para depuração, desenvolvimento offline e criação de conjuntos de dados. Reproduzir um bag permite aos engenheiros executar de novo código de percepção ou de estimação com entradas idênticas, comparar versões de algoritmos e reproduzir falhas sem o robô. Alguns pontos exigem cuidado: a reprodução pode publicar um tópico de relógio, e então os nós devem usar tempo simulado; tanto as transformações dinâmicas quanto as estáticas precisam ser gravadas; nós que publicariam os mesmos tópicos do bag não devem rodar durante a reprodução; e fluxos de sensores de alta taxa enchem discos rapidamente. Para aprendizado em larga escala, bags são muitas vezes convertidos em formatos feitos para acesso aleatório e carregamento em lotes, porque a estrutura do bag é projetada para gravação e reprodução sequenciais.

Por que importa

Quase todo robô baseado em ROS depende de dados gravados para depuração e desenvolvimento. Bags tornam possível reproduzir o que o robô percebeu e fez, testar mudanças offline com dados reais de sensores e construir conjuntos de dados, então gravá-los, reproduzi-los e convertê-los é prática básica de ROS.

Principais aplicações

  • Depuração do comportamento do robô reproduzindo dados de sensores gravados
  • Desenvolvimento e ajuste offline de percepção, localização e SLAM
  • Testes de regressão de algoritmos com dados reais fixos
  • Coleta de conjuntos de dados de demonstrações e de sensores para aprendizado robótico
  • Registro em campo para análise de incidentes
  • Compartilhamento de conjuntos de dados de benchmark em formato nativo do ROS

Na prática

Uma equipe que testa um robô móvel para ambientes externos grava um bag em cada saída de campo com varreduras de lidar, imagens de câmera, dados da IMU, odometria das rodas, transformações e os comandos enviados à base, dividindo os arquivos a cada poucos minutos e comprimindo-os. Quando a localização do robô deriva durante uma saída, um engenheiro de volta ao escritório reproduz o bag com tempo simulado, executa um nó de localização modificado sobre os tópicos de sensores gravados, deixando de fora a saída de localização original, e compara as duas trajetórias em um visualizador. Quando a correção funciona em vários bags, esses bags se tornam testes de regressão na integração contínua. Para treinar um modelo de percepção, a equipe converte os tópicos selecionados em um formato de conjunto de dados que permite acesso aleatório por quadro.

Equívocos comuns

  • O rosbag é uma ferramenta do ROS 2 — ele surgiu no ROS 1, e o ROS 2 oferece uma versão redesenhada, o rosbag2, usada por meio do comando ros2 bag
  • Um bag reproduzido se comporta como o robô ao vivo — a reprodução é em malha aberta, então nós alterados não podem afetar os dados de sensores gravados nem o movimento gravado do robô
  • Gravar todos os tópicos é sempre a escolha segura — imagens e nuvens de pontos de alta taxa enchem o armazenamento rapidamente e podem causar perda de mensagens, então tópicos, compressão e divisão devem ser escolhidos deliberadamente
  • Arquivos bag são um formato de dados de treinamento pronto para uso — eles são projetados para gravação e reprodução sequenciais, e o aprendizado em larga escala geralmente os converte em formatos com acesso aleatório eficiente

Quem deve saber

  • Desenvolvedores ROS e engenheiros de software robótico
  • Engenheiros de percepção e de SLAM
  • Engenheiros de testes de campo e de validação
  • Engenheiros de aprendizado robótico que constroem conjuntos de dados

Tecnologias relacionadas

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

Termos relacionados

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

Projetos relacionados

  • 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

Vídeos

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

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