Awesome

Installation

This repository utilizes Safebench and Scenic, we acknowledge and thank these projects for their contributions!

Check out the <a href="https://javyduck.github.io/chatscene">demo simulations</a>!

Recommended system: Ubuntu 20.04 or 22.04

1. Local Installation

Step 1: Setup conda environment

conda create -n chatscene python=3.8
conda activate chatscene

Step 2: Clone this git repo in an appropriate folder

git clone git@github.com:javyduck/ChatScene.git

Step 3: Enter the repo root folder and install the packages:

cd ChatScene
pip install -r requirements.txt
pip install -e .

Step 4: Install the Scenic package:

cd Scenic
python -m pip install -e .

Step 5: Download our CARLA_0.9.13 and extract it to your folder.

Step 6: Run sudo apt install libomp5 as per this git issue.

Step 7: Add the python API of CARLA to the PYTHONPATH environment variable. You can add the following commands to your ~/.bashrc:

export CARLA_ROOT={path/to/your/carla}
export PYTHONPATH=$PYTHONPATH:${CARLA_ROOT}/PythonAPI/carla/dist/carla-0.9.13-py3.8-linux-x86_64.egg
export PYTHONPATH=$PYTHONPATH:${CARLA_ROOT}/PythonAPI/carla/agents
export PYTHONPATH=$PYTHONPATH:${CARLA_ROOT}/PythonAPI/carla
export PYTHONPATH=$PYTHONPATH:${CARLA_ROOT}/PythonAPI

Then, do source ~/.bashrc to update the environment variable.

CARLA Setup

1. Desktop Users

Enter the CARLA root folder, launch the CARLA server and run our platform with

# Launch CARLA
./CarlaUE4.sh -prefernvidia -windowed -carla-port=2000

2. Remote Server Users

Enter the CARLA root folder, launch the CARLA server with headless mode, and run our platform with

# Launch CARLA
./CarlaUE4.sh -prefernvidia -RenderOffScreen -carla-port=2000

(Optional) You can also visualize the pygame window using TurboVNC. First, launch CARLA with headless mode, and run our platform on a virtual display.

# Launch CARLA
./CarlaUE4.sh -prefernvidia -RenderOffScreen -carla-port=2000

# Run a remote VNC-Xserver. This will create a virtual display "8".
/opt/TurboVNC/bin/vncserver :8 -noxstartup

You can use the TurboVNC client on your local machine to connect to the virtual display.

# Use the built-in SSH client of TurboVNC Viewer
/opt/TurboVNC/bin/vncviewer -via user@host localhost:n

# Or you can manually forward connections to the remote server by
ssh -L fp:localhost:5900+n user@host
# Open another terminal on local machine
/opt/TurboVNC/bin/vncviewer localhost::fp

where user@host is your remote server, fp is a free TCP port on the local machine, and n is the display port specified when you started the VNC server on the remote server ("8" in our example).

ChatScene

In ChatScene, we ensure a fair comparison with the baselines by using the same eight scenarios, sampling five behaviors for each scenario from the database. The corresponding generated comeplete Scenic files, with some modifications, have been provided in safebench/scenario/scenario_data/scenic_data (with some manual modifications to use the same fixed 10 routes for the ego agent to ensure fair comparison with the baselines).

The ego agent is controlled by a default RL model, while the surrounding adversarial agent is controlled by Scenic.

The agent configuration is provided in safebench/agent/config/adv_scenic.yaml. By default, it loads a pretrained RL model from Safebench-v1.

Modes in ChatScene:

1. train_scenario: Select the most challenging scenes for the same behavior under the same scenario.

   Configuration can be found in safebench/scenario/config/train_agent_scenic.yaml.

   The sample_num = 50, opt_step = 10, select_num = 2 settings in the file mean we sample 50 scenes and select the 2 most challenging ones for evaluation. The default setting is to choose scenes that lead to a collision of the ego agent and provide the lowest overall score. We optimize the range of parameters, like speed, every 10 steps based on collision statistics from previously sampled scenes.

   Example command for optimizing the scene:

   python scripts/run_train.py --agent_cfg=adv_scenic.yaml --scenario_cfg=train_scenario_scenic.yaml --mode train_scenario --scenario_id 1
   

   Use the following command if you are using a TurboVNC client on your local machine to connect to the virtual display:

   DISPLAY=:8 python scripts/run_train.py --agent_cfg=adv_scenic.yaml --scenario_cfg=train_scenario_scenic.yaml --mode train_scenario --scenario_id 1
   

   The IDs for the final selected scenes will be stored in safebench/scenario/scenario_data/scenic_data/scenario_1/scenario_1.json.

2. train_agent: Train the agent based on the selected challenging scenes:

   python scripts/run_train.py --agent_cfg=adv_scenic.yaml --scenario_cfg=train_agent_scenic.yaml --mode train_agent --scenario_id 1
   

   We have a total of 10 routes for each scenario. We use the first 8 for training and the last 2 for testing (route IDs: [0,1,2,3,4,5,6,7]). The configuration, including scenario_1.json, will train the agent based on the most challenging scenes (the ones leading to a collision of the ego agent).

3. eval: Evaluate the trained agent on the last 2 routes (route IDs: [8,9]), the test_epoch is for loading a finetuned model after a specific training epoch:

   python scripts/run_eval.py --agent_cfg=adv_scenic.yaml --scenario_cfg=eval_scenic.yaml --mode eval --scenario_id 1 --test_epoch -1
   

The -1 here is for loading our provided fine-tuned agent in each scenario based on our Scenic scenarios in safebench/agent/model_ckpt/adv_train/sac/scenic/scenario_1/model.sac.-001.torch.

Dynamic Mode

The above part ensures using the same scenario and routes for fair comparison with baselines. However, ChatScene can generate scenarios and scenes freely without any constraints. Simply provide a text description, such as "The ego vehicle is driving on a straight road; the adversarial pedestrian suddenly crosses the road from the right front and suddenly stops in front of the ego." is enough for the training. We are currently integrating our database with GPT-4o for generating more diverse scenarios based on our pre-built retrieval database, and will upload both soonly.

1. Please first install openai and sentence_transformers packages following the requirements.

2. Put your description under file retrieve/scenario_descriptions.txt

3. run python retrieve.py to get the corresponding scenic code under safebench/scenario/scenario_data/scenic_data/dynamic_scenario

4. Then, for running the dynamic scenarios, just replace the run_train.py or run_eval.py with run_train_dynamic.py or run_eval_dynamic.py, and use dynamic_scenic.yaml (please specify your settings there), an exmaple could be:

   python scripts/run_train_dynamic.py --agent_cfg=adv_scenic.yaml --scenario_cfg=dynamic_scenic.yaml --mode train_scenario
   

• Integrate GPT-4o with our retrieval database (v1) and commit to the dynamic mode. Some mechanisms have been changed based on the previous version to incorporate more adversarial behavior, geometry, and spawn point definitions. Currently, it is still in beta. If you encounter any problems, please submit an issue, and I will address potential errors in the new retrieval pipeline.
• Some snippets are still under cleaning of the updated framework (i.e., incorprating GPT-4o to generate more diverse scenarios), the new retrieve database v2 will be pushed based on the new design.
• Finetune an LLM for generating snippets end-to-end based on the data constructed from our database.

If you have any questions, please open an issue or email jiaweiz7@illinois.edu. We aim to resolve your issues as soon as possible!

Citation

@inproceedings{zhang2024chatscene,
  title={ChatScene: Knowledge-Enabled Safety-Critical Scenario Generation for Autonomous Vehicles},
  author={Zhang, Jiawei and Xu, Chejian and Li, Bo},
  booktitle={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition},
  pages={15459--15469},
  year={2024}
}