Open Source Robotics

Une collection organisée de projets, outils et logiciels robotiques open source de haute qualité.

rosbag

  • Aussi appelé: ROS bag, rosbag2, ros2 bag, bag file
  • Catégorie: Software & tooling › Tools & formats
  • Mots-clés: ros, data-logging, datasets, debugging, robot-software

L'outil et le format de fichier ROS qui servent à enregistrer des messages horodatés provenant de topics et à les rejouer plus tard ; dans ROS 2, il est fourni par rosbag2 via la commande ros2 bag.

Définition

rosbag enregistre les messages publiés sur des topics ROS choisis, comme des images de caméra, des balayages LiDAR, des états articulaires, des transformations et des commandes, dans un fichier appelé bag, avec leurs horodatages et leurs types de message. Le même outil rejoue un bag en republiant les messages sur leurs topics d'origine à la cadence enregistrée, ou plus vite ou plus lentement, de sorte que les autres nœuds les reçoivent comme si le robot fonctionnait. On peut inspecter les bags pour connaître leurs topics, leur nombre de messages et leur durée, les filtrer sur certains topics ou certaines plages de temps, et les lire directement depuis du code grâce aux bibliothèques clientes Python et C++.

rosbag est né dans ROS 1, où rosbag record et rosbag play écrivaient et lisaient le format .bag. ROS 2 l'a remplacé par rosbag2, utilisé via la commande ros2 bag, qui sépare la logique d'enregistrement de back-ends de stockage interchangeables. Les premières versions de ROS 2 stockaient les bags dans des bases de données SQLite3, et les versions plus récentes utilisent par défaut MCAP, un format conteneur ouvert conçu pour les données robotiques horodatées et multimodales. Les bags de ROS 1 et de ROS 2 ne sont pas directement interchangeables, bien que des outils de conversion existent. Les options d'enregistrement comprennent la compression, le découpage des fichiers par taille ou par durée, et des réglages de qualité de service (quality of service) assortis à ceux des éditeurs.

Les bags sont le moyen habituel de capturer des données de terrain pour le débogage, le développement hors ligne et la création de jeux de données. Rejouer un bag permet aux ingénieurs de relancer du code de perception ou d'estimation sur des entrées identiques, de comparer des versions d'algorithmes et de reproduire des défaillances sans le robot. Quelques points demandent de l'attention : la lecture peut publier un topic d'horloge, et les nœuds doivent alors utiliser le temps simulé ; les transformations dynamiques comme statiques doivent être enregistrées ; les nœuds qui publieraient les mêmes topics que le bag ne doivent pas tourner pendant la lecture ; et les flux de capteurs à haute fréquence remplissent vite les disques. Pour l'apprentissage à grande échelle, les bags sont souvent convertis en formats conçus pour l'accès aléatoire et le chargement par lots, car l'organisation d'un bag est pensée pour l'enregistrement et la relecture séquentiels.

Pourquoi c'est important

Presque tous les robots fondés sur ROS dépendent de données enregistrées pour le débogage et le développement. Les bags permettent de reproduire ce que le robot a perçu et fait, de tester des modifications hors ligne sur de vraies données de capteurs et de constituer des jeux de données ; les enregistrer, les rejouer et les convertir relève donc de la pratique ROS de base.

Applications principales

  • Débogage du comportement du robot en rejouant des données de capteurs enregistrées
  • Développement et réglage hors ligne de la perception, de la localisation et du SLAM
  • Tests de non-régression d'algorithmes sur des données réelles figées
  • Collecte de jeux de données de démonstrations et de capteurs pour l'apprentissage robotique
  • Journalisation sur le terrain pour l'analyse d'incidents
  • Partage de jeux de données de référence sous une forme native ROS

En pratique

Une équipe qui teste un robot mobile d'extérieur enregistre un bag à chaque sortie sur le terrain avec les balayages LiDAR, les images de caméra, les données IMU, l'odométrie des roues, les transformations et les commandes envoyées à la base, en découpant les fichiers toutes les quelques minutes et en les compressant. Quand la localisation du robot dérive pendant une sortie, un ingénieur, de retour au bureau, rejoue le bag en temps simulé, exécute un nœud de localisation modifié sur les topics de capteurs enregistrés en laissant de côté la sortie de localisation d'origine, et compare les deux trajectoires dans un outil de visualisation. Une fois le correctif validé sur plusieurs bags, ces bags deviennent des tests de non-régression en intégration continue. Pour entraîner un modèle de perception, l'équipe convertit des topics choisis en un format de jeu de données qui permet un accès aléatoire par image.

Idées reçues

  • rosbag est un outil ROS 2 — il est né dans ROS 1, et ROS 2 en fournit une version repensée, rosbag2, utilisée via la commande ros2 bag
  • Un bag rejoué se comporte comme le robot en fonctionnement — la lecture est en boucle ouverte, si bien que des nœuds modifiés ne peuvent pas influer sur les données de capteurs enregistrées ni sur le mouvement enregistré du robot
  • Enregistrer tous les topics est toujours le choix prudent — les images et nuages de points à haute fréquence remplissent vite le stockage et peuvent entraîner des pertes de messages, si bien que topics, compression et découpage doivent être choisis délibérément
  • Les fichiers bag sont un format de données d'entraînement prêt à l'emploi — ils sont conçus pour l'enregistrement et la relecture séquentiels, et l'apprentissage à grande échelle les convertit généralement en formats offrant un accès aléatoire efficace

Qui devrait le savoir

  • Développeurs ROS et ingénieurs logiciel en robotique
  • Ingénieurs en perception et en SLAM
  • Ingénieurs d'essais sur le terrain et de validation
  • Ingénieurs en apprentissage robotique qui constituent des jeux de données

Technologies associées

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

Termes associés

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

Projets associés

  • 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

Vidéos

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

Ce site nécessite JavaScript. Veuillez activer JavaScript pour explorer nos projets de robotique open source.