SUMO

From Sumo
Revision as of 12:37, 25 November 2011 by Dkrajzew (talk | contribs) (Options)
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 NETGEN, 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 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 false Write also empty edges completely when dumping
--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 false Write the exit times for all edges
--vehroute-output.last-route false Write the last route only
--vehroute-output.sorted false Sorts the output by departure time

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 <INT>
--route-steps <INT>
200 Load routes for the next INT steps ahead
--no-internal-links false Disable (junction) internal links
--ignore-accidents false Do not check whether accidents occure more deeply
--ignore-route-errors 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 false Whether insertion on an edge shall not be repeated in same step once failed.
--lanechange.allow-swap false Whether blocking vehicles trying to change lanes may be swapped.

Report

Option Default Value Description
-v
--verbose
false Switches to verbose output
-p
--print-options
false Prints option values before processing
-?
--help
true Prints this screen
-V
--version
false Prints the current version
-W
--no-warnings
false Disables output of warnings
-l <FILE>
--log <FILE>
Writes all messages to FILE
--message-log <FILE> Writes all non-error messages to FILE
--error-log <FILE> Writes all warnings and errors to FILE
--no-duration-log false Disable performance reports for individual simulation steps
--no-step-log 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 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 false Use zones (districts) as routing end points

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

Subtopics