Documentation

"Simulation of Urban MObility" (SUMO) is an open source, highly portable, microscopic road traffic simulation package designed to handle large road networks. It is mainly developed by employees of the Institute of Transportation Systems at the German Aerospace Center. SUMO is licensed under the EPL.

Please use the mailing lists for sharing your results or for asking questions. Answers to some common questions may also be found in the FAQ.

If You use SUMO, please tell us about your Publications.

Note

When citing SUMO in general please use our current reference publication: "Microscopic Traffic Simulation using SUMO"; Pablo Alvarez Lopez, Michael Behrisch, Laura Bieker-Walz, Jakob Erdmann, Yun-Pang Flötteröd, Robert Hilbrich, Leonhard Lücken, Johannes Rummel, Peter Wagner, and Evamarie Wießner. IEEE Intelligent Transportation Systems Conference (ITSC), 2018.

Any help is appreciated - corrections and contributions to the documentation, submission of code, or other results.

Introduction#

Basic Usage#

Network Building#

Demand Modelling#

Data sources for demand generation#

Simulation#

Output#

TraCI (On-line Interaction)#

Traffic Management and Other Structures#

Traffic Modes#

Additional Features#

Model details#

Common Problems#

Additional Tools#

For an index of all tools see

In addition to the main applications (SUMO, SUMO-GUI, NETCONVERT, etc.), there are over 150 additional tools. They cover topics from traffic network analysis, demand generation, demand modification to output analysis. Most of them are written in python. All tools can be found in the SUMO-distribution under <SUMO_HOME>/tools.

Below are links to some of the most important tools:

Theory#

Application Manuals#

Appendices#