Open Source Robotics

Una colección curada de proyectos, herramientas y software de robótica de código abierto de alta calidad.

rosbag

  • También llamado: ROS bag, rosbag2, ros2 bag, bag file
  • Categoría: Software & tooling › Tools & formats
  • Etiquetas: ros, data-logging, datasets, debugging, robot-software

La herramienta y el formato de archivo de ROS para grabar mensajes con marca de tiempo de los tópicos y reproducirlos más tarde; en ROS 2 lo proporciona rosbag2 mediante el comando ros2 bag.

Definición

rosbag graba los mensajes publicados en tópicos de ROS seleccionados, como imágenes de cámara, barridos de lidar, estados articulares, transformaciones y órdenes, en un archivo llamado bag, junto con sus marcas de tiempo y tipos de mensaje. La misma herramienta reproduce un bag, volviendo a publicar los mensajes en sus tópicos originales a la frecuencia grabada o más rápido o más despacio, de modo que otros nodos los reciben como si el robot estuviera funcionando. Los bags se pueden inspeccionar para ver sus tópicos, recuentos de mensajes y duración, filtrar por tópicos o intervalos de tiempo seleccionados y leer directamente desde código mediante bibliotecas cliente de Python y C++.

rosbag nació en ROS 1, donde rosbag record y rosbag play escribían y leían el formato .bag. ROS 2 lo sustituyó por rosbag2, que se usa mediante el comando ros2 bag y separa la lógica de grabación de unos back ends de almacenamiento intercambiables. Las primeras versiones de ROS 2 guardaban los bags en bases de datos SQLite3, y las versiones más recientes usan por defecto MCAP, un formato contenedor abierto diseñado para datos robóticos multimodales con marcas de tiempo. Los bags de ROS 1 y ROS 2 no son directamente intercambiables, aunque existen herramientas de conversión. Las opciones de grabación incluyen compresión, división de archivos por tamaño o duración y ajustes de calidad de servicio para coincidir con los publicadores.

Los bags son la forma habitual de capturar datos de campo para depuración, desarrollo fuera de línea y creación de conjuntos de datos. Reproducir un bag permite a los ingenieros volver a ejecutar código de percepción o de estimación con entradas idénticas, comparar versiones de algoritmos y reproducir fallos sin el robot. Algunos puntos requieren cuidado: la reproducción puede publicar un tópico de reloj, y entonces los nodos deben usar el tiempo simulado; hay que grabar tanto las transformaciones dinámicas como las estáticas; los nodos que publicarían los mismos tópicos que el bag no deben ejecutarse durante la reproducción; y los flujos de sensores de alta frecuencia llenan los discos rápidamente. Para el aprendizaje a gran escala, los bags se convierten a menudo a formatos pensados para el acceso aleatorio y la carga por lotes, porque la estructura del bag está diseñada para la grabación y reproducción secuenciales.

Por qué importa

Casi todos los robots basados en ROS dependen de datos grabados para la depuración y el desarrollo. Los bags permiten reproducir lo que el robot percibió e hizo, probar cambios fuera de línea con datos reales de sensores y construir conjuntos de datos, por lo que grabarlos, reproducirlos y convertirlos es práctica básica de ROS.

Aplicaciones clave

  • Depuración del comportamiento del robot reproduciendo datos de sensores grabados
  • Desarrollo y ajuste fuera de línea de percepción, localización y SLAM
  • Pruebas de regresión de algoritmos con datos reales fijos
  • Recopilación de conjuntos de datos de demostraciones y de sensores para el aprendizaje robótico
  • Registro en campo para el análisis de incidentes
  • Compartición de conjuntos de datos de referencia en un formato nativo de ROS

En la práctica

Un equipo que prueba un robot móvil de exteriores graba un bag en cada salida de campo con barridos de lidar, imágenes de cámara, datos de la IMU, odometría de ruedas, transformaciones y las órdenes enviadas a la base, dividiendo los archivos cada pocos minutos y comprimiéndolos. Cuando la localización del robot deriva durante una salida, un ingeniero de vuelta en la oficina reproduce el bag con tiempo simulado, ejecuta un nodo de localización modificado sobre los tópicos de sensores grabados dejando fuera la salida de localización original, y compara las dos trayectorias en un visualizador. Una vez que la corrección funciona con varios bags, esos bags se convierten en pruebas de regresión en la integración continua. Para entrenar un modelo de percepción, el equipo convierte los tópicos seleccionados a un formato de conjunto de datos que permite el acceso aleatorio por fotograma.

Ideas erróneas comunes

  • rosbag es una herramienta de ROS 2 — se originó en ROS 1, y ROS 2 ofrece una versión rediseñada, rosbag2, que se usa mediante el comando ros2 bag
  • Un bag reproducido se comporta como el robot en vivo — la reproducción es en lazo abierto, así que los nodos modificados no pueden afectar a los datos de sensores grabados ni al movimiento grabado del robot
  • Grabar todos los tópicos es siempre la opción segura — las imágenes y nubes de puntos de alta frecuencia llenan el almacenamiento rápidamente y pueden provocar pérdida de mensajes, así que los tópicos, la compresión y la división deben elegirse deliberadamente
  • Los archivos bag son un formato de datos de entrenamiento listo para usar — están diseñados para la grabación y reproducción secuenciales, y el aprendizaje a gran escala suele convertirlos a formatos con acceso aleatorio eficiente

Quién debería saberlo

  • Desarrolladores de ROS e ingenieros de software robótico
  • Ingenieros de percepción y de SLAM
  • Ingenieros de pruebas de campo y de validación
  • Ingenieros de aprendizaje robótico que construyen conjuntos de datos

Tecnologías relacionadas

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

Términos relacionados

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

Proyectos 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 sitio web requiere JavaScript. Por favor, habilite JavaScript para explorar nuestros proyectos de robótica.