Additional Scripts
==================

Artery Development
------------------

You may only need to build **Artery** locally for syntax highlighting to work
correctly. Run:

.. code-block:: bash

   source configure.sh
   cd artery/
   source ./tools/setup/configure.sh
   ./tools/setup/build.py -b -c --config Debug --link

Video Generation Utility ``make_video.py``
------------------------------------------

This utility converts a sequence of rendered frames into a video file. It is
typically used to visualize simulation outputs generated by OpenCDA, for
example 3D or BEV perception results.

**Usage**

.. code-block:: bash

   python scripts/make_video.py [-h] [--framerate FRAMERATE] [--rotate ROTATE] [--pattern PATTERN] input_dir output_path

**Arguments**

- ``input_dir``: directory containing input image frames
- ``output_path``: path to the output video file, for example ``video.mp4``

**Options**

- ``--framerate``: frame rate in frames per second
- ``--rotate``: rotate frames counter-clockwise, valid values are ``90``,
  ``180``, ``270``
- ``--pattern``: filename pattern for the image sequence in glob format

**Example**

.. code-block:: bash

   python scripts/make_video.py \
     simulation_output/coperception/vis_3d/v2xp_datadump_town06_carla_2026_03_24_09_56_21 \
     simulation_output/coperception/v2xp_datadump_town06_carla_3d.mp4