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.8.0-51-generic aarch64 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