rosbag
- 다른 이름: ROS bag, rosbag2, ros2 bag, bag file
- 카테고리: Software & tooling › Tools & formats
- 태그: ros, data-logging, datasets, debugging, robot-software
토픽의 타임스탬프가 있는 메시지를 기록하고 나중에 재생하기 위한 ROS 도구이자 파일 형식. ROS 2에서는 rosbag2가 ros2 bag 명령을 통해 제공한다.
정의
rosbag은 카메라 이미지, LiDAR 스캔, 관절 상태, 변환, 명령처럼 선택한 ROS 토픽에 발행되는 메시지를 타임스탬프 및 메시지 타입과 함께 bag이라는 파일에 기록한다. 같은 도구로 bag을 재생할 수 있으며, 메시지를 원래 토픽에 기록된 속도 그대로 또는 더 빠르거나 느리게 다시 발행하므로, 다른 노드는 로봇이 실제로 동작하는 것처럼 메시지를 받는다. bag은 토픽, 메시지 수, 길이를 확인할 수 있고, 선택한 토픽이나 시간 구간으로 필터링할 수 있으며, Python과 C++ 클라이언트 라이브러리를 통해 코드에서 직접 읽을 수 있다.
rosbag은 ROS 1에서 시작되었으며, 그곳에서는 rosbag record와 rosbag play가 .bag 형식을 쓰고 읽었다. ROS 2는 이를 rosbag2로 대체했는데, rosbag2는 ros2 bag 명령으로 사용하며 기록 로직을 교체 가능한 스토리지 백엔드와 분리한다. 초기 ROS 2 릴리스는 bag을 SQLite3 데이터베이스에 저장했고, 최근 릴리스는 기본값으로 MCAP을 쓴다. MCAP은 타임스탬프가 있는 멀티모달 로봇 데이터를 위해 설계된 개방형 컨테이너 형식이다. ROS 1과 ROS 2의 bag은 변환 도구가 있기는 하지만 서로 직접 호환되지 않는다. 기록 옵션에는 압축, 크기나 시간에 따른 파일 분할, 발행자에 맞추기 위한 서비스 품질(quality-of-service) 설정이 있다.
bag은 디버깅, 오프라인 개발, 데이터셋 생성을 위해 현장 데이터를 수집하는 일반적인 방법이다. bag을 재생하면 엔지니어는 동일한 입력으로 인식이나 추정 코드를 다시 실행하고, 알고리즘 버전을 비교하고, 로봇 없이 실패를 재현할 수 있다. 몇 가지는 주의가 필요하다. 재생 시 clock 토픽을 발행할 수 있으며, 그 경우 노드는 시뮬레이션 시간을 사용해야 한다. 동적 변환과 정적 변환을 모두 기록해야 한다. bag과 같은 토픽을 발행할 노드는 재생 중에 실행해서는 안 된다. 그리고 높은 주기의 센서 스트림은 디스크를 빠르게 채운다. 대규모 학습을 위해서는 bag을 임의 접근과 배치 로딩에 맞게 만들어진 형식으로 변환하는 경우가 많은데, bag의 구조는 순차적 기록과 재생을 위해 설계되었기 때문이다.
중요한 이유
거의 모든 ROS 기반 로봇은 디버깅과 개발을 위해 기록된 데이터에 의존한다. bag은 로봇이 무엇을 감지하고 무엇을 했는지 재현하고, 실제 센서 데이터로 변경 사항을 오프라인에서 시험하고, 데이터셋을 구축할 수 있게 해 준다. 따라서 bag을 기록, 재생, 변환하는 것은 ROS의 기본 작업이다.
주요 응용
- 기록된 센서 데이터를 재생하여 로봇 동작 디버깅
- 인식, 위치 추정, SLAM의 오프라인 개발과 튜닝
- 고정된 실제 데이터로 알고리즘의 회귀 테스트
- 로봇 학습을 위한 시연 및 센서 데이터셋 수집
- 사고 분석을 위한 현장 로깅
- ROS 네이티브 형태로 벤치마크 데이터셋 공유
실제 사례
실외 모바일 로봇을 시험하는 팀이 매 현장 주행마다 LiDAR 스캔, 카메라 이미지, IMU 데이터, 바퀴 오도메트리, 변환, 베이스에 보낸 명령을 bag으로 기록하며, 몇 분마다 파일을 분할하고 압축한다. 주행 중 로봇의 위치 추정이 드리프트하면, 사무실로 돌아온 엔지니어가 시뮬레이션 시간으로 bag을 재생하고, 원래의 위치 추정 출력은 빼고 기록된 센서 토픽에 수정한 위치 추정 노드를 실행한 뒤, 두 궤적을 시각화 도구에서 비교한다. 수정이 여러 bag에서 통하면 그 bag들은 지속적 통합의 회귀 테스트가 된다. 인식 모델을 학습시키기 위해 팀은 선택한 토픽을 프레임 단위 임의 접근이 가능한 데이터셋 형식으로 변환한다.
흔한 오해
- rosbag은 ROS 2 도구다 — ROS 1에서 시작되었으며, ROS 2는 재설계된 버전인 rosbag2를 ros2 bag 명령을 통해 제공한다
- 재생한 bag은 실제 로봇처럼 동작한다 — 재생은 개루프이므로, 변경된 노드가 기록된 센서 데이터나 로봇의 기록된 움직임에 영향을 줄 수 없다
- 모든 토픽을 기록하는 것이 항상 안전한 선택이다 — 높은 주기의 이미지와 점군은 저장 공간을 빠르게 채우고 메시지 누락을 일으킬 수 있으므로, 토픽, 압축, 분할은 신중하게 골라야 한다
- bag 파일은 바로 쓸 수 있는 학습 데이터 형식이다 — 순차적 기록과 재생을 위해 설계되었으며, 대규모 학습에서는 보통 효율적인 임의 접근이 가능한 형식으로 변환한다
알아야 할 사람
- ROS 개발자와 로봇 소프트웨어 엔지니어
- 인식 및 SLAM 엔지니어
- 현장 시험 및 검증 엔지니어
- 데이터셋을 구축하는 로봇 학습 엔지니어
관련 기술
- ROS 2
- rosbag2
- MCAP
- SQLite
- RViz
- tf2
관련 용어
관련 프로젝트
- 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
동영상
- Rosbags | ROS Tutorial for Beginners: ROBOMECHTRIX
- ROS2 Rosbag to Record Data And Playback Data: Kevin Wood | Robotics & AI