Scenic is designed to be easily interfaced to any simulator (see Interfacing to New Simulators). On this page we list interfaces that we and others have developed; if you have a new interface, let us know and we’ll list it here!
Our interface to the CARLA simulator enables using Scenic to describe autonomous driving scenarios.
The interface supports dynamic scenarios written using the CARLA world model (
scenic.simulators.carla.model) as well as scenarios using the cross-platform Driving Domain.
To use the interface, please follow these instructions:
Install the latest version of CARLA (we’ve tested versions 0.9.9, 0.9.10, and 0.9.11) from the CARLA Release Page.
Install Scenic in your Python virtual environment as instructed in Getting Started with Scenic.
Within the same virtual environment, install CARLA’s Python API by executing the following command:
$ easy_install /PATH_TO_CARLA_FOLDER/PythonAPI/carla/dist/carla-0.9.9-py3.7-linux-x86_64.egg
The exact name of the
.egg file may vary depending on the version of CARLA you installed; make sure to use the file for Python 3, not 2.
You may get an error message saying
Could not find suitable distribution, which you can ignore.
Instead, check that the
carla package was correctly installed by running pip show carla.
To start CARLA, run the command ./CarlaUE4.sh in your CARLA folder. Once CARLA is running, you can run dynamic Scenic scenarios following the instructions in the dynamics tutorial.
If you are using Scenic 1.x, there is an older CARLA interface which works with static Scenic scenarios and so requires agent behaviors to be written in plain Python. This interface is part of the VerifAI toolkit; documentation and examples can be found in the VerifAI repository.
The interface to Grand Theft Auto V, used in our PLDI paper, allows Scenic to position cars within the game as well as to control the time of day and weather conditions.
Many examples using the interface (including all scenarios from the paper) can be found in
See the paper and
scenic.simulators.gta for documentation.
Importing scenes into GTA V and capturing rendered images requires a GTA V plugin, which you can find here.
We have developed an interface to the LGSVL simulator for autonomous driving, used in our ITSC 2020 paper.
The interface supports dynamic scenarios written using the LGSVL world model (
scenic.simulators.lgsvl.model) as well as scenarios using the cross-platform Driving Domain.
To use the interface, first install the simulator from the LGSVL Simulator website. Then, within the Python virtual environment where you installed Scenic, install LGSVL’s Python API package from source.
An example of how to run a dynamic Scenic scenario in LGSVL is given in Dynamic Scenarios.
We have several interfaces to the Webots robotics simulator, for different use cases.
An interface for the Mars rover example used in our PLDI paper. This interface is extremely simple and might be a good baseline for developing your own interface. See the examples in
examples/webots/marsand the documentation of
A general interface for traffic scenarios, used in our VerifAI paper. Examples using this interface can be found in the VerifAI repository; see also the documentation of
A more specific interface for traffic scenarios at intersections, using guideways from the Intelligent Intersections Toolkit. See the examples in
examples/webots/guidewaysand the documentation of
Our interfaces were written for the R2018 version of Webots, which is not free but has lower hardware requirements than R2019. Relatively minor changes would be required to make our interfaces work with the newer open source versions of Webots. We may get around to porting them eventually; we’d also gladly accept a pull request!