.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH ECLIPSE "1" "February 2019" "Eclipse SUMO duarouter Version 1.1.0" "User Commands"
.SH NAME
Eclipse \- Shortest path router and DUE computer for the microscopic road traffic simulation SUMO
.SH SYNOPSIS
.B duarouter
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO duarouter Version 1.1.0
.IP
Copyright (C) 2001\-2018 German Aerospace Center (DLR) and others; http://sumo.dlr.de
.PP
Shortest path router and DUE computer for the microscopic, multi\-modal traffic
.IP
simulation SUMO.
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\fB\-C\fR, \fB\-\-save\-configuration\fR FILE
Saves current configuration into FILE
.TP
\fB\-\-save\-template\fR FILE
Saves a configuration template (empty)
into FILE
.TP
\fB\-\-save\-schema\fR FILE
Saves the configuration schema into FILE
.TP
\fB\-\-save\-commented\fR
Adds comments to saved template,
configuration, or schema
.SS "Input Options:"
.TP
\fB\-n\fR, \fB\-\-net\-file\fR FILE
Use FILE as SUMO\-network to route on
.TP
\fB\-a\fR, \fB\-\-additional\-files\fR FILE
Read additional network data (districts,
bus stops) from FILE(s)
.TP
\fB\-r\fR, \fB\-\-route\-files\fR FILE
Read sumo routes, alternatives, flows,
and trips from FILE(s)
.TP
\fB\-w\fR, \fB\-\-weight\-files\fR FILE
Read network weights from FILE(s)
.TP
\fB\-\-lane\-weight\-files\fR FILE
Read lane\-based network weights from
FILE(s)
.TP
\fB\-x\fR, \fB\-\-weight\-attribute\fR STR
Name of the xml attribute which gives the
edge weight
.TP
\fB\-\-phemlight\-path\fR FILE
Determines where to load PHEMlight
definitions from.
.SS "Output Options:"
.TP
\fB\-\-write\-license\fR
Include license info into every output
file
.TP
\fB\-\-output\-prefix\fR STR
Prefix which is applied to all output
files. The special string 'TIME' is
replaced by the current time.
.TP
\fB\-\-precision\fR INT
Defines the number of digits after the
comma for floating point output
.TP
\fB\-\-precision\fR.geo INT
Defines the number of digits after the
comma for lon,lat output
.TP
\fB\-H\fR, \fB\-\-human\-readable\-time\fR
Write time values as hour:minute:second
or day:hour:minute:second rathern than
seconds
.TP
\fB\-o\fR, \fB\-\-output\-file\fR FILE
Write generated routes to FILE
.TP
\fB\-\-vtype\-output\fR FILE
Write used vehicle types into separate
FILE
.TP
\fB\-\-keep\-vtype\-distributions\fR
Keep vTypeDistribution ids when writing
vehicles and their types
.TP
\fB\-\-alternatives\-output\fR FILE
Write generated route alternatives to
FILE
.TP
\fB\-\-intermodal\-network\-output\fR FILE
Write edge splits and connectivity to
FILE
.TP
\fB\-\-intermodal\-weight\-output\fR FILE
Write intermodal edges with lengths and
travel times to FILE
.TP
\fB\-\-exit\-times\fR
Write exit times (weights) for each edge
.SS "Processing Options:"
.TP
\fB\-\-unsorted\-input\fR
Assume input is unsorted
.TP
\fB\-s\fR, \fB\-\-route\-steps\fR TIME
Load routes for the next number of
seconds ahead
.TP
\fB\-\-no\-internal\-links\fR
Disable (junction) internal links
.TP
\fB\-\-randomize\-flows\fR
generate random departure times for flow
input
.TP
\fB\-\-max\-alternatives\fR INT
Prune the number of alternatives to INT
.TP
\fB\-\-remove\-loops\fR
Remove loops within the route;
Remove turnarounds at start and end of
the route
.TP
\fB\-\-repair\fR
Tries to correct a false route
.TP
\fB\-\-repair\fR.from
Tries to correct an invalid starting edge
by using the first usable edge instead
.TP
\fB\-\-repair\fR.to
Tries to correct an invalid destination
edge by using the last usable edge
instead
.TP
\fB\-\-weights\fR.interpolate
Interpolate edge weights at interval
boundaries
.TP
\fB\-\-with\-taz\fR
Use origin and destination zones
(districts) for in\- and output
.TP
\fB\-\-bulk\-routing\fR
Aggregate routing queries with the same
origin
.TP
\fB\-\-routing\-threads\fR INT
The number of parallel execution threads
used for routing
.TP
\fB\-\-weights\fR.expand
Expand weights behind the simulation's
end
.TP
\fB\-\-routing\-algorithm\fR STR
Select among routing algorithms
['dijkstra', 'astar', 'CH', 'CHWrapper']
.TP
\fB\-\-weight\-period\fR TIME
Aggregation period for the given weight
files;
triggers rebuilding of Contraction
Hierarchy
.TP
\fB\-\-astar\fR.all\-distances FILE
Initialize lookup table for astar from
the given file (generated by marouter
\fB\-\-all\-pairs\-output\fR)
.TP
\fB\-\-astar\fR.landmark\-distances FILE
Initialize lookup table for astar
ALT\-variant from the given file
.TP
\fB\-\-astar\fR.save\-landmark\-distances FILE
Save lookup table for astar ALT\-variant
to the given file
.TP
\fB\-\-gawron\fR.beta FLOAT
Use FLOAT as Gawron's beta
.TP
\fB\-\-gawron\fR.a FLOAT
Use FLOAT as Gawron's a
.TP
\fB\-\-keep\-all\-routes\fR
Save routes with near zero probability
.TP
\fB\-\-skip\-new\-routes\fR
Only reuse routes from input, do not
calculate new ones
.TP
\fB\-\-ptline\-routing\fR
Route all public transport input
.TP
\fB\-\-logit\fR
Use c\-logit model (deprecated in favor of
\fB\-\-route\-choice\-method\fR logit)
.TP
\fB\-\-route\-choice\-method\fR STR
Choose a route choice method: gawron,
logit, or lohse
.TP
\fB\-\-logit\fR.beta FLOAT
Use FLOAT as logit's beta
.TP
\fB\-\-logit\fR.gamma FLOAT
Use FLOAT as logit's gamma
.TP
\fB\-\-logit\fR.theta FLOAT
Use FLOAT as logit's theta (negative
values mean auto\-estimation)
.TP
\fB\-\-persontrip\fR.walkfactor FLOAT
Use FLOAT as a factor on pedestrian
maximum speed during intermodal routing
.TP
\fB\-\-persontrip\fR.transfer.car\-walk STR
Where are mode changes from car to
walking allowed (possible values:
\&'parkingAreas', 'ptStops',
\&'allJunctions' and combinations)
.SS "Defaults Options:"
.TP
\fB\-\-departlane\fR STR
Assigns a default depart lane
.TP
\fB\-\-departpos\fR STR
Assigns a default depart position
.TP
\fB\-\-departspeed\fR STR
Assigns a default depart speed
.TP
\fB\-\-arrivallane\fR STR
Assigns a default arrival lane
.TP
\fB\-\-arrivalpos\fR STR
Assigns a default arrival position
.TP
\fB\-\-arrivalspeed\fR STR
Assigns a default arrival speed
.TP
\fB\-\-defaults\-override\fR
Defaults will override given values
.SS "Time Options:"
.TP
\fB\-b\fR, \fB\-\-begin\fR TIME
Defines the begin time;
Previous trips will be discarded
.TP
\fB\-e\fR, \fB\-\-end\fR TIME
Defines the end time;
Later trips will be discarded;
Defaults to the maximum time that SUMO
can represent
.SS "Report Options:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Switches to verbose output
.TP
\fB\-\-print\-options\fR
Prints option values before processing
.TP
\-?, \fB\-\-help\fR
Prints this screen
.TP
\fB\-V\fR, \fB\-\-version\fR
Prints the current version
.TP
\fB\-X\fR, \fB\-\-xml\-validation\fR STR
Set schema validation scheme of XML
inputs ("never", "auto" or "always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "auto" or
"always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.TP
\fB\-l\fR, \fB\-\-log\fR FILE
Writes all messages to FILE (implies
verbose)
.TP
\fB\-\-message\-log\fR FILE
Writes all non\-error messages to FILE
(implies verbose)
.TP
\fB\-\-error\-log\fR FILE
Writes all warnings and errors to FILE
.TP
\fB\-\-ignore\-errors\fR
Continue if a route could not be build
.TP
\fB\-\-stats\-period\fR INT
Defines how often statistics shall be
printed
.TP
\fB\-\-no\-step\-log\fR
Disable console output of route parsing
step
.SS "Random Number Options:"
.TP
\fB\-\-random\fR
Initialises the random number generator
with the current system time
.TP
\fB\-\-seed\fR INT
Initialises the random number generator
with the given value
.SH EXAMPLES
.IP
duarouter \-c <CONFIGURATION>
.IP
run routing with options from file
.SH "REPORTING BUGS"
Report bugs at <https://github.com/eclipse/sumo/issues>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: x86_64\-pc\-linux\-gnu PROJ GDAL GUI
.br
Copyright (C) 2001\-2018 German Aerospace Center (DLR) and others; http://sumo.dlr.de
.PP
.br
Eclipse SUMO duarouter Version 1.1.0 is part of SUMO.
.br
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
.br
SPDX\-License\-Identifier: EPL\-2.0