.. _rosbag_merger:

Merge Rosbags
=============

The Rosbag Merger is an utility to merge topics from one rosbag into another.
This is useful to e.g. merging image topics from a source rosbag into a rosbag of an simulation which lost the source images.

.. click:: cli:rosbag_merger_init
   :prog: rosbag_merger
   :nested: full

Prerequisites
-------------

#. You have to place rosbags which should be merged inside the ``as_ros/rosbags`` directory.

Usage
-----

#. Execute the rosbag merger utility (within the docker container, see :ref:`docker-exec-it-bash`), see explanation below and options below:

   .. code-block:: bash

      analyzer [MAIN_INPUT_ROSBAG] [MERGE_INPUT_ROSBAG]

   a. You may want to specify which topics to merge from the ``MERGE_INPUT_ROSBAG`` into the ``MAIN_INPUT_ROSBAG`` (``-t``).

   b. You may want to specify which suffix should be used for the merged rosbag (``-o``).