From Sumo
Revision as of 11:12, 25 September 2013 by Behrisch (talk | contribs)
Jump to navigation Jump to search

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


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


Option 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> Adds comments to saved template, configuration, or schema; default: false


Option 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
--weight-attribute <STRING>
Name of the xml attribute which gives the edge weight; default: traveltime


Option Description
--netstate-dump <FILE> Save complete network states into FILE
--netstate-dump.empty-edges <BOOL> Write also empty edges completely when dumping; default: false
--emission-output <FILE> Save the emission values of each vehicle
--fcd-output <FILE> Save the Floating Car Data
--fcd-output.geo <BOOL> Save the Floating Car Data using geo-coordinates (lon/lat); default: false
--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> Write the exit times for all edges; default: false
--vehroute-output.last-route <BOOL> Write the last route only; default: false
--vehroute-output.sorted <BOOL> Sorts the output by departure time; default: false
--vehroute-output.write-unfinished <BOOL> Write vehroute output for vehicles which have not arrived at simulation end; default: false


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


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


Option Description
-v <BOOL>
--verbose <BOOL>
Switches to verbose output; default: false
-p <BOOL>
--print-options <BOOL>
Prints option values before processing; default: false
-? <BOOL>
--help <BOOL>
Prints this screen; default: false
--version <BOOL>
Prints the current version; default: false
--xml-validation <BOOL>
Enable schema validation of XML inputs; default: false
--no-warnings <BOOL>
Disables output of warnings; default: false
-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> Disable performance reports for individual simulation steps; default: false
--no-step-log <BOOL> Disable console output of current simulation step; default: false


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


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

Traci Server

Option Description
--remote-port <INT> Enables TraCI Server if set; default: 0

Random Number

Option Description
--random <BOOL> Initialises the random number generator with the current system time; default: false
--seed <INT> Initialises the random number generator with the given value; default: 23423

Gui Only

Option Description
--gui-settings-file <FILE> Load visualisation settings from FILE
--quit-on-end <BOOL>
Quits the GUI when the simulation stops; default: false
--game <BOOL>
Start the GUI in gaming mode; default: false
--start <BOOL>
Start the simulation after loading; default: false
--disable-textures <BOOL>
Do not load background pictures; default: false