Skip to content

Quick Start#

Scenario simulator with Autoware Universe
This document contains step-by-step instruction on how to build and run AWF Autoware Core/Universe with scenario_simulator_v2.

Prerequisites#

  1. Ubuntu 22.04 machine
  2. ROS 2 Humble Hawksbill desktop version installed

How to build#

  1. Clone the Autoware Core/Universe repository:
    git clone git@github.com:autowarefoundation/autoware.git
    
  2. Navigate to the source directory:
    cd autoware 
    mkdir src 
    
  3. Import Autoware and Simulator dependencies:
    vcs import src < autoware.repos  
    vcs import src < simulator.repos
    
  4. Install dependencies for Autoware Core/Universe

    ./setup-dev-env.sh
    

  5. Install dependent ROS packages.

    source /opt/ros/humble/setup.bash
    rosdep install -iry --from-paths src --rosdistro $ROS_DISTRO
    

  6. Build the workspace.
    colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
    

How to run#

Preparation#

  1. Move to project directory, where the project is build.
    cd path/to/workspace
    
  2. Source the workspace setup script
    source install/setup.bash
    

Run the examples#

scenario_test_runner#

ros2 launch scenario_test_runner scenario_test_runner.launch.py \
architecture_type:=awf/universe \
record:=false \
scenario:='$(find-pkg-share scenario_test_runner)/scenario/sample.yaml' \
sensor_model:=sample_sensor_kit \
vehicle_model:=sample_vehicle

random_test_runner#

ros2 launch random_test_runner random_test.launch.py \
architecture_type:=awf/universe \
sensor_model:=sample_sensor_kit \
vehicle_model:=sample_vehicle

To modify parameters of random testing, please check documentation of random_test_runner

cpp scenario demo#

This demo does not use Autoware. the ego vehicle is interpreted as an NPC.

ros2 launch cpp_mock_scenarios mock_test.launch.py \
scenario:=traffic_simulation_demo \
launch_rviz:=true timeout:=60.0

Cpp Scenario Demo