Execute simulation runs defined by simple-scenario to efficiently develop scenario-based testing methods (e.g., selecting test scenarios or testing prototype automated driving systems).

💡 To recreate these videos use: examples/generate_simulation_run_videos.py.

examples/example_scenario0.json

Test scenario:

Simulation run:

Result: is_goal_reached

examples/example_scenario1.json

Test scenario:

Simulation run:

Result: is_standstill

examples/example_scenario2.json

Test scenario:

Simulation run:

Result: is_collision

To use or develop simple-simulation, you must first clone the repository.

$ git clone git@gitlab.ika.rwth-aachen.de:fb-fi/simulation/simple-simulation/simple-simulation.git
$ cd simple-simulation

It is recommended to use uv for package management. If you do not want to use uv, please consult the Without uv section.

Install requirements with

$ uv sync

To run a script, use

$ uv run /path/to/script.py

or directly use the python interpreter from the .venv folder in e.g. VSCode.

To run the tests, install the dev requirements with

$ uv sync --dev

and run the tests

$ uv run pytest

Install the project editable

$ python -m pip install -e .

To run the tests, first install pytest

$ python -m pip install pytest

and run

$ pytest

💡 You should first complete the Installation.

Run some simulations

1. Open the file test/test_challenger_a.py and run it by clicking on the run arrow in the top right corner.

2. There should be some videos in the folder test/test_results/challenger_a/.

You can watch them directly in VSCode.

The simple_simulation module consists of the following submodules:

• simulation_manager/: Main module handling all other modules to run the main simulation loop.
• pilots/: Pilots for the simulation actors. A pilot takes high-level decisions for lateral and longitudinal control for exactly one simulation actor based on the current situation in the simulation. Each pilot must be a subclass of Pilot in pilots/pilot.py. The logic contained in highway_pilot.py is roughly based on that of the l3pilot-aeb-adf.
• simulation_core/: The lightweight simulation core using CommonRoad vehicle models.

This package is developed as part of the Hi-Drive project.

The research leading to these results has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 101006664. The sole responsibility of this publication lies with the authors. The authors would like to thank all partners within the Hi-Drive project (hi-drive.eu) for their cooperation and valuable contribution.

Additional development is done within the SYNERGIES project.