Path: blob/main/tests/duarouter/meta/help/output.duarouter
185994 views
Eclipse SUMO duarouter v1_25_0+0458-86552fc0338
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.
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
--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 <[email protected]>.