SUMO
Simulation of Urban MObility

- Home
- Download
- Documentation
- Wiki
- Trac
- Blog
- Contact
- SF-Project

# SUMO

# From 30.000 feet

SUMO is the simulation itself; it is a microscopic, space-continuous, and time-discrete traffic flow simulation.

  Purpose: Simulates a defined scenario
  System: portable (Linux/Windows is tested); runs on command line
  Input (mandatory):
    A) a road network as generated via NETCONVERT or NETGENERATE, see Building Networks
    B) a set of routes (as generated by DUAROUTER, JTRROUTER, DFROUTER, or ACTIVITYGEN, see also Definition of Vehicles, Vehicle Types, and Routes)
  Input (optional): Additional definitions of traffic lights, variable speed signs, output detectors etc.
  Output: SUMO allows to generate a wide set of outputs; visualization is done using SUMO-GUI
  Programming Language: c++

# Usage Description

## Options

You may use a XML schema definition file for setting up a SUMO configuration: sumoConfiguration.xsd.

### Configuration

Option | Default Value | Description
--- | --- | ---
-c <FILE> --configuration-file <FILE> |  | Loads the named config on startup
--save-configuration <FILE> |  | Saves current configuration into FILE
--save-template <FILE> |  | Saves a configuration template (empty) into FILE
--save-schema <FILE> |  | Saves the configuration schema into FILE
--save-commented <BOOL> | false | Adds comments to saved template, configuration, or schema

### Input

Option | Default Value | Description
--- | --- | ---
-n <FILE> --net-file <FILE> |  | Load road network description from FILE
-r <FILE> --route-files <FILE> |  | Load routes descriptions from FILE(s)
-a <FILE> --additional-files <FILE> |  | Load further descriptions from FILE(s)
-w <FILE> --weight-files <FILE> |  | Load edge/lane weights for online rerouting from FILE
-x <STRING> --weight-attribute <STRING> | traveltime | Name of the xml attribute which gives the edge weight

### Output

Option | Default Value | Description
--- | --- | ---
--netstate-dump <FILE> |  | Save complete network states into FILE
--netstate-dump.empty-edges <BOOL> | false | Write also empty edges completely when dumping
--emission-output <FILE> |  | Save the emission values of each vehicle
--fcd-output <FILE> |  | Save the Floating Car Data
--fcd-output.geo <BOOL> | false | Save the Floating Car Data using geo-coordinates (lon/lat)
--full-output <FILE> |  | Save a lot of information for each timestep (very redundant)
--queue-output <FILE> |  | Save the vehicle queues at the junctions (experimental)
--vtk-output <FILE> |  | Save complete vehicle positions in VTK Format (usage: /file/out will produce /file/out_$NR$.vtp files)
--summary-output <FILE> |  | Save aggregated vehicle departure info into FILE
--tripinfo-output <FILE> |  | Save single vehicle trip info into FILE
--vehroute-output <FILE> |  | Save single vehicle route info into FILE
--vehroute-output.exit-times <BOOL> | false | Write the exit times for all edges
--vehroute-output.last-route <BOOL> | false | Write the last route only
--vehroute-output.sorted <BOOL> | false | Sorts the output by departure time
--vehroute-output.write-unfinished <BOOL> | false | Write vehroute output for vehicles which have not arrived at simulation end

### Time

Option | Default Value | Description
--- | --- | ---
-b <TIME> --begin <TIME> | 0 | Defines the begin time; The simulation starts at this time
-e <TIME> --end <TIME> | -1 | Defines the end time; The simulation ends at this time
--step-length <TIME> | 1 | Defines the step duration

### Processing

Option | Default Value | Description
--- | --- | ---
-s <TIME> --route-steps <TIME> | 200 | Load routes for the next number of seconds ahead
--no-internal-links <BOOL> | false | Disable (junction) internal links
--ignore-accidents <BOOL> | false | Do not check whether accidents occure more deeply
--ignore-route-errors <BOOL> | false | Do not check whether routes are connected
--max-num-vehicles <INT> | -1 | Quit simulation if this number of vehicles is exceeded
--incremental-dua-step <INT> |  | Perform the simulation as a step in incremental DUA
--incremental-dua-base <INT> | 10 | Base value for incremental DUA
--scale <FLOAT> |  | Scale demand by the given factor (0..1)
--time-to-teleport <TIME> | 300 | Specify how long a vehicle may wait until being teleported, defaults to 300, non-positive values disable teleporting
--max-depart-delay <TIME> | -1 | How long vehicles wait for departure before being skipped, defaults to -1 which means vehicles are never skipped
--sloppy-insert <BOOL> | false | Whether insertion on an edge shall not be repeated in same step once failed.
--lanechange.allow-swap <BOOL> | false | Whether blocking vehicles trying to change lanes may be swapped.
--routing-algorithm <STRING> | dijkstra | Select among routing algorithms ['dijkstra', 'astar']
--routeDist.maxsize <INT> |  | Restrict the maximum size of route distributions

### Report

Option | Default Value | Description
--- | --- | ---
-v <BOOL> --verbose <BOOL> | false | Switches to verbose output
-p <BOOL> --print-options <BOOL> | false | Prints option values before processing
-? <BOOL> --help <BOOL> | false | Prints this screen
-V <BOOL> --version <BOOL> | false | Prints the current version
-X <BOOL> --xml-validation <BOOL> | false | Enable schema validation of XML inputs
-W <BOOL> --no-warnings <BOOL> | false | Disables output of warnings
-l <FILE> --log <FILE> |  | Writes all messages to FILE (implies verbose)
--message-log <FILE> |  | Writes all non-error messages to FILE (implies verbose)
--error-log <FILE> |  | Writes all warnings and errors to FILE
--no-duration-log <BOOL> | false | Disable performance reports for individual simulation steps
--no-step-log <BOOL> | false | Disable console output of current simulation step

### Routing

Option | Default Value | Description
--- | --- | ---
--device.rerouting.probability <FLOAT> | 0 | The probability for a vehicle to have a routing device
--device.rerouting.explicit <STRING> |  | Assign a device to named vehicles
--device.rerouting.deterministic <BOOL> | false | The devices are set deterministic using a fraction of 1000
--device.rerouting.period <TIME> | 0 | The period with which the vehicle shall be rerouted
--device.rerouting.pre-period <TIME> | 0 | The rerouting period before depart
--device.rerouting.adaptation-weight <FLOAT> | 0.5 | The weight of prior edge weights.
--device.rerouting.adaptation-interval <TIME> | 1 | The interval for updating the edge weights.
--device.rerouting.with-taz <BOOL> | false | Use zones (districts) as routing end points
--device.rerouting.init-with-loaded-weights <BOOL> | false | Use given weight files for initializing edge weights

### Emissions

Option | Default Value | Description
--- | --- | ---
--device.hbefa.probability <FLOAT> | 0 | The probability for a vehicle to have an emission logging device
--device.hbefa.explicit <STRING> |  | Assign a device to named vehicles
--device.hbefa.deterministic <BOOL> | false | The devices are set deterministic using a fraction of 1000

### Traci Server

Option | Default Value | Description
--- | --- | ---
--remote-port <INT> | 0 | Enables TraCI Server if set

### Random Number

Option | Default Value | Description
--- | --- | ---
--random <BOOL> | false | Initialises the random number generator with the current system time
--seed <INT> | 23423 | Initialises the random number generator with the given value

### Gui Only

Option | Default Value | Description
--- | --- | ---
--gui-settings-file <FILE> |  | Load visualisation settings from FILE
-Q <BOOL> --quit-on-end <BOOL> | false | Quits the GUI when the simulation stops
-G <BOOL> --game <BOOL> | false | Start the GUI in gaming mode
-S <BOOL> --start <BOOL> | false | Start the simulation after loading
-T <BOOL> --disable-textures <BOOL> | false | Do not load background pictures

# Subtopics

- Using additional Polygons and POIs within the Simulation

This page was last modified on 3 December 2012, at 20:53.