How To Run a Scenario or Test Case#

The following steps detail how to run the Vehicle Following scenario. This scenario and other example scenarios can be found on our examples page. These scenarios use the SVL Simulator Python API.

The SVL Simulator Python API is available on GitHub: https://github.com/lgsvl/PythonAPI

After cloning or downloading it from the git repository follow these steps:

  1. Run the following command to install Python files and necessary dependencies:

    pip3 install --user -e .

  2. Create and start an API Only simulation.

  3. Set environment variables LGSVL__SIMULATOR_HOST and LGSVL__AUTOPILOT_0_HOST

    • LGSVL__SIMULATOR_HOST is where the simulator will be run. The default value for this is "localhost" and does not need to be set if the simulator is running on the same machine that the Python script will be run from.
    • LGSVL__AUTOPILOT_0_HOST is where the AD stack will be run. This is relative to where the simulator is run. The default value is "localhost" which is the same machine as the simulator.
    • For example, if computer A will run the simulator and computer B will run the AD stack
      • LGSVL__SIMULATOR_HOST should be set to the IP of computer A
      • LGSVL__AUTOPILOT_0_HOST should be set to the IP of computer B
    • To set the variables for the current terminal window use
      export LGSVL__SIMULATOR_HOST=192.168.1.100
export LGSVL__AUTOPILOT_0_HOST=192.168.1.101

  4. Start your AD stack. The example scripts are written for Apollo 5.0. See below for how to edit the scripts to work with other AD stacks.

    • Select the MKZ as the vehicle SingleLaneRoad for the map
    • Start all modules and the bridge (if relevant)

  5. Run the script

    ./VF_S_25_Slow.py

  6. Set the destination for the AD stack. For this scenario, the destination is the end of the current lane.

  7. The AV should start driving forward towards the NPC. It should avoid crashing into the NPC.

How to Edit the EGO vehicle top#

In each of the example scenarios and test cases, there is a section that setups up the EGO vehicle:

If using a different AD stack, the vehicle type needs to be changed.

  • Change the agent name (orange string) to what is desired.
    • e.g. For Autoware it might be "Lexus2016RXHybrid (Autoware)"