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

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. Cite SUMO in your publications as: Daniel Krajzewicz, Jakob Erdmann, Michael Behrisch, and Laura Bieker. "Recent Development and Applications of SUMO - Simulation of Urban MObility"; International Journal On Advances in Systems and Measurements, 5 (3&4):128-138, December 2012. (see [Krajzewicz et al 2012]).

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

=Introduction=
 * The traffic simulation SUMO

=Basic Usage=
 * Notation in this Documentation
 * Needed, basic Computer Skills
 * Installing SUMO
 * Using SUMO Command Line Applications
 * Tutorials

=Network Building=
 * Introduction to SUMO Road Networks
 * Abstract networks generation
 * Importing networks with NETCONVERT
 * Defining own networks using XML
 * Importing non-SUMO networks
 * ... from OpenStreetMap
 * ... from VISUM
 * ... from Vissim
 * ... from OpenDRIVE
 * ... from MATsim
 * ... from ArcView (shapefiles)
 * ... from Elmar's GDF
 * ... from Robocup Simulation League
 * Importing SUMO networks
 * Further NETCONVERT options
 * Additional output

=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
 * Importing O/D Matrices
 * Random Trips
 * Shortest or Optimal Path Routing
 * Routing by Turn Probabilities
 * Routes from Observation Points
 * Activity-based Demand Generation
 * Computing Dynamic User Assignment
 * Importing foreign demands
 * Other VISUM Demand Importers
 * Other Vissim Demand Importers
 * Routing in the Simulation

=Simulation=
 * Basic Definition
 * Traffic Management and Other Structures
 * Traffic Lights
 * Public Transport
 * Variable Speed Signs
 * Rerouter / Alternative Route Signage
 * Vaporizer
 * Simulation output
 * TraCI (On-line Interaction)
 * Shapes Visualisation
 * Common Problems
 * Why Vehicles are teleporting

=Theory=
 * Traffic simulations in general

=Appendices=
 * Glossary
 * FAQ
 * Additional Tools
 * Known File Extensions
 * Application Manuals
 * SUMO
 * SUMO-GUI
 * NETCONVERT
 * NETGENERATE
 * OD2TRIPS
 * DUAROUTER
 * JTRROUTER
 * DFROUTER
 * POLYCONVERT
 * ACTIVITYGEN
 * Tool Manuals
 * Tools/TraceExporter
 * ChangeLog

=Translations=
 * Persian SUMO tutorial on version 0.9.8; thanks to Omid Mohajerani
 * Persian tutorial on "Vehicular Adhoc Network Simulation With NS2, SUMO And MOVE";