Setup

Installation with ROS 2

Prerequisites

Install ROS2 following the installation instructions for your distribution $ROS_DISTRO.

Scenario execution supports the ROS 2 distributions Jazzy and Lyrical, both built and tested from the same source. Humble is supported by the 1.2 releases on the humble branch.

Installation as Debian package (recommended)

To install scenario execution together with all its libraries, run

sudo apt update && sudo apt install -y ros-$ROS_DISTRO-scenario-execution*

To install just the core packages of scenario execution, run

sudo apt update && sudo apt install -y ros-$ROS_DISTRO-scenario-execution ros-$ROS_DISTRO-scenario-execution-ros ros-$ROS_DISTRO-scenario-execution-rviz

Developer Installation (from source as ROS 2 workspace)

Clone the scenario execution repository

git clone https://github.com/cps-test-lab/scenario-execution.git

and install the necessary dependencies

rosdep install  --from-paths . --ignore-src
pip3 install -r requirements.txt

Now, build your workspace by running

colcon build

and source your installation by running

source /opt/ros/$ROS_DISTRO/setup.bash && source install/setup.bash

Installation with pip as standalone Python package

scenario_execution is available as standalone Python package. To install it using pip, run

pip install scenario-execution