Eclipse SUMO duarouter v1_26_0+1107-e18765e03cf
 Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Shortest path router and DUE computer for the microscopic, multi-modal traffic
 simulation SUMO.

Usage: duarouter [OPTION]*
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.
  --output-suffix STR                 Suffix 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
  --taxi.vclasses STR[]               Network permissions that can be accessed
                                       by taxis
  --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
  --max-traveltime TIME               Declare routing failure if traveltime
                                       exceeds the given positive TIME

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

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