Open Source Robotics

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

rosbag2_storage_rrd

Graba bags de ROS 2 directamente en el formato .rrd de Rerun

Licencia

Apache 2.0, MIT

Doble licencia: el repositorio incluye tanto LICENSE-APACHE como LICENSE-MIT, y el usuario puede elegir cualquiera de las dos. Comprobado el 2026-09-10.

Resumen

rosbag2_storage_rrd es un plugin de almacenamiento que hace que ros2 bag record -s rrd escriba archivos .rrd de Rerun en lugar del habitual SQLite o MCAP. El resultado es un bag que puedes abrir directamente en el visor de Rerun y seguir reproduciendo al grafo de ROS con ros2 bag play, de modo que inspeccionar deja de ser un paso de conversión aparte. También puede transmitir a un visor en marcha mientras la grabación ocurre, y guarda dentro del archivo las definiciones de mensajes, el QoS y los hashes de tipo, así que un bag se describe a sí mismo. Una fina capa C++ de pluginlib se apoya sobre un núcleo en Rust, enlazado como staticlib, de manera que el plugin es una única biblioteca compartida sin artefactos de ejecución adicionales.

La decisión de diseño interesante es que tú eliges para qué se optimiza el archivo. Hay tres representaciones disponibles y combinables: bytes en bruto para velocidad de grabación, arquetipos de Rerun para la máxima velocidad de consulta y visualización, y columnas Arrow reflejadas como término medio sin pérdidas. ros2 bag convert puede añadir o quitar representaciones después, de modo que una grabación rápida se enriquece más tarde en vez de repetirse. Fijar un identificador de grabación convierte el bag en una capa de un segmento de Rerun, lo que permite añadir capas después sin tocar el archivo original.

En la ruta de escritura, cada topic almacena sus mensajes en búfer y los vuelca como bloques Arrow columnares a través del RecordingStream del SDK de Rerun; con un server_uri configurado, un segundo flujo lleva esos mismos bloques al visor en vivo, y un visor que deja de responder solo puede producir un aviso, nunca un error del bag. En la ruta de lectura, el índice del pie del archivo planifica la reproducción y los saltos. La decodificación y la visualización vienen de la reflexión de mensajes ROS 2 de Rerun y sus lenses, el mismo código detrás del soporte de MCAP en Rerun, así que el plugin solo posee el búfer, el volcado y el contrato de rosbag2. Se construye como paquete ament con colcon; CMake dirige a cargo, y una cadena de herramientas de Rust es la única dependencia más allá de lo que package.xml ya pide.

Por qué importa

Mirar lo que un robot grabó de verdad siempre ha significado exportarlo antes a otro sitio. Hacer que el propio bag sea el formato de visualización elimina ese paso, y hacerlo como plugin de almacenamiento de rosbag2 en lugar de como herramienta aparte significa que nada del flujo de trabajo existente tiene que cambiar: los mismos ros2 bag record, info, play y convert siguen funcionando. Transmitir a un visor en vivo durante la grabación es la parte que cambia el comportamiento y no solo ahorra tiempo: puedes ver cómo se tuerce una ejecución en vez de enterarte después.

Qué problema resuelve

Un bag de ROS 2 es un buen formato de grabación y uno malo de inspección, así que mirarlo obliga a convertirlo en algo que un visor entienda y a mantener dos copias sincronizadas. Esto hace que el archivo grabado sea justo lo que el visor ya lee, sin renunciar a reproducirlo en el grafo de ROS.

Puntos clave

  • ros2 bag record -s rrd es toda la interfaz: el plugin encaja en rosbag2, así que info, play y convert siguen funcionando como siempre
  • Los bags se abren directamente en el visor de Rerun y siguen reproduciéndose byte a byte al grafo de ROS
  • Tres representaciones que puedes mezclar: bytes en bruto para velocidad de grabación, arquetipos de Rerun para velocidad de consulta y visualización, columnas Arrow reflejadas como término medio sin pérdidas
  • Configura un server_uri y esos mismos bloques van a un visor en marcha mientras grabas; un visor que deja de responder produce un aviso, nunca un error del bag
  • Archivos autodescriptivos: las definiciones de mensajes, el QoS y los hashes de tipo viajan dentro del bag
  • Una capa C++ de pluginlib sobre un núcleo Rust enlazado como staticlib, de modo que se despliega como una sola biblioteca compartida sin artefactos extra
  • La decodificación reutiliza la reflexión de mensajes ROS 2 y las lenses de Rerun, la misma ruta que hay tras el soporte de MCAP, en lugar de una segunda implementación

Para quién es

  • Desarrolladores de ROS 2 que dedican más tiempo a inspeccionar bags que a grabarlos
  • Equipos que ya usan Rerun y quieren sus registros de robot en el mismo visor que todo lo demás
  • Ingenieros de datos e infraestructura en robótica que evalúan formatos de almacenamiento de bags
  • Cualquiera que persiga un comportamiento intermitente y prefiera ver una ejecución en vivo antes que después

Limitaciones

  • Explícitamente experimental: el README avisa de que el diseño del .rrd y las claves de configuración pueden cambiar sin ruta de migración, y de que hay que esperar cambios incompatibles entre versiones
  • Las dependencias de Rust son un pin de git a un commit no publicado de rerun-io/rerun main, así que el visor debe instalarse desde esa misma revisión hasta la próxima versión de Rerun
  • Diez días de vida al escribir esto, cuatro commits, sin etiqueta de versión y 7 estrellas: es un vistazo temprano, no algo sobre lo que estandarizar
  • Solo ROS 2 Lyrical, probado en macOS arm64 y Linux x86_64/aarch64
  • No admite reabrir un bag en modo APPEND, y una definición que contenga un campo wstring se conserva como CDR en bruto
  • Un topic cuya definición no puede decodificarse, por ejemplo tipos ros2idl, se reproduce bien pero queda opaco en el visor

Este sitio web requiere JavaScript. Por favor, habilite JavaScript para explorar nuestros proyectos de robótica.