We observed traffic safety researchers invested considerable time, effort, and money in developing a co-simulation tool that integrated Traffic Simulation SUMO (Simulation of Urban MObility) and Unity Game Engine. Each study ‘re-invented the wheel’ and therefore sacrificed resources that could have been used to focus on the ultimate goal, i.e., improving safety. Sumo2Unity tool integrates Traffic Simulation SUMO (Simulation of Urban MObility) with Unity Game Engine. SUMO2Unity is an open-source project contains the following items:

1. It automatically import complex road network from SUMO to Unity;
2. Integrate SUMO and Unity. This included programming the data exchange between the trajectory coordinates (X, Y, Z) of the vehicles and the signal timing (phase and duration) every 0.10 seconds; and
3. Develop performance functions to evaluate the performance of the integration.

Sumo2Unity tool usecases:

1. 3D Enhanced Visualization of 2D SUMO Simulation including roads, trees, building, traffic light
2. VR/Simulator Human in the Loop Simulation Experiments including simulator car, simulator bicycle and scooter.

It only requires three steps:

You can run it without requiring any specific package. You only need SUMO and Unity which both are free tools.

Check out the quick 1 minute demo - Click to Play

Check out the quick 1 minute demo - Click to Play

Check out the quick minutes demo - Click to Play

Check out the quick 2 minute demo - Click to Play

-SUMO - Step by Step Tutorial Youtube Tutorial

1. Install SUMO (Version 1.22)
2. Set Up SUMO Environment Variables
3. Install Notepad ++
4. Watch SUMO Tutorial

-Unity - Step by Step Tutorial Youtube Tutorial

1. Install Unity HUB
2. Install Unity Editor. We recommend version 6000.0.53f1.
3. Install Visual Studio
4. Install Visual Studio Dependencies
5. Watch Unity VR Tutorial

-Sumo2Unity - Step by Step Tutorial Youtube Tutorial

1. Download this repository as a zip file.
2. Extract the zip file.
3. Add the extract file in Unity Hub and open it with version 6000.0.53f1.
4. Watch Sumo2Unity Tutorial

• Sumo2Unity has ability to create a very complex road network
• Sumo2Unity do not need any external tools to create road network
• Sumo2Unity does not contain pedestrians at the moment.

• If you need more help or have any questions, feel free to create a new issue at the Issues section.

If you use SUMO2Unity, please cite our papers.

Mohammadi, A., Park, P. Y., Nourinejad, M., Cherakkatil, M. S. B., & Park, H. S. (2024, June). SUMO2Unity: An Open-Source Traffic Co-Simulation Tool to Improve Road Safety. In 2024 IEEE Intelligent Vehicles Symposium (IV) (pp. 2523-2528). IEEE.

Mohammadi, A., Cherakkatil, M. S. B., Park, P. Y., Nourinejad, M., & Asgary, A. (2025). An Open-Source Virtual Reality Traffic Co-Simulation for Enhanced Traffic Safety Assessment. Applied Sciences, 15(17), 9351.

• SUMO2Unity codes are distributed under MIT License.
• SUMO2Unity assets are distributed under CC-BY License.