Scroll to navigation

ECLIPSE(1) User Commands ECLIPSE(1)

NAME

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

SYNOPSIS

duarouter [OPTION]*

DESCRIPTION

Eclipse SUMO duarouter Version 1.1.0
Copyright (C) 2001-2018 German Aerospace Center (DLR) and others; http://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-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)
-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
--phemlight-path FILE
Determines where to load PHEMlight definitions from.

Output Options:

--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 rathern than seconds
-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
--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
--exit-times
Write exit times (weights) for each edge

Processing Options:

--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
--max-alternatives INT
Prune the number of alternatives to INT
--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
--weights.interpolate
Interpolate edge weights at interval boundaries
--with-taz
Use origin and destination zones (districts) for in- and output
--bulk-routing
Aggregate routing queries with the same origin
--routing-threads INT
The number of parallel execution threads used for routing
--weights.expand
Expand weights behind the simulation's end
--routing-algorithm STR
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
--weight-period TIME
Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy
--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
--ptline-routing
Route all public transport input
--logit
Use c-logit model (deprecated in favor of --route-choice-method logit)
--route-choice-method STR
Choose a route choice method: gawron, logit, or lohse
--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.transfer.car-walk STR
Where are mode changes from car to walking allowed (possible values: 'parkingAreas', 'ptStops', 'allJunctions' and combinations)

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
-V, --version
Prints the current version
-X, --xml-validation STR
Set schema validation scheme of XML inputs ("never", "auto" or "always")
--xml-validation.net STR
Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
-W, --no-warnings
Disables output of warnings
-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
--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/issues>.
Get in contact via <sumo@dlr.de>.

Build features: x86_64-pc-linux-gnu PROJ GDAL GUI
Copyright (C) 2001-2018 German Aerospace Center (DLR) and others; http://sumo.dlr.de

Eclipse SUMO duarouter Version 1.1.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
SPDX-License-Identifier: EPL-2.0

February 2019 Eclipse SUMO duarouter Version 1.1.0