Scroll to navigation

ECLIPSE(1) User Commands ECLIPSE(1)

NAME

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

SYNOPSIS

duarouter [OPTION]*

DESCRIPTION

Eclipse SUMO duarouter Version 1.15.0

Copyright (C) 2001-2022 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:

Loads the named config on startup
Saves current configuration into FILE
Enforce relative paths when saving the configuration
Saves a configuration template (empty) into FILE
Saves the configuration schema into FILE
Adds comments to saved template, configuration, or schema

Input Options:

Use FILE as SUMO-network to route on
Read additional network data (districts, bus stops) from FILE(s)
Read sumo routes, alternatives, flows, and trips from FILE(s)
Determines where to load PHEMlight definitions from
Enable fleet age modelling with the given reference year in PHEMlight5
Set ambient temperature to correct NOx emissions in PHEMlight5
Read network weights from FILE(s)
Read lane-based network weights from FILE(s)
Name of the xml attribute which gives the edge weight
Initialize a TAZ for every junction to use attributes toJunction and fromJunction

Output Options:

Write generated routes to FILE
Write used vehicle types into separate FILE
Keep vTypeDistribution ids when writing vehicles and their types
Return fuel consumption values in (legacy) unit l instead of mg
Write vehicles that reference routes by their id
Include license info into every output file
Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
Defines the number of digits after the comma for floating point output
Defines the number of digits after the comma for lon,lat output
Write time values as hour:minute:second or day:hour:minute:second rather than seconds
Write generated route alternatives to FILE
Write edge splits and connectivity to FILE
Write intermodal edges with lengths and travel times to FILE
Write trips instead of vehicles (for validating trip input)
Write trips with geo-coordinates
Write trips with fromJunction and toJunction
Include the cost attribute in route output
Write exit times (weights) for each edge
Include total route length in the output

Processing Options:

Prune the number of alternatives to INT
Use origin and destination zones (districts) for in- and output
Assume input is unsorted
Load routes for the next number of seconds ahead
Disable (junction) internal links
generate random departure times for flow input
Remove loops within the route; Remove turnarounds at start and end of the route
Tries to correct a false route
Tries to correct an invalid starting edge by using the first usable edge instead
Tries to correct an invalid destination edge by using the last usable edge instead
Maximum distance when mapping input coordinates (fromXY etc.) to the road network
Match positions to junctions instead of edges
Aggregate routing queries with the same origin
The number of parallel execution threads used for routing
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
Comma separated list of param keys to compare for additional restrictions
Interpolate edge weights at interval boundaries
Expand the end of the last loaded weight interval to infinity
Apply the given time penalty when computing routing costs for minor-link internal lanes
Edge weights for routing are dynamically disturbed by a random factor drawn uniformly from [1,FLOAT)
Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy
Consider edge priorities in addition to travel times, weighted by factor
Initialize lookup table for astar from the given file (generated by marouter --all-pairs-output)
Initialize lookup table for astar ALT-variant from the given file
Save lookup table for astar ALT-variant to the given file
Use FLOAT as Gawron's beta
Use FLOAT as Gawron's a
Save routes with near zero probability
Only reuse routes from input, do not calculate new ones
The probability of keeping the old route
Route all public transport input
Choose a route choice method: gawron, logit, or lohse
Use c-logit model (deprecated in favor of --route-choice-method logit)
Use FLOAT as logit's beta
Use FLOAT as logit's gamma
Use FLOAT as logit's theta (negative values mean auto-estimation)
Use FLOAT as a factor on pedestrian maximum speed during intermodal routing
Use FLOAT as a factor on walking speed against vehicle traffic direction
Where are mode changes from car to walking allowed (possible values: 'parkingAreas', 'ptStops', 'allJunctions' and combinations)
Where taxis can drop off customers ('allJunctions, 'ptStops')
Where taxis can pick up customers ('allJunctions, 'ptStops')
Estimated time for taxi pickup
Use FLOAT as a maximum train length when initializing the railway router

Defaults Options:

Assigns a default depart lane
Assigns a default depart position
Assigns a default depart speed
Assigns a default arrival lane
Assigns a default arrival position
Assigns a default arrival speed
Defaults will override given values

Time Options:

Defines the begin time; Previous trips will be discarded
Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent

Report Options:

Switches to verbose output
Prints option values before processing
-?, --help
Prints this screen or selected topics
Prints the current version
Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")
Set schema validation scheme of SUMO network inputs ("never", "local", "auto" or "always")
Set schema validation scheme of SUMO route inputs ("never", "local", "auto" or "always")
Disables output of warnings
Aggregate warnings of the same type whenever more than INT occur
Writes all messages to FILE (implies verbose)
Writes all non-error messages to FILE (implies verbose)
Writes all warnings and errors to FILE
Continue if a route could not be build
Defines how often statistics shall be printed
Disable console output of route parsing step

Random Number Options:

Initialises the random number generator with the current system time
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/issues>.
Get in contact via <sumo@dlr.de>.


Build features: Linux-5.10.0-19-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de

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

December 2022 Eclipse SUMO duarouter Version 1.15.0