Welcome to SUMO2Unity Traffic Co-Simulation Tool

Explore the official SUMO2Unity guide on RoadwayVR
Workflow, setup tutorials, demonstrations, research papers, and common questions.

Introduction

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:

A User-Friendly Tool

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

Driver Perspective

Check out the quick 1 minute demo - Click to Play

Bicycle Perspective

Check out the quick 1 minute demo - Click to Play

3D Visualization Perspective

Check out the quick minutes demo - Click to Play

Check out the quick 2 minute demo - Click to Play

Getting Started

For a guided overview of the complete workflow, visit the official SUMO2Unity guide on RoadwayVR.

-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

Usage

• 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.

Additional Help

• Review the RoadwayVR SUMO2Unity guide for the workflow, setup sequence, demonstrations, research, and FAQs.
• If you need more help or have a technical question, create an issue in the SUMO2Unity issue tracker.

Paper

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.

License

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