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
- 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 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
| 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> | 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> | traveltime | Name of the xml attribute which gives the edge weight |
| -t <FILE> --trip-files <FILE> | Read trip-definitions from FILE(s) | |
| -r <FILE> --route-files <FILE> | Read sumo-routes from FILE(s) |
Output
| Option | Default Value | Description |
|---|---|---|
| -o <FILE> --output-file <FILE> | Write generated routes to FILE | |
| --exit-times | false | Write exit times (weights) for each edge |
Processing
| Option | Default Value | Description |
|---|---|---|
| --ignore-errors | false | Continue if a route could not be build |
| --unsorted-input | false | Assume input is unsorted |
| --randomize-flows | false | generate random departure times for flow input |
| --max-alternatives <INT> | 5 | Prune the number of alternatives to INT |
| --remove-loops | false | Remove loops within the route; Remove turnarounds at start and end of the route |
| --repair | false | Tries to correct a false route |
| --weights.interpolate | false | Interpolate edge weights at interval boundaries |
| --with-taz | false | Use origin and destination zones (districts) for in- and output |
| --weights.expand | false | Expand weights behind the simulation's end |
| --gawron.beta <FLOAT> | 0.3 | Use FLOAT as Gawron's beta |
| --gawron.a <FLOAT> | 0.05 | Use FLOAT as Gawron's a |
| --keep-all-routes | false | Save routes with near zero probability |
| --skip-new-routes | false | Only reuse routes from input, do not calculate new ones |
| --logit | false | Use c-logit model |
| --logit.beta <FLOAT> | 0.15 | Use FLOAT as logit's beta |
| --logit.gamma <FLOAT> | 1 | Use FLOAT as logit's gamma |
Defaults
| Option | Default Value | 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 | false | Defaults will override given values |
Time
| Option | Default Value | Description |
|---|---|---|
| -b <TIME> --begin <TIME> | 0 | Defines the begin time; Previous trips will be discarded |
| -e <TIME> --end <TIME> | 2147483 | Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent |
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 | |
| --stats-period <INT> | -1 | Defines how often statistics shall be printed |
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 |
This page was last modified on 25 November 2011, at 12:36.