Difference between revisions of "SUMO"

From Sumo
Jump to navigation Jump to search
Line 15: Line 15:
 
You may use a XML schema definition file for setting up a SUMO configuration: [http://sumo-sim.org/xsd/sumoConfiguration.xsd sumoConfiguration.xsd].
 
You may use a XML schema definition file for setting up a SUMO configuration: [http://sumo-sim.org/xsd/sumoConfiguration.xsd sumoConfiguration.xsd].
 
===Configuration===
 
===Configuration===
{| cellspacing="0" border="1" width="90%" align="center"                                                                                                                           
+
{| class="wikitable" style="width:90%"
|-                                                                                                                                                                                 
 
! style="background:#ddffdd;" valign="top" | Option                                                                                                                               
 
! style="background:#ddffdd;" valign="top" | Description                                                                                                                           
 
|-                                                                                                                                                                                 
 
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/> {{Option|--configuration-file {{DT_FILE}}}}                                                                                       
 
| valign="top" | Loads the named config on startup
 
 
|-
 
|-
| valign="top" | {{Option|--save-configuration {{DT_FILE}}}}
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
| valign="top" | Saves current configuration into FILE
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--save-template {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-c {{DT_FILE}}}}<br/> {{Option|--configuration-file {{DT_FILE}}}}
| valign="top" | Saves a configuration template (empty) into FILE
+
| style="vertical-align:top" | Loads the named config on startup
 
|-
 
|-
| valign="top" | {{Option|--save-schema {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--save-configuration {{DT_FILE}}}}
| valign="top" | Saves the configuration schema into FILE
+
| style="vertical-align:top" | Saves current configuration into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-commented {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--save-template {{DT_FILE}}}}
| valign="top" | Adds comments to saved template, configuration, or schema; ''default: false''
+
| style="vertical-align:top" | Saves a configuration template (empty) into FILE
 +
|-
 +
| style="vertical-align:top" | {{Option|--save-schema {{DT_FILE}}}}
 +
| style="vertical-align:top" | Saves the configuration schema into FILE
 +
|-
 +
| style="vertical-align:top" | {{Option|--save-commented {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Adds comments to saved template, configuration, or schema; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Input===
 
===Input===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/> {{Option|--net-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-n {{DT_FILE}}}}<br/> {{Option|--net-file {{DT_FILE}}}}
| valign="top" | Load road network description from FILE
+
| style="vertical-align:top" | Load road network description from FILE
 
|-
 
|-
| valign="top" | {{Option|-r {{DT_FILE}}}}<br/> {{Option|--route-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-r {{DT_FILE}}}}<br/> {{Option|--route-files {{DT_FILE}}}}
| valign="top" | Load routes descriptions from FILE(s)
+
| style="vertical-align:top" | Load routes descriptions from FILE(s)
 
|-
 
|-
| valign="top" | {{Option|-a {{DT_FILE}}}}<br/> {{Option|--additional-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-a {{DT_FILE}}}}<br/> {{Option|--additional-files {{DT_FILE}}}}
| valign="top" | Load further descriptions from FILE(s)
+
| style="vertical-align:top" | Load further descriptions from FILE(s)
 
|-
 
|-
| valign="top" | {{Option|-w {{DT_FILE}}}}<br/> {{Option|--weight-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-w {{DT_FILE}}}}<br/> {{Option|--weight-files {{DT_FILE}}}}
| valign="top" | Load edge/lane weights for online rerouting from FILE
+
| style="vertical-align:top" | Load edge/lane weights for online rerouting from FILE
 
|-
 
|-
| valign="top" | {{Option|-x {{DT_STR}}}}<br/> {{Option|--weight-attribute {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|-x {{DT_STR}}}}<br/> {{Option|--weight-attribute {{DT_STR}}}}
| valign="top" | Name of the xml attribute which gives the edge weight; ''default: traveltime''
+
| style="vertical-align:top" | Name of the xml attribute which gives the edge weight; ''default: '''traveltime'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--load-state {{DT_FILE}}}}
 +
| style="vertical-align:top" | Loads a network state from FILE
 +
|-
 +
| style="vertical-align:top" | {{Option|--load-state.offset {{DT_TIME}}}}
 +
| style="vertical-align:top" | Sets the time offset for vehicle segment exit times; ''default: '''0'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Output===
 
===Output===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 +
|-
 +
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
 +
! style="background:#ddffdd; vertical-align:top" | Description
 +
|-
 +
| style="vertical-align:top" | {{Option|--netstate-dump {{DT_FILE}}}}
 +
| style="vertical-align:top" | Save complete network states into FILE
 +
|-
 +
| style="vertical-align:top" | {{Option|--netstate-dump.empty-edges {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Write also empty edges completely when dumping; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--emission-output {{DT_FILE}}}}
 +
| style="vertical-align:top" | Save the emission values of each vehicle
 +
|-
 +
| style="vertical-align:top" | {{Option|--fcd-output {{DT_FILE}}}}
 +
| style="vertical-align:top" | Save the Floating Car Data
 +
|-
 +
| style="vertical-align:top" | {{Option|--fcd-output.geo {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Save the Floating Car Data using geo-coordinates (lon/lat); ''default: '''false'''''
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
| style="vertical-align:top" | {{Option|--fcd-output.signals {{DT_BOOL}}}}
! style="background:#ddffdd;" valign="top" | Description
+
| style="vertical-align:top" | Add the vehicle signal state to the FCD output (brake lights etc.); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--netstate-dump {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--full-output {{DT_FILE}}}}
| valign="top" | Save complete network states into FILE
+
| style="vertical-align:top" | Save a lot of information for each timestep (very redundant)
 
|-
 
|-
| valign="top" | {{Option|--netstate-dump.empty-edges {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--queue-output {{DT_FILE}}}}
| valign="top" | Write also empty edges completely when dumping; ''default: false''
+
| style="vertical-align:top" | Save the vehicle queues at the junctions (experimental)
 
|-
 
|-
| valign="top" | {{Option|--emission-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vtk-output {{DT_FILE}}}}
| valign="top" | Save the emission values of each vehicle
+
| style="vertical-align:top" | Save complete vehicle positions inclusive speed values in the VTK Format (usage: /path/out will produce /path/out_$TIMESTEP$.vtp files)
 
|-
 
|-
| valign="top" | {{Option|--fcd-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--summary-output {{DT_FILE}}}}
| valign="top" | Save the Floating Car Data
+
| style="vertical-align:top" | Save aggregated vehicle departure info into FILE
 
|-
 
|-
| valign="top" | {{Option|--fcd-output.geo {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tripinfo-output {{DT_FILE}}}}
| valign="top" | Save the Floating Car Data using geo-coordinates (lon/lat); ''default: false''
+
| style="vertical-align:top" | Save single vehicle trip info into FILE
 
|-
 
|-
| valign="top" | {{Option|--full-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vehroute-output {{DT_FILE}}}}
| valign="top" | Save a lot of information for each timestep (very redundant)
+
| style="vertical-align:top" | Save single vehicle route info into FILE
 
|-
 
|-
| valign="top" | {{Option|--queue-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vehroute-output.exit-times {{DT_BOOL}}}}
| valign="top" | Save the vehicle queues at the junctions (experimental)
+
| style="vertical-align:top" | Write the exit times for all edges; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--vtk-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vehroute-output.last-route {{DT_BOOL}}}}
| valign="top" | Save complete vehicle positions in VTK Format (usage: /file/out will produce /file/out_$NR$.vtp files)
+
| style="vertical-align:top" | Write the last route only; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--summary-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vehroute-output.sorted {{DT_BOOL}}}}
| valign="top" | Save aggregated vehicle departure info into FILE
+
| style="vertical-align:top" | Sorts the output by departure time; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tripinfo-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vehroute-output.write-unfinished {{DT_BOOL}}}}
| valign="top" | Save single vehicle trip info into FILE
+
| style="vertical-align:top" | Write vehroute output for vehicles which have not arrived at simulation end; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--link-output {{DT_FILE}}}}
| valign="top" | Save single vehicle route info into FILE
+
| style="vertical-align:top" | Save links states into FILE
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.exit-times {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--bt-output {{DT_FILE}}}}
| valign="top" | Write the exit times for all edges; ''default: false''
+
| style="vertical-align:top" | Save bt visibilities into FILE
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.last-route {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--save-state.times {{DT_INT[]}}}}
| valign="top" | Write the last route only; ''default: false''
+
| style="vertical-align:top" | Use INT[] as times at which a network state written
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.sorted {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--save-state.prefix {{DT_FILE}}}}
| valign="top" | Sorts the output by departure time; ''default: false''
+
| style="vertical-align:top" | Prefix for network states; ''default: '''state'''''
 
|-
 
|-
| valign="top" | {{Option|--vehroute-output.write-unfinished {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--save-state.files {{DT_FILE}}}}
| valign="top" | Write vehroute output for vehicles which have not arrived at simulation end; ''default: false''
+
| style="vertical-align:top" | Files for network states
 
|-
 
|-
 
|}
 
|}
  
 
===Time===
 
===Time===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-b {{DT_TIME}}}}<br/> {{Option|--begin {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|-b {{DT_TIME}}}}<br/> {{Option|--begin {{DT_TIME}}}}
| valign="top" | Defines the begin time; The simulation starts at this time; ''default: 0''
+
| style="vertical-align:top" | Defines the begin time; The simulation starts at this time; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|-e {{DT_TIME}}}}<br/> {{Option|--end {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|-e {{DT_TIME}}}}<br/> {{Option|--end {{DT_TIME}}}}
| valign="top" | Defines the end time; The simulation ends at this time; ''default: -1''
+
| style="vertical-align:top" | Defines the end time; The simulation ends at this time; ''default: '''-1'''''
 
|-
 
|-
| valign="top" | {{Option|--step-length {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--step-length {{DT_TIME}}}}
| valign="top" | Defines the step duration; ''default: 1''
+
| style="vertical-align:top" | Defines the step duration; ''default: '''1'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Processing===
 
===Processing===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-s {{DT_TIME}}}}<br/> {{Option|--route-steps {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|-s {{DT_TIME}}}}<br/> {{Option|--route-steps {{DT_TIME}}}}
| valign="top" | Load routes for the next number of seconds ahead; ''default: 200''
+
| style="vertical-align:top" | Load routes for the next number of seconds ahead; ''default: '''200'''''
 
|-
 
|-
| valign="top" | {{Option|--no-internal-links {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-internal-links {{DT_BOOL}}}}
| valign="top" | Disable (junction) internal links; ''default: false''
+
| style="vertical-align:top" | Disable (junction) internal links; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--ignore-accidents {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--ignore-accidents {{DT_BOOL}}}}
| valign="top" | Do not check whether accidents occure more deeply; ''default: false''
+
| style="vertical-align:top" | Do not check whether accidents occure more deeply; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--ignore-route-errors {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--ignore-route-errors {{DT_BOOL}}}}
| valign="top" | Do not check whether routes are connected; ''default: false''
+
| style="vertical-align:top" | Do not check whether routes are connected; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--max-num-vehicles {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--max-num-vehicles {{DT_INT}}}}
| valign="top" | Quit simulation if this number of vehicles is exceeded; ''default: -1''
+
| style="vertical-align:top" | Quit simulation if this number of vehicles is exceeded; ''default: '''-1'''''
 
|-
 
|-
| valign="top" | {{Option|--incremental-dua-step {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--incremental-dua-step {{DT_INT}}}}
| valign="top" | Perform the simulation as a step in incremental DUA
+
| style="vertical-align:top" | Perform the simulation as a step in incremental DUA
 
|-
 
|-
| valign="top" | {{Option|--incremental-dua-base {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--incremental-dua-base {{DT_INT}}}}
| valign="top" | Base value for incremental DUA; ''default: 10''
+
| style="vertical-align:top" | Base value for incremental DUA; ''default: '''10'''''
 
|-
 
|-
| valign="top" | {{Option|--scale {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--scale {{DT_FLOAT}}}}
| valign="top" | Scale demand by the given factor (0..1)
+
| style="vertical-align:top" | Scale demand by the given factor (0..1)
 
|-
 
|-
| valign="top" | {{Option|--time-to-teleport {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--time-to-teleport {{DT_TIME}}}}
| valign="top" | Specify how long a vehicle may wait until being teleported, defaults to 300, non-positive values disable teleporting; ''default: 300''
+
| style="vertical-align:top" | Specify how long a vehicle may wait until being teleported, defaults to 300, non-positive values disable teleporting; ''default: '''300'''''
 
|-
 
|-
| valign="top" | {{Option|--max-depart-delay {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--time-to-teleport.highways {{DT_TIME}}}}
| valign="top" | How long vehicles wait for departure before being skipped, defaults to -1 which means vehicles are never skipped; ''default: -1''
+
| style="vertical-align:top" | The teleport time on highways; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--sloppy-insert {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--max-depart-delay {{DT_TIME}}}}
| valign="top" | Whether insertion on an edge shall not be repeated in same step once failed; ''default: false''
+
| style="vertical-align:top" | How long vehicles wait for departure before being skipped, defaults to -1 which means vehicles are never skipped; ''default: '''-1'''''
 
|-
 
|-
| valign="top" | {{Option|--lanechange.allow-swap {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--sloppy-insert {{DT_BOOL}}}}
| valign="top" | Whether blocking vehicles trying to change lanes may be swapped; ''default: false''
+
| style="vertical-align:top" | Whether insertion on an edge shall not be repeated in same step once failed; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--routing-algorithm {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--eager-insert {{DT_BOOL}}}}
| valign="top" | Select among routing algorithms ['dijkstra', 'astar']; ''default: dijkstra''
+
| style="vertical-align:top" | Whether each vehicle is checked separately for insertion on an edge; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--routeDist.maxsize {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--lanechange.allow-swap {{DT_BOOL}}}}
| valign="top" | Restrict the maximum size of route distributions
+
| style="vertical-align:top" | Whether blocking vehicles trying to change lanes may be swapped; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--lanechange.duration {{DT_TIME}}}}
 +
| style="vertical-align:top" | Duration of a lane change maneuver (default 0); ''default: '''0'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--routing-algorithm {{DT_STR}}}}
 +
| style="vertical-align:top" | Select among routing algorithms ['dijkstra', 'astar']; ''default: '''dijkstra'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--routeDist.maxsize {{DT_INT}}}}
 +
| style="vertical-align:top" | Restrict the maximum size of route distributions
 
|-
 
|-
 
|}
 
|}
  
 
===Report===
 
===Report===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-v {{DT_BOOL}}}}<br/> {{Option|--verbose {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-v {{DT_BOOL}}}}<br/> {{Option|--verbose {{DT_BOOL}}}}
| valign="top" | Switches to verbose output; ''default: false''
+
| style="vertical-align:top" | Switches to verbose output; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-p {{DT_BOOL}}}}<br/> {{Option|--print-options {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-p {{DT_BOOL}}}}<br/> {{Option|--print-options {{DT_BOOL}}}}
| valign="top" | Prints option values before processing; ''default: false''
+
| style="vertical-align:top" | Prints option values before processing; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-? {{DT_BOOL}}}}<br/> {{Option|--help {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-? {{DT_BOOL}}}}<br/> {{Option|--help {{DT_BOOL}}}}
| valign="top" | Prints this screen; ''default: false''
+
| style="vertical-align:top" | Prints this screen; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-V {{DT_BOOL}}}}<br/> {{Option|--version {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-V {{DT_BOOL}}}}<br/> {{Option|--version {{DT_BOOL}}}}
| valign="top" | Prints the current version; ''default: false''
+
| style="vertical-align:top" | Prints the current version; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-X {{DT_BOOL}}}}<br/> {{Option|--xml-validation {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-X {{DT_BOOL}}}}<br/> {{Option|--xml-validation {{DT_BOOL}}}}
| valign="top" | Enable schema validation of XML inputs; ''default: false''
+
| style="vertical-align:top" | Enable schema validation of XML inputs; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-W {{DT_BOOL}}}}<br/> {{Option|--no-warnings {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-W {{DT_BOOL}}}}<br/> {{Option|--no-warnings {{DT_BOOL}}}}
| valign="top" | Disables output of warnings; ''default: false''
+
| style="vertical-align:top" | Disables output of warnings; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/> {{Option|--log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-l {{DT_FILE}}}}<br/> {{Option|--log {{DT_FILE}}}}
| valign="top" | Writes all messages to FILE (implies verbose)
+
| style="vertical-align:top" | Writes all messages to FILE (implies verbose)
 
|-
 
|-
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--message-log {{DT_FILE}}}}
| valign="top" | Writes all non-error messages to FILE (implies verbose)
+
| style="vertical-align:top" | Writes all non-error messages to FILE (implies verbose)
 
|-
 
|-
| valign="top" | {{Option|--error-log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--error-log {{DT_FILE}}}}
| valign="top" | Writes all warnings and errors to FILE
+
| style="vertical-align:top" | Writes all warnings and errors to FILE
 
|-
 
|-
| valign="top" | {{Option|--no-duration-log {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-duration-log {{DT_BOOL}}}}
| valign="top" | Disable performance reports for individual simulation steps; ''default: false''
+
| style="vertical-align:top" | Disable performance reports for individual simulation steps; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--no-step-log {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-step-log {{DT_BOOL}}}}
| valign="top" | Disable console output of current simulation step; ''default: false''
+
| style="vertical-align:top" | Disable console output of current simulation step; ''default: '''false'''''
 +
|-
 +
|}
 +
 
 +
===Emissions===
 +
{| class="wikitable" style="width:90%"
 +
|-
 +
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
 +
! style="background:#ddffdd; vertical-align:top" | Description
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.hbefa.probability {{DT_FLOAT}}}}
 +
| style="vertical-align:top" | The probability for a vehicle to have a 'hbefa' device; ''default: '''0'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.hbefa.explicit {{DT_STR}}}}
 +
| style="vertical-align:top" | Assign a 'hbefa' device to named vehicles
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.hbefa.deterministic {{DT_BOOL}}}}
 +
| style="vertical-align:top" | The 'hbefa' devices are set deterministic using a fraction of 1000; ''default: '''false'''''
 +
|-
 +
|}
 +
 
 +
===Communication===
 +
{| class="wikitable" style="width:90%"
 +
|-
 +
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
 +
! style="background:#ddffdd; vertical-align:top" | Description
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btreceiver.probability {{DT_FLOAT}}}}
 +
| style="vertical-align:top" | The probability for a vehicle to have a 'btreceiver' device; ''default: '''0'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btreceiver.explicit {{DT_STR}}}}
 +
| style="vertical-align:top" | Assign a 'btreceiver' device to named vehicles
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btreceiver.deterministic {{DT_BOOL}}}}
 +
| style="vertical-align:top" | The 'btreceiver' devices are set deterministic using a fraction of 1000; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btreceiver.range {{DT_FLOAT}}}}
 +
| style="vertical-align:top" | The range of the bt receiver; ''default: '''300'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btreceiver.all-recognitions {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Whether all recognition point shall be written; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btsender.probability {{DT_FLOAT}}}}
 +
| style="vertical-align:top" | The probability for a vehicle to have a 'btsender' device; ''default: '''0'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btsender.explicit {{DT_STR}}}}
 +
| style="vertical-align:top" | Assign a 'btsender' device to named vehicles
 +
|-
 +
| style="vertical-align:top" | {{Option|--device.btsender.deterministic {{DT_BOOL}}}}
 +
| style="vertical-align:top" | The 'btsender' devices are set deterministic using a fraction of 1000; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Routing===
 
===Routing===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.probability {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.probability {{DT_FLOAT}}}}
| valign="top" | The probability for a vehicle to have a routing device; ''default: 0''
+
| style="vertical-align:top" | The probability for a vehicle to have a 'rerouting' device; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.explicit {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.explicit {{DT_STR}}}}
| valign="top" | Assign a device to named vehicles
+
| style="vertical-align:top" | Assign a 'rerouting' device to named vehicles
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.deterministic {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.deterministic {{DT_BOOL}}}}
| valign="top" | The devices are set deterministic using a fraction of 1000; ''default: false''
+
| style="vertical-align:top" | The 'rerouting' devices are set deterministic using a fraction of 1000; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.period {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.period {{DT_TIME}}}}
| valign="top" | The period with which the vehicle shall be rerouted; ''default: 0''
+
| style="vertical-align:top" | The period with which the vehicle shall be rerouted; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.pre-period {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.pre-period {{DT_TIME}}}}
| valign="top" | The rerouting period before depart; ''default: 0''
+
| style="vertical-align:top" | The rerouting period before depart; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.adaptation-weight {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.adaptation-weight {{DT_FLOAT}}}}
| valign="top" | The weight of prior edge weights; ''default: 0.5''
+
| style="vertical-align:top" | The weight of prior edge weights; ''default: '''0.5'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.adaptation-interval {{DT_TIME}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.adaptation-interval {{DT_TIME}}}}
| valign="top" | The interval for updating the edge weights; ''default: 1''
+
| style="vertical-align:top" | The interval for updating the edge weights; ''default: '''1'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.with-taz {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.with-taz {{DT_BOOL}}}}
| valign="top" | Use zones (districts) as routing end points; ''default: false''
+
| style="vertical-align:top" | Use zones (districts) as routing end points; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--device.rerouting.init-with-loaded-weights {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--device.rerouting.init-with-loaded-weights {{DT_BOOL}}}}
| valign="top" | Use given weight files for initializing edge weights; ''default: false''
+
| style="vertical-align:top" | Use given weight files for initializing edge weights; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
===Emissions===
+
===Example Device===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
|-
 
! style="background:#ddffdd;" valign="top" | Option
 
! style="background:#ddffdd;" valign="top" | Description
 
 
|-
 
|-
| valign="top" | {{Option|--device.hbefa.probability {{DT_FLOAT}}}}
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
| valign="top" | The probability for a vehicle to have an emission logging device; ''default: 0''
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--device.hbefa.explicit {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--device.example.explicit {{DT_STR}}}}
| valign="top" | Assign a device to named vehicles
+
| style="vertical-align:top" | Assign a device to named vehicles
 
|-
 
|-
| valign="top" | {{Option|--device.hbefa.deterministic {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--device.example.parameter {{DT_FLOAT}}}}
| valign="top" | The devices are set deterministic using a fraction of 1000; ''default: false''
+
| style="vertical-align:top" | An exemplary parameter which can be used by all instances of the example device; ''default: '''0'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Traci Server===
 
===Traci Server===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--remote-port {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--remote-port {{DT_INT}}}}
| valign="top" | Enables TraCI Server if set; ''default: 0''
+
| style="vertical-align:top" | Enables TraCI Server if set; ''default: '''0'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Random Number===
 
===Random Number===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--random {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--random {{DT_BOOL}}}}
| valign="top" | Initialises the random number generator with the current system time; ''default: false''
+
| style="vertical-align:top" | Initialises the random number generator with the current system time; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--seed {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--seed {{DT_INT}}}}
| valign="top" | Initialises the random number generator with the given value; ''default: 23423''
+
| style="vertical-align:top" | Initialises the random number generator with the given value; ''default: '''23423'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Gui Only===
 
===Gui Only===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--gui-settings-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--gui-settings-file {{DT_FILE}}}}
| valign="top" | Load visualisation settings from FILE
+
| style="vertical-align:top" | Load visualisation settings from FILE
 
|-
 
|-
| valign="top" | {{Option|-Q {{DT_BOOL}}}}<br/> {{Option|--quit-on-end {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-Q {{DT_BOOL}}}}<br/> {{Option|--quit-on-end {{DT_BOOL}}}}
| valign="top" | Quits the GUI when the simulation stops; ''default: false''
+
| style="vertical-align:top" | Quits the GUI when the simulation stops; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-G {{DT_BOOL}}}}<br/> {{Option|--game {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-G {{DT_BOOL}}}}<br/> {{Option|--game {{DT_BOOL}}}}
| valign="top" | Start the GUI in gaming mode; ''default: false''
+
| style="vertical-align:top" | Start the GUI in gaming mode; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-S {{DT_BOOL}}}}<br/> {{Option|--start {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-S {{DT_BOOL}}}}<br/> {{Option|--start {{DT_BOOL}}}}
| valign="top" | Start the simulation after loading; ''default: false''
+
| style="vertical-align:top" | Start the simulation after loading; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-T {{DT_BOOL}}}}<br/> {{Option|--disable-textures {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-T {{DT_BOOL}}}}<br/> {{Option|--disable-textures {{DT_BOOL}}}}
| valign="top" | Do not load background pictures; ''default: false''
+
| style="vertical-align:top" | Do not load background pictures; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}

Revision as of 11:25, 25 September 2013

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

Input

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
-x <STRING>
--weight-attribute <STRING>
Name of the xml attribute which gives the edge weight; default: traveltime
--load-state <FILE> Loads a network state from FILE
--load-state.offset <TIME> Sets the time offset for vehicle segment exit times; default: 0

Output

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
--fcd-output.signals <BOOL> Add the vehicle signal state to the FCD output (brake lights etc.); 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 inclusive speed values in the VTK Format (usage: /path/out will produce /path/out_$TIMESTEP$.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
--link-output <FILE> Save links states into FILE
--bt-output <FILE> Save bt visibilities into FILE
--save-state.times {{DT_INT[]}} Use INT[] as times at which a network state written
--save-state.prefix <FILE> Prefix for network states; default: state
--save-state.files <FILE> Files for network states

Time

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

Processing

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
--time-to-teleport.highways <TIME> The teleport time on highways; default: 0
--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
--eager-insert <BOOL> Whether each vehicle is checked separately for insertion on an edge; default: false
--lanechange.allow-swap <BOOL> Whether blocking vehicles trying to change lanes may be swapped; default: false
--lanechange.duration <TIME> Duration of a lane change maneuver (default 0); default: 0
--routing-algorithm <STRING> Select among routing algorithms ['dijkstra', 'astar']; default: dijkstra
--routeDist.maxsize <INT> Restrict the maximum size of route distributions

Report

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
-V <BOOL>
--version <BOOL>
Prints the current version; default: false
-X <BOOL>
--xml-validation <BOOL>
Enable schema validation of XML inputs; default: false
-W <BOOL>
--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

Emissions

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

Communication

Option Description
--device.btreceiver.probability <FLOAT> The probability for a vehicle to have a 'btreceiver' device; default: 0
--device.btreceiver.explicit <STRING> Assign a 'btreceiver' device to named vehicles
--device.btreceiver.deterministic <BOOL> The 'btreceiver' devices are set deterministic using a fraction of 1000; default: false
--device.btreceiver.range <FLOAT> The range of the bt receiver; default: 300
--device.btreceiver.all-recognitions <BOOL> Whether all recognition point shall be written; default: false
--device.btsender.probability <FLOAT> The probability for a vehicle to have a 'btsender' device; default: 0
--device.btsender.explicit <STRING> Assign a 'btsender' device to named vehicles
--device.btsender.deterministic <BOOL> The 'btsender' devices are set deterministic using a fraction of 1000; default: false

Routing

Option Description
--device.rerouting.probability <FLOAT> The probability for a vehicle to have a 'rerouting' device; default: 0
--device.rerouting.explicit <STRING> Assign a 'rerouting' device to named vehicles
--device.rerouting.deterministic <BOOL> The 'rerouting' 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

Example Device

Option Description
--device.example.explicit <STRING> Assign a device to named vehicles
--device.example.parameter <FLOAT> An exemplary parameter which can be used by all instances of the example device; default: 0

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
-Q <BOOL>
--quit-on-end <BOOL>
Quits the GUI when the simulation stops; default: false
-G <BOOL>
--game <BOOL>
Start the GUI in gaming mode; default: false
-S <BOOL>
--start <BOOL>
Start the simulation after loading; default: false
-T <BOOL>
--disable-textures <BOOL>
Do not load background pictures; default: false

Subtopics