🚀News:
- 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
LimSim is a Long-term Interactive Multi-scenario traffic Simulator, which aims to provide a continuous simulation capability under the complex urban road network.
Quick Start
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.
1. Real-time Sim
Real-time simulation following the Ego vehicle is the fundamental feature of LimSim. To experience it, run the following command:
python ModelExample.py
2. Simulation replay
In the root directory, running the following command will invoke LimSim’s replay feature:
python ReplayExample.py
For more information on our code, please see our Online Documentation.
If you have any problem when installing and deploying, feel free to open an issue here!
🎁 Main Features
🖥️ GUI
LimSim has a cross-platform user-friendly GUI, including a beautiful simulation interface, information on road networks, and ego-vehicle status.
🛣️ Multi-scenarios support
LimSim supports road scenarios not limited to freeways, signalized intersections, roundabouts, and overpasses.
📊 Scenario Evaluation
After running a long-term simulation with all kinds of scenarios contained in it, LimSim generates a log report and extracts the key scenarios via the evaluation results.
💡Co-sim with SUMO & CARLA
LimSim supports co-simulation with CARLA and SUMO, guaranteeing that all three softwares show identical vehicle status. Please see the docs for more information.
➕Additional Maps
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 the freewayB and Expressway_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
Acknowledgments
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 issues/PR or send emails to us ([email protected]).
Citation
If you use LimSim in your research, please use the following BibTeX entry.
@inproceedings{wen2023limsim,
title={LimSim: A long-term interactive multi-scenario traffic simulator},
author={Wen, Licheng and Fu, Daocheng and Mao, Song and Cai, Pinlong and Dou, Min and Li, Yikang and Qiao, Yu},
booktitle={IEEE 26th International Conference on Intelligent Transportation Systems (ITSC)},
pages={1255--1262},
year={2023}
}
License
LimSim is released under the GNU GPL v3.0 license.
评论