DFROUTER
Contents |
From 30.000 feet
DFROUTER uses induction loop values to compute vehicle routes that may be used by SUMO.
- Purpose: Building vehicle routes from induction loop counts
- 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) induction loop definitions
- C) induction loop measures
- 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 DFROUTER configuration: dfrouterConfiguration.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> | Loads the SUMO-network FILE | |
| -d <FILE> --detector-files <FILE> | Loads detector descriptions from FILE | |
| -f <FILE> --measure-files <FILE> | Loads detector flows from FILE(s) |
Output
| Option | Default Value | Description |
|---|---|---|
| -o <FILE> --routes-output <FILE> | Saves computed routes to FILE | |
| --routes-for-all | false | Forces DFROUTER to compute routes for in-between detectors |
| --detector-output <FILE> | Saves typed detectors to FILE | |
| --detectors-poi-output <FILE> | Saves detector positions as pois to FILE | |
| --emitters-output <FILE> | Saves emitter definitions for source detectors to FILE | |
| --emitters-poi-output <FILE> | Saves emitter positions as pois to FILE | |
| --variable-speed-sign-output <FILE> | Saves variable seed sign definitions for sink detectors to FILE | |
| --end-reroute-output <FILE> | Saves rerouter definitions for sink detectors to FILE | |
| --validation-output <FILE> | ||
| --validation-output.add-sources | false |
Processing
| Option | Default Value | Description |
|---|---|---|
| --guess-empty-flows | false | |
| -h --highway-mode | false | Switches to highway-mode |
| --ignore-invalid-detectors | false | Only warn about unparseable detectors |
| --revalidate-detectors | false | Recomputes detector types even if given |
| --revalidate-routes | false | Recomputes routes even if given |
| --all-end-follower | false | Continues routes till the first street after a sink |
| --keep-unfinished-routes | false | Keeps routes even if they have exhausted max-search-depth |
| --keep-longer-routes | false | Keeps routes even if a shorter one exists |
| --max-search-depth <INT> | 30 | Number of edges to follow a route without passing a detector |
| --emissions-only | false | Writes only emission times |
| --disallowed-edges <STRING> | Do not route on these edges | |
| --keep-turnarounds | false | Allow turnarounds as route continuations |
| --min-route-length <FLOAT> | -1 | Minimum distance in meters between start and end node of every route. |
| --time-factor <TIME> | 60 | Multiply flow times with TIME to get seconds |
| --time-offset <TIME> | 0 | Subtracts TIME seconds from (scaled) flow times |
| --time-step <TIME> | 60 | Expected distance between two successive data sets |
| --calibrator-output | false | Write calibrators to FILE |
| --include-unused-routes | false | |
| --revalidate-flows | false | |
| --remove-empty-detectors | false | Removes empty detectors from the list |
| --strict-sources | false | |
| --scale <FLOAT> | 1 | Scale factor for flows |
Time
| Option | Default Value | Description |
|---|---|---|
| -b <TIME> --begin <TIME> | 0 | Defines the begin time; Previous defs will be discarded |
| -e <TIME> --end <TIME> | 86400 | Defines the end time; Later defs will be discarded; Defaults to one day |
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 | |
| --report-empty-detectors | false | Lists detectors with no flow (enable -v) |
| --print-absolute-flows | false | Prints aggregated detector flows |
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.