SUMO User 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.
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.
Contents
Introduction
Basic Usage
- Notation in this Documentation
- Needed, basic Computer Skills
- Installing SUMO
- Using SUMO Command Line Applications
- Tutorials
- Validating application inputs
Network Building
- Introduction to SUMO Road Networks
- Abstract networks generation
- Importing networks with NETCONVERT
- Creating and modifying networks with NETEDIT
- Including elevation data
- Geo-Coordinates
Demand Modelling
- Introduction to SUMO Demand Modelling
- Definition of Vehicles, Vehicle Types, and Routes
- Simulation of public transport
- Simulation of individual persons and trip chains
- Simulation of logistics
- Shortest or Optimal Path Routing
- Intermodal Routing
- Routing in the Simulation
- Computing Dynamic User Assignment
- Generating pedestrian traffic demand
- Generate a vehicle type distribution to model the fleet
Data sources for demand generation
- Importing O/D Matrices
- Routes from Observation Points
- Routing by Turn Probabilities
- Activity-based Demand Generation
- Random Trips
- Multi-modal random traffic
Simulation
Traffic Management and Other Structures
- Traffic Lights
- Public Transport
- Variable Speed Signs
- Rerouter / Alternative Route Signage
- Vaporizer (deprecated, use Calibrator instead)
- Dynamic calibration of flow and speed
- Parking areas
Traffic Modes
Additional Features
- Emissions
- Electric Vehicles
- Logistics
- Generic Parameters
- Shapes Visualisation
- Wireless Device Detection
- Emergency Vehicles
- Simple Platooning (Simpla)
Model details
- Vehicle speed
- Vehicle insertion
- Vehicle permissions (access restrictions)
- Intersection dynamics
- Randomness
- Routing and Re-routing
- Sublane Model
- Opposite Direction Driving
- Safety
- Mesoscopic model
Common Problems
- Why Vehicles are teleporting
- Unexpected jamming
- Unexpected lane-changing maneuvers?
- How to get high flows?
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:
- osmWebWizard
- TraCI/Interfacing_TraCI_from_Python
- Reading SUMO networks and outputs with Python (sumolib)
- Tools for converting SUMO outputs to CSV/Spreadsheet
- Exporting mobility Traces (traceExporter)
- Determining the differences between two networks
- Tools/Visualization
Theory
Application Manuals
- SUMO
- SUMO-GUI
- NETCONVERT
- NETEDIT
- NETGENERATE
- OD2TRIPS
- DUAROUTER
- JTRROUTER
- DFROUTER
- MAROUTER
- POLYCONVERT
- ACTIVITYGEN
- EMISSIONSMAP
- EMISSIONSDRIVINGCYCLE