Difference between revisions of "SUMO"

From Sumo
Jump to navigation Jump to search
(Options)
Line 22: Line 22:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/>{{Option|--configuration-file {{DT_FILE}}}}
+
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/>
 +
{{Option|--configuration-file {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Loads the named config on startup
 
| valign="top" | Loads the named config on startup
Line 38: Line 39:
 
| valign="top" | Saves the configuration schema into FILE
 
| valign="top" | Saves the configuration schema into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-commented}}
+
| valign="top" | {{Option|--save-commented {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Adds comments to saved template, configuration, or schema
 
| valign="top" | Adds comments to saved template, configuration, or schema
Line 51: Line 52:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/>{{Option|--net-file {{DT_FILE}}}}
+
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/>
 +
{{Option|--net-file {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Load road network description from FILE
 
| valign="top" | Load road network description from FILE
 
|-
 
|-
| valign="top" | {{Option|-r {{DT_FILE}}}}<br/>{{Option|--route-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-r {{DT_FILE}}}}<br/>
 +
{{Option|--route-files {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Load routes descriptions from FILE(s)
 
| valign="top" | Load routes descriptions from FILE(s)
 
|-
 
|-
| valign="top" | {{Option|-a {{DT_FILE}}}}<br/>{{Option|--additional-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-a {{DT_FILE}}}}<br/>
 +
{{Option|--additional-files {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Load further descriptions from FILE(s)
 
| valign="top" | Load further descriptions from FILE(s)
 
|-
 
|-
| valign="top" | {{Option|-w {{DT_FILE}}}}<br/>{{Option|--weight-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-w {{DT_FILE}}}}<br/>
 +
{{Option|--weight-files {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Load edge/lane weights for online rerouting from FILE
 
| valign="top" | Load edge/lane weights for online rerouting from FILE
 
|-
 
|-
| valign="top" | {{Option|-x {{DT_STR}}}}<br/>{{Option|--weight-attribute {{DT_STR}}}}
+
| valign="top" | {{Option|-x {{DT_STR}}}}<br/>
 +
{{Option|--weight-attribute {{DT_STR}}}}
 
| valign="top" | traveltime
 
| valign="top" | traveltime
 
| valign="top" | Name of the xml attribute which gives the edge weight
 
| valign="top" | Name of the xml attribute which gives the edge weight
Line 84: Line 90:
 
| valign="top" | Save complete network states into FILE
 
| valign="top" | Save complete network states into FILE
 
|-
 
|-
| valign="top" | {{Option|--netstate-dump.empty-edges}}
+
| valign="top" | {{Option|--netstate-dump.empty-edges {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Write also empty edges completely when dumping
 
| valign="top" | Write also empty edges completely when dumping
Line 100: Line 106:
 
| valign="top" | Save single vehicle route info into FILE
 
| valign="top" | Save single vehicle route info into FILE
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.exit-times}}
+
| valign="top" | {{Option|--vehroute-output.exit-times {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Write the exit times for all edges
 
| valign="top" | Write the exit times for all edges
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.last-route}}
+
| valign="top" | {{Option|--vehroute-output.last-route {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Write the last route only
 
| valign="top" | Write the last route only
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.sorted}}
+
| valign="top" | {{Option|--vehroute-output.sorted {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Sorts the output by departure time
 
| valign="top" | Sorts the output by departure time
Line 121: Line 127:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-b {{DT_TIME}}}}<br/>{{Option|--begin {{DT_TIME}}}}
+
| valign="top" | {{Option|-b {{DT_TIME}}}}<br/>
 +
{{Option|--begin {{DT_TIME}}}}
 
| valign="top" | 0
 
| valign="top" | 0
 
| valign="top" | Defines the begin time; The simulation starts at this time
 
| valign="top" | Defines the begin time; The simulation starts at this time
 
|-
 
|-
| valign="top" | {{Option|-e {{DT_TIME}}}}<br/>{{Option|--end {{DT_TIME}}}}
+
| valign="top" | {{Option|-e {{DT_TIME}}}}<br/>
 +
{{Option|--end {{DT_TIME}}}}
 
| valign="top" | -1
 
| valign="top" | -1
 
| valign="top" | Defines the end time; The simulation ends at this time
 
| valign="top" | Defines the end time; The simulation ends at this time
Line 142: Line 150:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-s {{DT_INT}}}}<br/>{{Option|--route-steps {{DT_INT}}}}
+
| valign="top" | {{Option|-s {{DT_INT}}}}<br/>
 +
{{Option|--route-steps {{DT_INT}}}}
 
| valign="top" | 200
 
| valign="top" | 200
| valign="top" | Load routes for the next INT steps ahead
+
| valign="top" | Load routes for the next INT seconds ahead
 
|-
 
|-
| valign="top" | {{Option|--no-internal-links}}
+
| valign="top" | {{Option|--no-internal-links {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Disable (junction) internal links
 
| valign="top" | Disable (junction) internal links
 
|-
 
|-
| valign="top" | {{Option|--ignore-accidents}}
+
| valign="top" | {{Option|--ignore-accidents {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Do not check whether accidents occure more deeply
 
| valign="top" | Do not check whether accidents occure more deeply
 
|-
 
|-
| valign="top" | {{Option|--ignore-route-errors}}
+
| valign="top" | {{Option|--ignore-route-errors {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Do not check whether routes are connected
 
| valign="top" | Do not check whether routes are connected
Line 182: Line 191:
 
| valign="top" | How long vehicles wait for departure before being skipped, defaults to -1 which means vehicles are never skipped
 
| valign="top" | How long vehicles wait for departure before being skipped, defaults to -1 which means vehicles are never skipped
 
|-
 
|-
| valign="top" | {{Option|--sloppy-insert}}
+
| valign="top" | {{Option|--sloppy-insert {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Whether insertion on an edge shall not be repeated in same step once failed.
 
| valign="top" | Whether insertion on an edge shall not be repeated in same step once failed.
 
|-
 
|-
| valign="top" | {{Option|--lanechange.allow-swap}}
+
| valign="top" | {{Option|--lanechange.allow-swap {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Whether blocking vehicles trying to change lanes may be swapped.
 
| valign="top" | Whether blocking vehicles trying to change lanes may be swapped.
Line 199: Line 208:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-v}}<br/>{{Option|--verbose}}
+
| valign="top" | {{Option|-v {{DT_BOOL}}}}<br/>
 +
{{Option|--verbose {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Switches to verbose output
 
| valign="top" | Switches to verbose output
 
|-
 
|-
| valign="top" | {{Option|-p}}<br/>{{Option|--print-options}}
+
| valign="top" | {{Option|-p {{DT_BOOL}}}}<br/>
 +
{{Option|--print-options {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Prints option values before processing
 
| valign="top" | Prints option values before processing
 
|-
 
|-
| valign="top" | {{Option|-?}}<br/>{{Option|--help}}
+
| valign="top" | {{Option|-? {{DT_BOOL}}}}<br/>
| valign="top" | true
+
{{Option|--help {{DT_BOOL}}}}
 +
| valign="top" | false
 
| valign="top" | Prints this screen
 
| valign="top" | Prints this screen
 
|-
 
|-
| valign="top" | {{Option|-V }}<br/>{{Option|--version}}
+
| valign="top" | {{Option|-V {{DT_BOOL}}}}<br/>
 +
{{Option|--version {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Prints the current version
 
| valign="top" | Prints the current version
 
|-
 
|-
| valign="top" | {{Option|-W}}<br/>{{Option|--no-warnings}}
+
| valign="top" | {{Option|-W {{DT_BOOL}}}}<br/>
 +
{{Option|--no-warnings {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Disables output of warnings
 
| valign="top" | Disables output of warnings
 
|-
 
|-
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/>{{Option|--log {{DT_FILE}}}}
+
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/>
 +
{{Option|--log {{DT_FILE}}}}
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Writes all messages to FILE
 
| valign="top" | Writes all messages to FILE
Line 231: Line 246:
 
| valign="top" | Writes all warnings and errors to FILE
 
| valign="top" | Writes all warnings and errors to FILE
 
|-
 
|-
| valign="top" | {{Option|--no-duration-log}}
+
| valign="top" | {{Option|--no-duration-log {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Disable performance reports for individual simulation steps
 
| valign="top" | Disable performance reports for individual simulation steps
 
|-
 
|-
| valign="top" | {{Option|--no-step-log}}
+
| valign="top" | {{Option|--no-step-log {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Disable console output of current simulation step
 
| valign="top" | Disable console output of current simulation step
Line 256: Line 271:
 
| valign="top" | Assign a device to named vehicles
 
| valign="top" | Assign a device to named vehicles
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.deterministic}}
+
| valign="top" | {{Option|--device.rerouting.deterministic {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | The devices are set deterministic using a fraction of 1000
 
| valign="top" | The devices are set deterministic using a fraction of 1000
Line 276: Line 291:
 
| valign="top" | The interval for updating the edge weights.
 
| valign="top" | The interval for updating the edge weights.
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.with-taz}}
+
| valign="top" | {{Option|--device.rerouting.with-taz {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Use zones (districts) as routing end points
 
| valign="top" | Use zones (districts) as routing end points
Line 297: Line 312:
 
| valign="top" | Assign a device to named vehicles
 
| valign="top" | Assign a device to named vehicles
 
|-
 
|-
| valign="top" | {{Option|--device.hbefa.deterministic}}
+
| valign="top" | {{Option|--device.hbefa.deterministic {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | The devices are set deterministic using a fraction of 1000
 
| valign="top" | The devices are set deterministic using a fraction of 1000
Line 303: Line 318:
 
|}
 
|}
  
===TraCI Server===
+
===Traci Server===
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
Line 323: Line 338:
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--random}}
+
| valign="top" | {{Option|--random {{DT_BOOL}}}}
 
| valign="top" | false
 
| valign="top" | false
 
| valign="top" | Initialises the random number generator with the current system time
 
| valign="top" | Initialises the random number generator with the current system time
Line 333: Line 348:
 
|}
 
|}
  
===GUI Only===
+
===Gui Only===
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
Line 343: Line 358:
 
| valign="top" |  
 
| valign="top" |  
 
| valign="top" | Load visualisation settings from FILE
 
| valign="top" | Load visualisation settings from FILE
 +
|-
 +
| valign="top" | {{Option|-Q {{DT_BOOL}}}}<br/>
 +
{{Option|--quit-on-end {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Quits the GUI when the simulation stops
 +
|-
 +
| valign="top" | {{Option|-G {{DT_BOOL}}}}<br/>
 +
{{Option|--game {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Start the GUI in gaming mode
 +
|-
 +
| valign="top" | {{Option|-S {{DT_BOOL}}}}<br/>
 +
{{Option|--start {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Start the simulation after loading
 +
|-
 +
| valign="top" | {{Option|-T {{DT_BOOL}}}}<br/>
 +
{{Option|--disable-textures {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Do not load background pictures
 
|-
 
|-
 
|}
 
|}

Revision as of 08:54, 26 January 2012

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

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

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

--no-warnings <BOOL>

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

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