Tools can be found in the SUMO-distribution under <SUMO_HOME>/tools. Most of them are tiny - they were written for a certain purpose and worked well under certain input, but may be not verified for other cases. Please note that we are currently restructuring the tools, see Most of the tools will be moved directly into the <SUMO_HOME>/tools dir, while obsolete scripts will move to <SUMO_HOME>/tools/purgatory.

The tools are divided into the following topics:

  • assign - traffic assignment tools
  • build - tools used for code styling and by the building subsystems
  • detector - some tools for dealing with real life induction loop data
  • turn-data - some tools with turning counts and turning ratio data with real life induction loop data
  • district - tools for handling traffic analysis zones (TAZ) aka districts
  • import - allow to import data from formats which can not be processed "natively"
    • osm - some helpers for accessing/using OpenStreetMap data
    • visum - some helpers for using VISUM data
    • vissim - some helpers for using VISSIM data
    • MATSim - some helpers for using MATSim data
  • net - tools for working with networks (mainly SUMO-networks)
  • projects - additional tools used by our projects
  • route - tools for working with routes
  • shapes - tools for working with shapes (PoIs and polygons)
  • tls - tools for traffic light systems
  • traci - Python implementation of the TraCI interface
  • traceExporter - generate mobility traces / trajectories / orbits / gps tracks in various formats
  • trip - Trip generation and modification without od2trips
  • visualization - graphical evaluation of SUMO-outputs
  • sumolib - python library for working with sumo networks, simulation output and miscellaneous utility functions
  • output - python tools for working with sumo output files
  • emissions - tools for computing and visualizing emissions
  • xml - python tools for converting xml and xml schema related utilities
  • miscellaneous - tools that do not fit the above categories


Most tools were written for Python 2.7 and still require this version. With the exception of sumolib and traci, Python 3.0 compatibility is not assured. We are still working on it.