SUMO User Documentation

"Simulation of Urban MObility" (SUMO) is an open source, highly portable, microscopic and continuous traffic simulation package designed to handle large networks. It allows for intermodal simulation including pedestrians and comes with a large set of tools for scenario creation. It is mainly developed by employees of the Institute of Transportation Systems at the German Aerospace Center. SUMO is licensed under the EPL 2.0. The source code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the EPL 2.0 are satisfied: GPL2 or later.

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.


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.

The content of this Documentation is freely editable. In order to edit a certain page, click on the "Edit on GitHub" button on the upper right corner and submit a Pull Request. Here is a short help on editing articles. You can also Build the documentation locally, or Download a copy.

This Documentation is continuously updated and always refers to the latest development version. Documentation for a specific release version of SUMO is included in the download of that version and can be viewed by opening <SUMO_HOME>/docs/userdoc/index.html.


Basic Usage#

Network Building#

Demand Modelling#

Data sources for demand generation#



TraCI (On-line Interaction)#

Traffic Management and Other Structures#

Traffic Modes#

Additional Features#

Model details#

Common Problems#

Additional Tools#

In addition to the main applications (sumo, sumo-gui, netedit, 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.

For an index of all tools see:

Below are links to some of the most important/used tools:

  • osmWebWizard - create a simple scenario, in just a few clicks and using your web browser
  • Interfacing TraCI from Python - access a running SUMO simulation using Python
  • sumolib - Python modules for working with SUMO networks and sumo xml files in general
  • Xml Tools - tools for converting SUMO outputs to CSV/Spreadsheet, and vice versa
  • - export mobility traces (FCD output) into different "trace file" formats
  • - determine the differences between two networks
  • Visualization Tools - visualize a wide range of simulation outputs in a graphical and friendly way


Application Manuals#

Software Contributions#

Some people extended SUMO or built tools to make it more usable. Not all of these extensions are part of the "SUMO core".