Scroll to navigation

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.1.0
Copyright (C) 2001-2018 German Aerospace Center (DLR) and others; http://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-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 rathern 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

--validation-output.add-sources

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
--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

--revalidate-flows

--remove-empty-detectors
Removes empty detectors from the list

--strict-sources

--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
-V, --version
Prints the current version
-X, --xml-validation STR
Set schema validation scheme of XML inputs ("never", "auto" or "always")
--xml-validation.net STR
Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
-W, --no-warnings
Disables output of warnings
-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
--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: x86_64-pc-linux-gnu PROJ GDAL GUI
Copyright (C) 2001-2018 German Aerospace Center (DLR) and others; http://sumo.dlr.de

Eclipse SUMO dfrouter Version 1.1.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
SPDX-License-Identifier: EPL-2.0

February 2019 Eclipse SUMO dfrouter Version 1.1.0