SUMO
From Sumo
Contents |
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 |
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 |
| --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 |
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 |
| --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 |
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 |
Routing
| 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 |
Emissions
| 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 |
| -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
This page was last modified on 21 August 2013, at 15:31.