DUAROUTER
Contents |
From 30.000 feet
DUAROUTER imports different demand definitions, computes vehicle routes that may be used by SUMO using shortest path computation; When called iteratively DUAROUTER performs dynamic user assignment (DUA). This is facilitated by the tool <SUMO_HOME>/tools/assign/duaiterate.py which converges to an equilibrium state (DUE).
- Purpose:
- A) Building vehicle routes from demand definitions
- B) Computing routes during a user assignment
- C) Reparing connectivity problems in existing route files
- 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 demand definition, see Demand Modelling
- Output: Definition of Vehicles, Vehicle Types, and Routes usable by SUMO
- Programming Language: c++
Usage Description
Options
You may use a XML schema definition file for setting up a DUAROUTER configuration: duarouterConfiguration.xsd.
Configuration
All applications of the SUMO-suite handle configuration options the same way. These options are discussed at Basics/Using the Command Line Applications#Configuration Files.
| 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 | Adds comments to saved template, configuration, or schema; default: false |
Input
| Option | Description |
|---|---|
| -n <FILE> --net-file <FILE> | Use FILE as SUMO-network to route on |
| -d <FILE> --taz-files <FILE> | Read (additional) districts from FILE |
| -a <FILE> --alternative-files <FILE> | Read alternatives from FILE |
| -f <FILE> --flow-files <FILE> | Read flow-definitions from FILE(s) |
| -w <FILE> --weight-files <FILE> | Read network weights from FILE(s) |
| --lane-weight-files <FILE> | Read lane-based network weights from FILE(s) |
| -x <STRING> --weight-attribute <STRING> | Name of the xml attribute which gives the edge weight; default: traveltime |
| -t <FILE> --trip-files <FILE> | Read trip-definitions from FILE(s) |
| -r <FILE> --route-files <FILE> | Read sumo-routes from FILE(s) |
Output
| Option | Description |
|---|---|
| -o <FILE> --output-file <FILE> | Write generated routes to FILE |
| --exit-times | Write exit times (weights) for each edge; default: false |
Processing
| Option | Description |
|---|---|
| --ignore-errors | Continue if a route could not be build; default: false |
| --unsorted-input | Assume input is unsorted; default: false |
| --randomize-flows | generate random departure times for flow input; default: false |
| --max-alternatives <INT> | Prune the number of alternatives to INT; default: 5 |
| --remove-loops | Remove loops within the route; Remove turnarounds at start and end of the route; default: false |
| --repair | Tries to correct a false route; default: false |
| --weights.interpolate | Interpolate edge weights at interval boundaries; default: false |
| --with-taz | Use origin and destination zones (districts) for in- and output; default: false |
| --weights.expand | Expand weights behind the simulation's end; default: false |
| --gawron.beta <FLOAT> | Use FLOAT as Gawron's beta; default: 0.3 |
| --gawron.a <FLOAT> | Use FLOAT as Gawron's a; default: 0.05 |
| --keep-all-routes | Save routes with near zero probability; default: false |
| --skip-new-routes | Only reuse routes from input, do not calculate new ones; default: false |
| --logit | Use c-logit model; default: false |
| --logit.beta <FLOAT> | Use FLOAT as logit's beta; default: 0.15 |
| --logit.gamma <FLOAT> | Use FLOAT as logit's gamma; default: 1 |
Defaults
| Option | Description |
|---|---|
| --departlane <STRING> | Assigns a default depart lane |
| --departpos <STRING> | Assigns a default depart position |
| --departspeed <STRING> | Assigns a default depart speed |
| --arrivallane <STRING> | Assigns a default arrival lane |
| --arrivalpos <STRING> | Assigns a default arrival position |
| --arrivalspeed <STRING> | Assigns a default arrival speed |
| --defaults-override | Defaults will override given values; default: false |
Time
| Option | Description |
|---|---|
| -b <TIME> --begin <TIME> | Defines the begin time; Previous trips will be discarded; default: 0 |
| -e <TIME> --end <TIME> | Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent; default: 2147483 |
Report
All applications of the SUMO-suite handle most of the reporting options the same way. These options are discussed at Basics/Using the Command Line Applications#Reporting Options.
| Option | Description |
|---|---|
| -v --verbose | Switches to verbose output; default: false |
| -p --print-options | Prints option values before processing; default: false |
| -? --help | Prints this screen; default: false |
| -V --version | Prints the current version; default: false |
| -W --no-warnings | Disables output of warnings; default: false |
| -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 |
| --stats-period <INT> | Defines how often statistics shall be printed; default: -1 |
Random Number
All applications of the SUMO-suite handle randomisation options the same way. These options are discussed at Basics/Using the Command Line Applications#Random Number Options.
| Option | Description |
|---|---|
| --random | 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 |
This page was last modified on 26 March 2013, at 20:34.