--- name: "dfrouter" section: "1" platform: "linux" package: "sumo" version: "1.18.0+dfsg-4+b2" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/dfrouter" --- # dfrouter(1) Builds vehicle routes for SUMO using detector values ## 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 \ - run routing with options from file ## REPORTING BUGS Report bugs at \.\ Get in contact via \. - Build features: Linux-6.1.0-28-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