sumo-rl
Reinforcement Learning environments for Traffic Signal Control with SUMO. Compatible with Gymnasium, PettingZoo, and popular RL libraries.
Science Score: 44.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.3%) to scientific vocabulary
Repository
Reinforcement Learning environments for Traffic Signal Control with SUMO. Compatible with Gymnasium, PettingZoo, and popular RL libraries.
Basic Info
- Host: GitHub
- Owner: frefolli
- License: mit
- Language: Python
- Default Branch: develop
- Homepage: https://lucasalegre.github.io/sumo-rl
- Size: 455 MB
Statistics
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 1
Metadata Files
README.md
SUMO-RL
SUMO-RL provides a simple interface to instantiate Reinforcement Learning (RL) environments with SUMO for Traffic Signal Control.
Goals of this repository: - Provide a simple interface to work with Reinforcement Learning for Traffic Signal Control using SUMO - Support Multiagent RL - Easy customisation: state and reward definitions are easily modifiable
Warning: here for some reason observation and state are synonyms.
Install
Install SUMO latest version:
bash
sudo add-apt-repository ppa:sumo/stable
sudo apt-get update
sudo apt-get install sumo sumo-tools sumo-doc
Don't forget to set SUMOHOME variable (default sumo installation path is /usr/share/sumo)
```bash
echo 'export SUMOHOME="/usr/share/sumo"' >> ~/.bashrc
source ~/.bashrc
Important: for a huge performance boost (~8x) with Libsumo, you can declare the variable:
bash
export LIBSUMOASTRACI=1
```
Notice that you will not be able to run with sumo-gui or with multiple simulations in parallel if this is active (more details).
Install SUMO-RL
Stable release version is available through pip
bash
pip install sumo-rl
Alternatively, you can install using the latest (unreleased) version
bash
git clone https://github.com/LucasAlegre/sumo-rl
cd sumo-rl
pip install -e .
Scenarios
CELORIA
Layout:
| Axis | From | To | | ---- | ---- | -- | | main | J2 | J16 | | side | J3 | J0 | | side | J6 | J8 | | side | J7 | J9 | | side | J12 | J13 | | side | J15 | J14 |
BREDA
Layout:
| Axis | From | To | | ---- | ---- | -- | | main | J0 | J3 | | side | J4 | J5 | | side | J6 | J7 |
Owner
- Name: Francesco Refolli
- Login: frefolli
- Kind: user
- Repositories: 18
- Profile: https://github.com/frefolli
Citation (CITATION.bib)
@misc{AlegreFrefolliSUMORL,
author = {Lucas N. Alegre, Francesco Refolli},
title = {{SUMO-RL}},
year = {2025},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/frefolli/sumo-rl}},
}
GitHub Events
Total
- Create event: 4
- Issues event: 33
- Release event: 1
- Delete event: 2
- Issue comment event: 1
- Push event: 133
Last Year
- Create event: 4
- Issues event: 33
- Release event: 1
- Delete event: 2
- Issue comment event: 1
- Push event: 133
Dependencies
- actions/checkout v4 composite
- actions/download-artifact v4 composite
- actions/setup-python v5 composite
- actions/upload-artifact v4 composite
- pypa/gh-action-pypi-publish release/v1 composite
- JamesIves/github-pages-deploy-action v4 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v2 composite
- actions/setup-python v2 composite
- actions/checkout v4 composite
- actions/setup-python v5 composite