ECLIPSE(1)

NAME
Eclipse - Shortest path router and DUE computer for the microscopic traffic simulation SUMO

SYNOPSIS
duarouter [OPTION]*

DESCRIPTION
Eclipse SUMO duarouter 1.25.0

    Copyright (C) 2001-2025 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Shortest path router and DUE computer for the microscopic, multi-modal traffic

    simulation SUMO.

  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
    Use FILE as SUMO-network to route on

-a, --additional-files FILE
    Read additional network data (districts, bus stops) from FILE(s)

-r, --route-files FILE
    Read sumo routes, alternatives, flows, and trips from FILE(s)

--phemlight-path FILE
    Determines where to load PHEMlight definitions from

--phemlight-year INT
    Enable fleet age modelling with the given reference year in PHEMlight5

--phemlight-temperature FLOAT
    Set ambient temperature to correct NOx emissions in PHEMlight5

-w, --weight-files FILE
    Read network weights from FILE(s)

--lane-weight-files FILE
    Read lane-based network weights from FILE(s)

-x, --weight-attribute STR
    Name of the xml attribute which gives the edge weight

--junction-taz
    Initialize a TAZ for every junction to use attributes toJunction and fromJunction

  Output Options:

-o, --output-file FILE
    Write generated routes to FILE

--vtype-output FILE
    Write used vehicle types into separate FILE

--keep-vtype-distributions
    Keep vTypeDistribution ids when writing vehicles and their types

--emissions.volumetric-fuel
    Return fuel consumption values in (legacy) unit l instead of mg

--named-routes
    Write vehicles that reference routes by their id

--write-license
    Include license info into every output file

--write-metadata
    Write parsable metadata (configuration etc.) instead of comments

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

--output.compression STR
    Defines the standard compression algorithm (currently only for parquet output)

--output.format STR
    Defines the standard output format if not derivable from the file name ('xml', 'csv', 'parquet')

--output.column-header STR
    How to derive column headers from attribute names ('none', 'tag', 'auto', 'plain')

--output.column-separator STR
    Separator in CSV output

-H, --human-readable-time
    Write time values as hour:minute:second or day:hour:minute:second rather than seconds

--alternatives-output FILE
    Write generated route alternatives to FILE

--intermodal-network-output FILE
    Write edge splits and connectivity to FILE

--intermodal-weight-output FILE
    Write intermodal edges with lengths and travel times to FILE

--write-trips
    Write trips instead of vehicles (for validating trip input)

--write-trips.geo
    Write trips with geo-coordinates

--write-trips.junctions
    Write trips with fromJunction and toJunction

--write-costs
    Include the cost attribute in route output

--exit-times
    Write exit times (weights) for each edge

--route-length
    Include total route length in the output

  Processing Options:

--max-alternatives INT
    Prune the number of alternatives to INT

--with-taz
    Use origin and destination zones (districts) for in- and output

--unsorted-input
    Assume input is unsorted

-s, --route-steps TIME
    Load routes for the next number of seconds ahead

--no-internal-links
    Disable (junction) internal links

--randomize-flows
    generate random departure times for flow input

--remove-loops
    Remove loops within the route; Remove turnarounds at start and end of the route

--repair
    Tries to correct a false route

--repair.from
    Tries to correct an invalid starting edge by using the first usable edge instead

--repair.to
    Tries to correct an invalid destination edge by using the last usable edge instead

--repair.max-detour-factor FLOAT
    Backtrack on route if the detour is longer than the gap by FACTOR

--mapmatch.distance FLOAT
    Maximum distance when mapping input coordinates (fromXY etc.) to the road network

--mapmatch.junctions
    Match positions to junctions instead of edges

--mapmatch.taz
    Match positions to taz instead of edges

--bulk-routing
    Aggregate routing queries with the same origin

--routing-threads INT
    The number of parallel execution threads used for routing

--routing-algorithm STR
    Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']

--restriction-params STR[]
    Comma separated list of param keys to compare for additional restrictions

--weights.interpolate
    Interpolate edge weights at interval boundaries

--weights.expand
    Expand the end of the last loaded weight interval to infinity

--weights.minor-penalty FLOAT
    Apply the given time penalty when computing routing costs for minor-link internal lanes

--weights.tls-penalty FLOAT
    Apply the given time penalty when computing routing costs across a traffic light

--weights.turnaround-penalty FLOAT
    Apply the given time penalty when computing routing costs for turnaround internal lanes

--weights.reversal-penalty FLOAT
    Apply the given time penalty when computing routing costs for train reversal. Negative values disable reversal

--weights.random-factor FLOAT
    Edge weights for routing are dynamically disturbed by a random factor drawn uniformly from [1,FLOAT)

--weight-period TIME
    Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy

--weights.priority-factor FLOAT
    Consider edge priorities in addition to travel times, weighted by factor

--astar.all-distances FILE
    Initialize lookup table for astar from the given file (generated by marouter --all-pairs-output)

--astar.landmark-distances FILE
    Initialize lookup table for astar ALT-variant from the given file

--astar.save-landmark-distances FILE
    Save lookup table for astar ALT-variant to the given file

--scale FLOAT
    Scale demand by the given factor (by discarding or duplicating vehicles)

--scale-suffix STR
    Suffix to be added when creating ids for cloned vehicles

--gawron.beta FLOAT
    Use FLOAT as Gawron's beta

--gawron.a FLOAT
    Use FLOAT as Gawron's a

--keep-all-routes
    Save routes with near zero probability

--skip-new-routes
    Only reuse routes from input, do not calculate new ones

--keep-route-probability FLOAT
    The probability of keeping the old route

--ptline-routing
    Route all public transport input

--keep-flows
    Write flows instead of expanding them into vehicles

--route-choice-method STR
    Choose a route choice method: gawron, logit, or lohse

--logit
    Use c-logit model (deprecated in favor of --route-choice-method logit)

--logit.beta FLOAT
    Use FLOAT as logit's beta

--logit.gamma FLOAT
    Use FLOAT as logit's gamma

--logit.theta FLOAT
    Use FLOAT as logit's theta (negative values mean auto-estimation)

--persontrip.walkfactor FLOAT
    Use FLOAT as a factor on pedestrian maximum speed during intermodal routing

--persontrip.walk-opposite-factor FLOAT
    Use FLOAT as a factor on walking speed against vehicle traffic direction

--persontrip.transfer.car-walk STR[]
    Where are mode changes from car to walking allowed (possible values: 'parkingAreas', 'ptStops', 'allJunctions' and combinations)

--persontrip.transfer.taxi-walk STR[]
    Where taxis can drop off customers ('allJunctions, 'ptStops')

--persontrip.transfer.walk-taxi STR[]
    Where taxis can pick up customers ('allJunctions, 'ptStops')

--persontrip.taxi.waiting-time TIME
    Estimated time for taxi pickup

--persontrip.ride-public-line
    Only use the intended public transport line rather than any alternative line that stops at the destination

--railway.max-train-length FLOAT
    Use FLOAT as a maximum train length when initializing the railway router

  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

--defaults-override
    Defaults will override given values

  Time Options:

-b, --begin TIME
    Defines the begin time; Previous trips will be discarded

-e, --end TIME
    Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent

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

--xml-validation.routes STR
    Set schema validation scheme of SUMO route 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

--log.timestamps
    Writes timestamps in front of all messages

--log.processid
    Writes process ID in front of all messages

--language STR
    Language to use in messages

--ignore-errors
    Continue if a route could not be build

--stats-period INT
    Defines how often statistics shall be printed

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

    duarouter -c <CONFIGURATION>

    run routing with options from file

REPORTING BUGS
Report bugs at <https://github.com/eclipse-sumo/sumo/issues>.
Get in contact via <sumo@dlr.de>.

    Build features: Linux-6.8.0-90-generic x86_64 GNU 15.2.0 None FMI Proj GUI Intl SWIG Eigen GDAL FFmpeg OSG GL2PS
    Copyright (C) 2001-2025 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO duarouter 1.25.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