.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ECLIPSE "1" "December 2022" "Eclipse SUMO dfrouter Version 1.15.0" "User Commands"
.SH NAME
Eclipse \- Builds vehicle routes for SUMO using detector values
.SH SYNOPSIS
.B dfrouter
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO dfrouter Version 1.15.0
.IP
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
Builds vehicle routes for SUMO using detector values.
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\fB\-C\fR, \fB\-\-save\-configuration\fR FILE
Saves current configuration into FILE
.TP
\fB\-\-save\-configuration\fR.relative
Enforce relative paths when saving the
configuration
.TP
\fB\-\-save\-template\fR FILE
Saves a configuration template (empty)
into FILE
.TP
\fB\-\-save\-schema\fR FILE
Saves the configuration schema into FILE
.TP
\fB\-\-save\-commented\fR
Adds comments to saved template,
configuration, or schema
.SS "Input Options:"
.TP
\fB\-n\fR, \fB\-\-net\-file\fR FILE
Loads the SUMO\-network FILE
.TP
\fB\-d\fR, \fB\-\-detector\-files\fR FILE
Loads detector descriptions from FILE
.TP
\fB\-f\fR, \fB\-\-measure\-files\fR FILE
Loads detector flows from FILE(s)
.SS "Output Options:"
.TP
\fB\-\-write\-license\fR
Include license info into every output
file
.TP
\fB\-\-output\-prefix\fR STR
Prefix which is applied to all output
files. The special string 'TIME' is
replaced by the current time.
.TP
\fB\-\-precision\fR INT
Defines the number of digits after the
comma for floating point output
.TP
\fB\-\-precision\fR.geo INT
Defines the number of digits after the
comma for lon,lat output
.TP
\fB\-H\fR, \fB\-\-human\-readable\-time\fR
Write time values as hour:minute:second
or day:hour:minute:second rather than
seconds
.TP
\fB\-o\fR, \fB\-\-routes\-output\fR FILE
Saves computed routes to FILE
.TP
\fB\-\-routes\-for\-all\fR
Forces dfrouter to compute routes for
in\-between detectors
.TP
\fB\-\-detector\-output\fR FILE
Saves typed detectors to FILE
.TP
\fB\-\-detectors\-poi\-output\fR FILE
Saves detector positions as pois to FILE
.TP
\fB\-\-emitters\-output\fR FILE
Saves emitter definitions for source
detectors to FILE
.TP
\fB\-\-vtype\fR
Add vehicle types to the emitters file
(PKW, LKW)
.TP
\fB\-\-vtype\-output\fR FILE
Write generated vehicle types into
separate FILE instead of including them
into the emitters\-output
.TP
\fB\-\-emitters\-poi\-output\fR FILE
Saves emitter positions as pois to FILE
.TP
\fB\-\-variable\-speed\-sign\-output\fR FILE
Saves variable seed sign definitions for
sink detectors to FILE
.TP
\fB\-\-end\-reroute\-output\fR FILE
Saves rerouter definitions for sink
detectors to FILE
.HP
\fB\-\-validation\-output\fR FILE
.HP
\fB\-\-validation\-output\fR.add\-sources
.SS "Processing Options:"
.TP
\fB\-\-guess\-empty\-flows\fR
Derive missing flow values from upstream
or downstream (not working!)
.TP
\fB\-h\fR, \fB\-\-highway\-mode\fR
Switches to highway\-mode
.TP
\fB\-\-ignore\-invalid\-detectors\fR
Only warn about unparseable detectors
.TP
\fB\-\-revalidate\-detectors\fR
Recomputes detector types even if given
.TP
\fB\-\-revalidate\-routes\fR
Recomputes routes even if given
.TP
\fB\-\-keep\-unfinished\-routes\fR
Keeps routes even if they have exhausted
max\-search\-depth
.TP
\fB\-\-keep\-longer\-routes\fR
Keeps routes even if a shorter one
exists
.TP
\fB\-\-max\-search\-depth\fR INT
Number of edges to follow a route
without passing a detector
.TP
\fB\-\-emissions\-only\fR
Writes only emission times
.TP
\fB\-\-disallowed\-edges\fR STR[]
Do not route on these edges
.TP
\fB\-\-vclass\fR STR
Only route on edges allowing the given
vclass
.TP
\fB\-\-keep\-turnarounds\fR
Allow turnarounds as route continuations
.TP
\fB\-\-min\-route\-length\fR FLOAT
Minimum distance in meters between start
and end node of every route
.TP
\fB\-\-randomize\-flows\fR
generate random departure times for
emitted vehicles
.TP
\fB\-\-time\-factor\fR TIME
Multiply flow times with TIME to get
seconds
.TP
\fB\-\-time\-offset\fR TIME
Subtracts TIME seconds from (scaled)
flow times
.TP
\fB\-\-time\-step\fR TIME
Expected distance between two successive
data sets
.TP
\fB\-\-calibrator\-output\fR
Write calibrators to FILE
.HP
\fB\-\-include\-unused\-routes\fR
.HP
\fB\-\-revalidate\-flows\fR
.TP
\fB\-\-remove\-empty\-detectors\fR
Removes empty detectors from the list
.HP
\fB\-\-strict\-sources\fR
.TP
\fB\-\-respect\-concurrent\-inflows\fR
Try to determine further inflows to an
inbetween detector when computing split
probabilities
.TP
\fB\-\-scale\fR FLOAT
Scale factor for flows
.SS "Defaults Options:"
.TP
\fB\-\-departlane\fR STR
Assigns a default depart lane
.TP
\fB\-\-departpos\fR STR
Assigns a default depart position
.TP
\fB\-\-departspeed\fR STR
Assigns a default depart speed
.TP
\fB\-\-arrivallane\fR STR
Assigns a default arrival lane
.TP
\fB\-\-arrivalpos\fR STR
Assigns a default arrival position
.TP
\fB\-\-arrivalspeed\fR STR
Assigns a default arrival speed
.TP
\fB\-\-speeddev\fR FLOAT
The default speed deviation of vehicles
.SS "Time Options:"
.TP
\fB\-b\fR, \fB\-\-begin\fR TIME
Defines the begin time;
Previous defs will be discarded
.TP
\fB\-e\fR, \fB\-\-end\fR TIME
Defines the end time;
Later defs will be discarded;
Defaults to one day
.SS "Report Options:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Switches to verbose output
.TP
\fB\-\-print\-options\fR
Prints option values before processing
.TP
\-?, \fB\-\-help\fR
Prints this screen or selected topics
.TP
\fB\-V\fR, \fB\-\-version\fR
Prints the current version
.TP
\fB\-X\fR, \fB\-\-xml\-validation\fR STR
Set schema validation scheme of XML
inputs ("never", "local", "auto" or
"always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "local", "auto"
or "always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.TP
\fB\-\-aggregate\-warnings\fR INT
Aggregate warnings of the same type
whenever more than INT occur
.TP
\fB\-l\fR, \fB\-\-log\fR FILE
Writes all messages to FILE (implies
verbose)
.TP
\fB\-\-message\-log\fR FILE
Writes all non\-error messages to FILE
(implies verbose)
.TP
\fB\-\-error\-log\fR FILE
Writes all warnings and errors to FILE
.TP
\fB\-\-report\-empty\-detectors\fR
Lists detectors with no flow (enable \fB\-v\fR)
.TP
\fB\-\-print\-absolute\-flows\fR
Prints aggregated detector flows
.TP
\fB\-\-no\-step\-log\fR
Disable console output of route parsing
step
.SS "Random Number Options:"
.TP
\fB\-\-random\fR
Initialises the random number generator
with the current system time
.TP
\fB\-\-seed\fR INT
Initialises the random number generator
with the given value
.SH EXAMPLES
.IP
dfrouter \-c <CONFIGURATION>
.IP
run routing with options from file
.SH "REPORTING BUGS"
Report bugs at <https://github.com/eclipse/sumo/issues>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: Linux\-5.10.0\-19\-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
.br
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
.br
Eclipse SUMO dfrouter Version 1.15.0 is part of SUMO.
.br
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
.br
This program may also be made available under the following Secondary
.br
Licenses when the conditions for such availability set forth in the Eclipse
.br
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
.br
SPDX\-License\-Identifier: EPL\-2.0 OR GPL\-2.0\-or\-later