- 2024/09/25 LimSimLight can parse OpenDrive map files and simulate by the new self-developed engine!
- 2024/03/05 LimSim++ is now released for the applications of Multimodal LLMs!
- 2023/07/26 Add the docs about co-sim with CARLA.
- 2023/07/13 The code is now released!
LimSim is a Long-term Interactive Multi-scenario traffic Simulator, which aims to provide a continuous simulation capability under the complex urban road network.
After configuring the runtime environment, download the LimSim source code to your local machine:
git clone https://github.com/PJLab-ADG/LimSim.git
Finally, you need to install the required Python extensions:
cd LimSim
pip install -r requirements.txt
Now, the local installation and deployment of LimSim are complete.
Real-time simulation following the Ego vehicle is the fundamental feature of LimSim. To experience it, run the following command:
python ModelExample.py
In the root directory, running the following command will invoke LimSim's replay feature:
python ReplayExample.py
For more information of our code, please see our Online Documentation.
If you have any problem when installing and deployment, feel free to open an issue here!
-
Long-term: Traffic flow can be generated over long periods under the guidance of demand and route planning.
-
Diversity: The built-in behavioral models take heterogeneous driving styles of vehicles into account.
-
Interactivity: Vehicles in the scenario area are controlled address sophisticated interactions among vehicles.
-
Multi-scenario: The universal road components supports a variety of road structures in the real world.
LimSim has a cross-platform user-friendly GUI, which includes not only a beautiful simulation interface, but also information on road network and ego-vehicle status.
LimSim supports road scenarios not limited to freeways, signalized intersections, roundabouts and overpasses.
After running a long-term simulation with all kinds of scenarios contained in it, LimSim generates a log report and extract the key scenarios via the evaluation results.
LimSim supports co-simulation with CARLA and SUMO, guaranteeing that all three softwares show identical vehicle status. Please see the docs for more information.
LimSim supports the freewayB
and Expressway_A
maps from the CitySim datasets. However, we have not included these two road network files in this library due to copyright.
To run these two maps, you need to:
- Go to CitySim Repo and submit the data access form.
- Get access to the dataset and download the
.net.xml
files in both thefreewayB
andExpressway_A
data folders. - Copy the road network files (.net.xml) to the relevant
networkFiles/CitySim
folder and ensure that your file paths are as follows:networkFiles/CitySim/freewayB/freewayB.net.xml networkFiles/CitySim/Expressway_A/Expressway_A.net.xml
We would like to thank the authors and developers of the following projects, this project is built upon these great projects.
If you have any suggestions or collaboration about this repo, feel free to create a issue/PR or send email to us ([email protected]).
If you use LimSim in your research , please use the following BibTeX entry.
@misc{wen2023limsim,
title={LimSim: A Long-term Interactive Multi-scenario Traffic Simulator},
author={Licheng Wen and Daocheng Fu and Song Mao and Pinlong Cai and Min Dou and Yikang Li and Yu Qiao},
year={2023},
eprint={2307.06648},
archivePrefix={arXiv},
primaryClass={eess.SY}
}
LimSim is released under the GNU GPL v3.0 license.