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 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
This page was last modified on 25 November 2011, at 12:37.