MAROUTER
generated on 2017-12-19 09:15:31.806666 from the wiki page for MAROUTER for SUMO 0.32.0
Contents
From 30.000 feet
MAROUTER computes a macroscopic user assignment (routes) to be loaded into SUMO from various inputs (Origin-Destination-Matrices, trip files or route files).
- Purpose: Macroscopic route assignment
- 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) O/D matrix
- 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 MAROUTER configuration: marouterConfiguration.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> |
Use FILE as SUMO-network to route on |
| -d <FILE> --additional-files <FILE> |
Read additional network data (districts, bus stops) from FILE |
| -m <FILE> --od-matrix-files <FILE> |
Loads O/D-files from FILE(s) |
| --od-amitran-files <FILE> | Loads O/D-matrix in Amitran format from FILE(s) |
| -r <FILE> --route-files <FILE> |
Read sumo-routes or trips 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 |
| --weight-adaption <FLOAT> | The travel time influence of prior intervals; default: 0 |
| --taz-param <STRING> | Parameter key(s) defining source (and sink) taz |
Output
| Option | Description |
|---|---|
| --output-prefix <STRING> | Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time. |
| --precision <INT> | Defines the number of digits after the comma for floating point output; default: 2 |
| --precision.geo <INT> | Defines the number of digits after the comma for lon,lat output; default: 6 |
| -o <FILE> --output-file <FILE> |
Write flow definitions with route distributions to FILE |
| --vtype-output <FILE> | Write used vehicle types into separate FILE |
| --ignore-vehicle-type <BOOL> | Does not save vtype information; default: false |
| --netload-output <FILE> | Writes edge loads and final costs into FILE |
| --all-pairs-output <FILE> | Writes complete distance matrix into FILE |
| --exit-times <BOOL> | Write exit times (weights) for each edge; default: false |
Processing
| Option | Description |
|---|---|
| --aggregation-interval <TIME> | Defines the time interval when aggregating single vehicle input; Defaults to one hour; default: 3600 |
| --ignore-errors <BOOL> | Continue if a route could not be build; default: false |
| --max-alternatives <INT> | Prune the number of alternatives to INT; default: 5 |
| --weights.interpolate <BOOL> | Interpolate edge weights at interval boundaries; default: false |
| --weights.expand <BOOL> | Expand weights behind the simulation's end; default: false |
| --routing-algorithm <STRING> | Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']; default: dijkstra |
| --bulk-routing.vtypes <BOOL> | Aggregate routing queries with the same origin for different vehicle types; default: false |
| --routing-threads <INT> | The number of parallel execution threads used for routing; default: 0 |
| --weight-period <TIME> | Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy; default: 3600 |
| -s <FLOAT> --scale <FLOAT> |
Scales the loaded flows by FLOAT; default: 1 |
| --vtype <STRING> | Defines the name of the vehicle type to use |
| --prefix <STRING> | Defines the prefix for vehicle flow names |
| --timeline <STRING> | Uses STR as a timeline definition |
| --timeline.day-in-hours <BOOL> | Uses STR as a 24h-timeline definition; default: false |
| --additive-traffic <BOOL> | Keep traffic flows of all time slots in the net; default: false |
| --assignment-method <STRING> | Choose a assignment method: incremental, UE or SUE; default: incremental |
| --tolerance <FLOAT> | Use FLOAT as tolerance when checking for SUE stability; default: 0.001 |
| --left-turn-penalty <FLOAT> | Use left-turn penalty FLOAT to calculate link travel time when searching routes; default: 0 |
| --paths <INT> | Use INTEGER as the number of paths needed to be searched for each OD pair at each iteration; default: 1 |
| --paths.penalty <FLOAT> | Penalize existing routes with FLOAT to find secondary routes; default: 1 |
| --upperbound <FLOAT> | Use FLOAT as the upper bound to determine auxiliary link cost; default: 0.5 |
| --lowerbound <FLOAT> | Use FLOAT as the lower bound to determine auxiliary link cost; default: 0.15 |
| -i <INT> --max-iterations <INT> |
maximal number of iterations for new route searching in incremental and stochastic user assignment; default: 20 |
| --max-inner-iterations <INT> | maximal number of inner iterations for user equilibrium calcuation in the stochastic user assignment; default: 1000 |
| --route-choice-method <STRING> | Choose a route choice method: gawron, logit, or lohse; default: logit |
| --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 <BOOL> | Save routes with near zero probability; default: false |
| --skip-new-routes <BOOL> | Only reuse routes from input, do not calculate new ones; default: false |
| --logit.beta <FLOAT> | Use FLOAT as (c-)logit's beta for the commonality factor; default: 0.15 |
| --logit.gamma <FLOAT> | Use FLOAT as (c-)logit's gamma for the commonality factor; default: 1 |
| --logit.theta <FLOAT> | Use FLOAT as (c-)logit's theta; default: 0.01 |
Defaults
| Option | Description |
|---|---|
| --flow-output.departlane <STRING> | Assigns a default depart lane; default: free |
| --flow-output.departpos <STRING> | Assigns a default depart position |
| --flow-output.departspeed <STRING> | Assigns a default depart speed; default: max |
| --flow-output.arrivallane <STRING> | Assigns a default arrival lane |
| --flow-output.arrivalpos <STRING> | Assigns a default arrival position |
| --flow-output.arrivalspeed <STRING> | Assigns a default arrival speed |
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: 9223372036854774 |
Report
| Option | Description |
|---|---|
| -v <BOOL> --verbose <BOOL> |
Switches to verbose output; default: false |
| --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 <STRING> --xml-validation <STRING> |
Set schema validation scheme of XML inputs ("never", "auto" or "always"); default: auto |
| --xml-validation.net <STRING> | Set schema validation scheme of SUMO network inputs ("never", "auto" or "always"); default: never |
| -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 |
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 |
This page was last modified on 26 October 2017, at 06:58.