table of contents
ECLIPSE(1) | User Commands | ECLIPSE(1) |
NAME¶
Eclipse - Builds vehicle routes for SUMO using detector values
SYNOPSIS¶
dfrouter [OPTION]*
DESCRIPTION¶
Eclipse SUMO dfrouter Version 1.18.0
- Copyright (C) 2001-2023 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Builds vehicle routes for SUMO using detector values.
Configuration Options:¶
- -c, --configuration-file FILE
- Loads the named config on startup
- -C, --save-configuration FILE
- Saves current configuration into FILE
- --save-configuration.relative
- Enforce relative paths when saving the configuration
- --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
Input Options:¶
- -n, --net-file FILE
- Loads the SUMO-network FILE
- -d, --detector-files FILE
- Loads detector descriptions from FILE
- -f, --measure-files FILE
- Loads detector flows from FILE(s)
Output Options:¶
- --write-license
- Include license info into every output file
- --output-prefix STR
- 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
- --precision.geo INT
- Defines the number of digits after the comma for lon,lat output
- -H, --human-readable-time
- Write time values as hour:minute:second or day:hour:minute:second rather than seconds
- -o, --routes-output FILE
- Saves computed routes to FILE
- --routes-for-all
- 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
- --vtype
- Add vehicle types to the emitters file (PKW, LKW)
- --vtype-output FILE
- Write generated vehicle types into separate FILE instead of including them into the emitters-output
- --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
- Write induction loop definitions for the given detector positions to FILE
- --validation-output.add-sources
- Add source detectors to the validation output
Processing Options:¶
- --guess-empty-flows
- Derive missing flow values from upstream or downstream (not working!)
- -h, --highway-mode
- Switches to highway-mode
- --ignore-invalid-detectors
- Only warn about unparseable detectors
- --revalidate-detectors
- Recomputes detector types even if given
- --revalidate-routes
- Recomputes routes even if given
- --keep-unfinished-routes
- Keeps routes even if they have exhausted max-search-depth
- --keep-longer-routes
- Keeps routes even if a shorter one exists
- --max-search-depth INT
- Number of edges to follow a route without passing a detector
- --emissions-only
- Writes only emission times
- --disallowed-edges STR[]
- Do not route on these edges
- --vclass STR
- Only route on edges allowing the given vclass
- --keep-turnarounds
- Allow turnarounds as route continuations
- --min-route-length FLOAT
- Minimum distance in meters between start and end node of every route
- --randomize-flows
- generate random departure times for emitted vehicles
- --time-factor TIME
- Multiply flow times with TIME to get seconds
- --time-offset TIME
- Subtracts TIME seconds from (scaled) flow times
- --time-step TIME
- Expected distance between two successive data sets
- --calibrator-output
- Write calibrators to FILE
- --include-unused-routes
- Include routes in the output which have no vehicles
- --revalidate-flows
- Checks whether detectors with calculated flow 0 can attract additional traffic
- --remove-empty-detectors
- Removes empty detectors from the list
- --strict-sources
- Whether edges with unknown status can prevent an edge from becoming a source
- --respect-concurrent-inflows
- Try to determine further inflows to an inbetween detector when computing split probabilities
- --scale FLOAT
- Scale factor for flows
Defaults Options:¶
- --departlane STR
- Assigns a default depart lane
- --departpos STR
- Assigns a default depart position
- --departspeed STR
- Assigns a default depart speed
- --arrivallane STR
- Assigns a default arrival lane
- --arrivalpos STR
- Assigns a default arrival position
- --arrivalspeed STR
- Assigns a default arrival speed
- --speeddev FLOAT
- The default speed deviation of vehicles
Time Options:¶
- -b, --begin TIME
- Defines the begin time; Previous defs will be discarded
- -e, --end TIME
- Defines the end time; Later defs will be discarded; Defaults to one day
Report Options:¶
- -v, --verbose
- Switches to verbose output
- --print-options
- Prints option values before processing
- -?, --help
- Prints this screen or selected topics
- -V, --version
- Prints the current version
- -X, --xml-validation STR
- Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")
- --xml-validation.net STR
- Set schema validation scheme of SUMO network inputs ("never", "local", "auto" or "always")
- -W, --no-warnings
- Disables output of warnings
- --aggregate-warnings INT
- Aggregate warnings of the same type whenever more than INT occur
- -l, --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
- --language STR
- Language to use in messages
- --report-empty-detectors
- Lists detectors with no flow (enable -v)
- --print-absolute-flows
- Prints aggregated detector flows
- --no-step-log
- Disable console output of route parsing step
Random Number Options:¶
- --random
- Initialises the random number generator with the current system time
- --seed INT
- Initialises the random number generator with the given value
EXAMPLES¶
- dfrouter -c <CONFIGURATION>
- run routing with options from file
REPORTING BUGS¶
Report bugs at <https://github.com/eclipse/sumo/issues>.
Get in contact via <sumo@dlr.de>.
-
Build features: Linux-6.1.0-26-amd64 x86_64 GNU 14.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2023 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Eclipse SUMO dfrouter Version 1.18.0 is part of SUMO.
This program and the accompanying materials are made available under the terms
of the Eclipse Public License v2.0 which accompanies this distribution, and
is available at http://www.eclipse.org/legal/epl-v20.html
This program may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse
Public License 2.0 are satisfied: GNU General Public License, version 2 or
later which is available at
https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
October 2024 | Eclipse SUMO dfrouter Version 1.18.0 |