generated on 2019-02-18 00:17:40.418705 from the wiki page for Simulation/Output for SUMO git


SUMO allows to generate a large number of different measures. All write the values they collect into files or a socket connection following the common rules for writing files. Per default, all are disabled, and have to be triggered individually. Some of the available outputs (raw vehicle positions dump, trip information, vehicle routes information, and simulation state statistics) are triggered using command line options, the others have to be defined within additional-files.

Converting Outputs

All output files written by SUMO are in XML-format by default. However, with the python tool you can convert any of them to a flat-file (CSV) format which can be opened with most spread-sheet software. If you need a more compressed but still "standardized" binary version, you can use Furthermore all files can use a custom binary format which is triggered by the file extension .sbx.

Seperating outputs of repeated runs

To keep the outputs of multiple simulation runs seperate, the option --output-prefix <STRING> can be used to prefix all output file names. When setting --output-prefix TIME. all outputs will be prefixd using the time at which the simulation was started which keeps them seperated automatically.

Available Output Files

Below, the available outputs are listed, joined into groups of topic/aggregation type. Further information about each output can be found by following its link.

vehicle-based information, disaggregated

  • raw vehicle positions dump: all vehicle positions over time
    contains: positions and speeds for all vehicles for all simulated time steps
    used for: obtaining movements of nodes (V2V, for ns-2)
  • emission output: emission values of all vehicles for every simulation step
  • full output: various informations for all edges, lanes and vehicles (good for visualisation purposes)
  • vtk output: generates Files in the well known VTK (Visualization Toolkit) format, to show the positions the speed value for every vehicle
  • fcd output: Floating Car Data includes name, position, angle and type for every vehicle
  • trajectories output: Trajectory Data following includes name, position, speed and acceleration for every vehicle following the Amitran standard
  • lanechange output: Lane changing events with the associated motivation for changing for every vehicle
  • surrogate safety measures (SSM): Output of safety related measures, headway, brake rates, etc
  • vehicle type probe: positions of vehicles over time for a certain vehicle type (deprecated, use vType filters with FCD-output instead)

simulated detectors

values for edges or lanes

values for junctions

vehicle-based information

simulation(network)-based information

traffic lights-based information

Additional Debugging Outputs

  • The option --link-output <FILE> saves debugging data for the intersection model. This data reveals how long each vehicle intends to occupy an upcoming intersection.
  • The option --movereminder-output <FILE> saves debugging data for the interaction between vehicle devices, lanes and output facilities. It is only available when compiling SUMO with debug flags.
  • The option --railsignal-block-output <FILE> saves information about rail signal blocks. For each controlled railSignal link the following information is generated:
    • forwardBlock: all lanes that are reached from the signalized link in forward direction up to the next rail signal
    • bidiBlock: all lanes that make up the reverse-direction track encountered within the forward block and followed up to the next railSignal beyond a railway switch which allows passing
    • backwardBlock: all lanes that enter the forwardBlock or bidiBlock from outside followed upstream to the entry rail signal
    • conflictLinks: all controlled links that enter the conflict area (forwardBlock, bidiBlock, backwardBlock) from outside, encoded as <SIGNALID>_<LINKINDEX>

Commandline Output (verbose)

When running the simulation with option --verbose (short -v) the following data will be printed (unless explicitly disabled with option --duration-log false):

Vehicle Counts

  • Inserted: number vehicles that entered the simulation network
  • Loaded: number of vehicles that were loaded from route files. This may differ from emitted forw two reason:
    • Running with option --scale with a value less than 1.0
    • Having a congested network where not all vehicles could be inserted before the simulation time ended
  • Running: number of vehicles currently active in the network at simulation end
  • Waiting: number of vehicles which could not yet be inserted into the network due to congestion
  • Teleports: number of of times that vehicles were teleported for any of the following reasons (These reasons are given whenever a teleport warning is issued)
    • Collision: a vehicle violated its minGap requirement in relation to its leader vehicle
    • Timeout: a vehicle was unable to move for --time-to-teleport seconds (default 300)
      • wrong lane: a vehicle was unable to move because it could not continue its route on the current lane and was unable to change to the correct lane
      • yield: a vehicle was unable to cross an intersection where it did not have priority
      • jam: a vehicle could not continue because there was no space on the next lane

If the simulation contained persons the following output will be added:

  • Inserted: number of persons that were loaded from route files
  • Running: number of persons active in the network at simulation end
  • Jammed: number of times a person was jammed

Timing Data

  • Duration: The amount of elapsed time (as measure by a clock hanging on the wall) while computing the simulation.
  • "Real time factor": The quotient of simulated time / computation time. If one hour is simulated in 360 seconds the real time factor is 10.
  • UPS: (updates per second). The number of vehicles that were simulated on average per second of computation time.

If routing took place in the simulation, Each routing algorithm instance will report

  • The number of routing queries
  • The number of edges that were checked in order to find the best route
  • The total time spend routing and the average time per routing call

Aggregated Traffic Measures

When setting the option --duration-log.statistics, verbose output is automatically enabled (unless explicitly set to false) and the following averages for all vehicle trips will be printed:

  • RouteLength: average route length
  • Duration: average trip duration
  • WaitingTime: average time spent standing (involuntarily)
  • TimeLoss: average time lost due to driving slower than desired (includes WaitingTime). The desired speed takes the vehicles speedFactor into account.
  • DepartDelay: average time vehicle departures were delayed due to lack of road space
By default, only vehicles that have arrived are included in these statistics. If the option --tripinfo-output.write-unfinished is set, running vehicles will be included as well.

If the simulation contained pedestrians (walking persons) the following output will be added:

  • walks: the number of distinct <walk>-elements in the input
  • RouteLength: average walk length
  • Duration: average walk duration

If the simulation contained passengers (persons riding in vehicles) the following output will be added:

  • Rides: the number of distinct <ride>-elements in the input
  • Duration: average ride duration
  • Bus rides: number of rides with a public transport vehicle driving on roads (public transport is identified by having the line-attribute set).
  • Train rides number of rides with a public transport vehicle driving on rails
  • Bike rides: number of rides with vehicle class bicycle
  • Aborted rides: rides that could not be completed because no suitable vehicle was available

When setting this option and using SUMO-GUI, the network parameter dialog will also show a running average for these traffic measures (The dialog is accessible by right-clicking on the network background).