duarouter1
Shortest path router and due computer for the microscopic traffic simulation sumo
Usage
duarouter [OPTION]
*
Overview
Eclipse SUMO duarouter Version 1.18.0
-
Copyright (C) 2001-2023 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
-
--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
-
--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
-
--mapmatch.distance FLOAT -
Maximum distance when mapping input coordinates (fromXY etc.) to the road network
-
--mapmatch.junctions -
Match positions to junctions 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.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
-
--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
-
--route-choice-method STR -
Choose a route choice method: gawron, logit, or lohse
-
--logit -
Use c-logit model (deprecated in favor of
--route-choice-methodlogit)
-
--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
-
--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
-
--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
History
- Debian 13 (Trixie): the text shown here
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Debian 10 (Buster)
- Debian 9 (Stretch)
- Debian 8 (Jessie)
- Debian 7 (Wheezy)
--additional-files since Debian 8 (Jessie);
--aggregate-warnings since Debian 11 (Bullseye);
--alternatives-output since Debian 10 (Buster);
--astar.all-distances since Debian 10 (Buster);
--astar.landmark-distances since Debian 10 (Buster);
--astar.save-landmark-distances since Debian 10 (Buster);
--bulk-routing since Debian 9 (Stretch);
--emissions.volumetric-fuel since Debian 12 (Bookworm);
--human-readable-time since Debian 10 (Buster);
--intermodal-network-output since Debian 10 (Buster);
--intermodal-weight-output since Debian 10 (Buster);
--junction-taz since Debian 11 (Bullseye);
--keep-route-probability since Debian 12 (Bookworm);
--keep-vtype-distributions since Debian 10 (Buster);
--language since Debian 13 (Trixie);
--mapmatch.distance since Debian 11 (Bullseye);
--mapmatch.junctions since Debian 11 (Bullseye);
--named-routes since Debian 12 (Bookworm);
--no-internal-links since Debian 10 (Buster);
--output-prefix since Debian 9 (Stretch);
--persontrip.taxi.waiting-time since Debian 11 (Bullseye);
--persontrip.transfer.car-walk since Debian 10 (Buster);
--persontrip.transfer.taxi-walk since Debian 11 (Bullseye);
--persontrip.transfer.walk-taxi since Debian 11 (Bullseye);
--persontrip.walk-opposite-factor since Debian 12 (Bookworm);
--persontrip.walkfactor since Debian 10 (Buster);
--phemlight-path since Debian 8 (Jessie);
--phemlight-temperature since Debian 12 (Bookworm);
--phemlight-year since Debian 12 (Bookworm);
--precision since Debian 10 (Buster);
--precision.geo since Debian 10 (Buster);
--ptline-routing since Debian 10 (Buster);
--railway.max-train-length since Debian 11 (Bullseye);
--repair.from since Debian 9 (Stretch);
--repair.to since Debian 9 (Stretch);
--restriction-params since Debian 11 (Bullseye);
--route-choice-method since Debian 8 (Jessie);
--route-length since Debian 12 (Bookworm);
--route-steps since Debian 9 (Stretch);
--routing-threads since Debian 9 (Stretch);
--save-configuration.relative since Debian 12 (Bookworm);
--weight-period since Debian 9 (Stretch);
--weights.minor-penalty since Debian 11 (Bullseye);
--weights.priority-factor since Debian 11 (Bullseye);
--weights.random-factor since Debian 11 (Bullseye);
--write-costs since Debian 12 (Bookworm);
--write-license since Debian 10 (Buster);
--write-trips since Debian 11 (Bullseye);
--write-trips.geo since Debian 11 (Bullseye);
--write-trips.junctions since Debian 11 (Bullseye);
--xml-validation since Debian 8 (Jessie);
--xml-validation.net since Debian 8 (Jessie);
--xml-validation.routes since Debian 11 (Bullseye);
-C since Debian 10 (Buster);
-H since Debian 10 (Buster);
-X since Debian 8 (Jessie);
-s since Debian 9 (Stretch).
--alternative-files until Debian 9 (Stretch);
--flow-files until Debian 9 (Stretch);
--taz-files until Debian 7 (Wheezy);
--trip-files until Debian 9 (Stretch);
-d until Debian 9 (Stretch);
-f until Debian 9 (Stretch);
-p until Debian 7 (Wheezy);
-t until Debian 9 (Stretch).