OD2TRIPS
generated on 2017-12-19 09:15:31.859006 from the wiki page for OD2TRIPS for SUMO 0.32.0
Contents
From 30.000 feet
OD2TRIPS imports O/D-matrices and splits them into single vehicle trips.
- Purpose: Conversion of O/D-matrices to single vehicle trips
- System: portable (Linux/Windows is tested); runs on command line
- Input (mandatory):
- A) O/D-Matrix
- B) a set of districts
- Output: A list of vehicle trip definitions
- Programming Language: C++
Usage Description
Options
You may use a XML schema definition file for setting up a OD2TRIPS configuration: od2tripsConfiguration.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 <BOOL> | Adds comments to saved template, configuration, or schema; default: false |
Input
| Option | Description |
|---|---|
| -n <FILE> --taz-files <FILE> |
Loads TAZ (districts; also from networks) from FILE(s) |
| -d <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) |
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> |
Writes trip definitions into FILE |
| --flow-output <FILE> | Writes flow definitions into FILE |
| --flow-output.probability <BOOL> | Writes probabilistic flow instead of evenly spaced flow; default: false |
| --pedestrians <BOOL> | Writes pedestrians instead of vehicles; default: false |
| --persontrips <BOOL> | Writes persontrips instead of vehicles; default: false |
| --ignore-vehicle-type <BOOL> | Does not save vtype information; 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: 9223372036854774 |
Processing
| Option | Description |
|---|---|
| -s <FLOAT> --scale <FLOAT> |
Scales the loaded flows by FLOAT; default: 1 |
| --spread.uniform <BOOL> | Spreads trips uniformly over each time period; default: false |
| --different-source-sink <BOOL> | Always choose source and sink edge which are not identical; default: false |
| --vtype <STRING> | Defines the name of the vehicle type to use |
| --prefix <STRING> | Defines the prefix for vehicle names |
| --timeline <STRING> | Uses STR as a timeline definition |
| --timeline.day-in-hours <BOOL> | Uses STR as a 24h-timeline definition; default: false |
| --ignore-errors <BOOL> | Continue on broken input; default: false |
| --no-step-log <BOOL> | Disable console output of current time step; default: false |
Defaults
| Option | Description |
|---|---|
| --departlane <STRING> | Assigns a default depart lane; default: free |
| --departpos <STRING> | Assigns a default depart position |
| --departspeed <STRING> | Assigns a default depart speed; default: max |
| --arrivallane <STRING> | Assigns a default arrival lane |
| --arrivalpos <STRING> | Assigns a default arrival position |
| --arrivalspeed <STRING> | Assigns a default arrival speed |
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 <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
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 <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 |
Notes
The option --vtype only works when "--od-matrix-files" is used. For "Amitran" format, this is given by the "id" property of "actorConfig".
This page was last modified on 12 September 2017, at 15:09.