.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ECLIPSE "1" "December 2022" "Eclipse SUMO marouter Version 1.15.0" "User Commands"
.SH NAME
Eclipse \- Import O/D-matrices and trips using macroscopic traffic assignment for SUMO
.SH SYNOPSIS
.B marouter
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO marouter Version 1.15.0
.IP
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
Import O/D\-matrices for macroscopic traffic assignment to generate SUMO routes
.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\-configuration\fR.relative
Enforce relative paths when saving the
configuration
.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\-\-phemlight\-path\fR FILE
Determines where to load PHEMlight
definitions from
.TP
\fB\-\-phemlight\-year\fR INT
Enable fleet age modelling with the given
reference year in PHEMlight5
.TP
\fB\-\-phemlight\-temperature\fR FLOAT
Set ambient temperature to correct NOx
emissions in PHEMlight5
.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\-\-junction\-taz\fR
Initialize a TAZ for every junction to use
attributes toJunction and fromJunction
.TP
\fB\-m\fR, \fB\-\-od\-matrix\-files\fR FILE
Loads O/D\-files from FILE(s)
.TP
\fB\-\-od\-amitran\-files\fR FILE
Loads O/D\-matrix in Amitran format from
FILE(s)
.TP
\fB\-z\fR, \fB\-\-tazrelation\-files\fR FILE
Loads O/D\-matrix in tazRelation format
from FILE(s)
.TP
\fB\-\-tazrelation\-attribute\fR STR
Define data attribute for loading counts
(default 'count')
.TP
\fB\-\-weight\-adaption\fR FLOAT
The travel time influence of prior
intervals
.TP
\fB\-\-taz\-param\fR STR[]
Parameter key(s) defining source (and
sink) taz
.TP
\fB\-\-ignore\-taz\fR
Ignore attributes 'fromTaz' and 'toTaz'
.SS "Output Options:"
.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\-\-emissions\fR.volumetric\-fuel
Return fuel consumption values in (legacy)
unit l instead of mg
.TP
\fB\-\-named\-routes\fR
Write vehicles that reference routes by
their id
.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 rather than seconds
.TP
\fB\-\-ignore\-vehicle\-type\fR
Does not save vtype information
.TP
\fB\-\-netload\-output\fR FILE
Writes edge loads and final costs into
FILE
.TP
\fB\-\-all\-pairs\-output\fR FILE
Writes complete distance matrix into FILE
.TP
\fB\-\-exit\-times\fR
Write exit times (weights) for each edge
.SS "Processing Options:"
.TP
\fB\-\-max\-alternatives\fR INT
Prune the number of alternatives to INT
.TP
\fB\-\-with\-taz\fR
Use origin and destination zones
(districts) for in\- and output
.TP
\fB\-\-routing\-threads\fR INT
The number of parallel execution threads
used for routing
.TP
\fB\-\-routing\-algorithm\fR STR
Select among routing algorithms
['dijkstra', 'astar', 'CH', 'CHWrapper']
.TP
\fB\-\-restriction\-params\fR STR[]
Comma separated list of param keys to
compare for additional restrictions
.TP
\fB\-\-weights\fR.interpolate
Interpolate edge weights at interval
boundaries
.TP
\fB\-\-weights\fR.expand
Expand the end of the last loaded weight
interval to infinity
.TP
\fB\-\-weights\fR.minor\-penalty FLOAT
Apply the given time penalty when
computing routing costs for minor\-link
internal lanes
.TP
\fB\-\-aggregation\-interval\fR TIME
Defines the time interval when aggregating
single vehicle input; Defaults to one hour
.TP
\fB\-\-capacities\fR.default
Ignore edge priorities when calculating
capacities and restraints
.TP
\fB\-\-weights\fR.priority\-factor FLOAT
Consider edge priorities in addition to
travel times, weighted by factor
.TP
\fB\-\-bulk\-routing\fR.vtypes
Aggregate routing queries with the same
origin for different vehicle types
.TP
\fB\-\-weight\-period\fR TIME
Aggregation period for the given weight
files;
triggers rebuilding of Contraction
Hierarchy
.TP
\fB\-s\fR, \fB\-\-scale\fR FLOAT
Scales the loaded flows by FLOAT
.TP
\fB\-\-vtype\fR STR
Defines the name of the vehicle type to
use
.TP
\fB\-\-prefix\fR STR
Defines the prefix for vehicle flow names
.TP
\fB\-\-timeline\fR STR[]
Uses STR[] as a timeline definition
.TP
\fB\-\-timeline\fR.day\-in\-hours
Uses STR as a 24h\-timeline definition
.TP
\fB\-\-additive\-traffic\fR
Keep traffic flows of all time slots in
the net
.TP
\fB\-\-assignment\-method\fR STR
Choose a assignment method: incremental,
UE or SUE
.TP
\fB\-\-tolerance\fR FLOAT
Use FLOAT as tolerance when checking for
SUE stability
.TP
\fB\-\-left\-turn\-penalty\fR FLOAT
Use left\-turn penalty FLOAT to calculate
link travel time when searching routes
.TP
\fB\-\-paths\fR INT
Use INTEGER as the number of paths needed
to be searched for each OD pair at each
iteration
.TP
\fB\-\-paths\fR.penalty FLOAT
Penalize existing routes with FLOAT to
find secondary routes
.TP
\fB\-\-upperbound\fR FLOAT
Use FLOAT as the upper bound to determine
auxiliary link cost
.TP
\fB\-\-lowerbound\fR FLOAT
Use FLOAT as the lower bound to determine
auxiliary link cost
.TP
\fB\-i\fR, \fB\-\-max\-iterations\fR INT
maximal number of iterations for new route
searching in incremental and stochastic
user assignment
.TP
\fB\-\-max\-inner\-iterations\fR INT
maximal number of inner iterations for
user equilibrium calculation in the
stochastic user assignment
.TP
\fB\-\-route\-choice\-method\fR STR
Choose a route choice method: gawron,
logit, or lohse
.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\-\-logit\fR.beta FLOAT
Use FLOAT as (c\-)logit's beta for the
commonality factor
.TP
\fB\-\-logit\fR.gamma FLOAT
Use FLOAT as (c\-)logit's gamma for the
commonality factor
.TP
\fB\-\-logit\fR.theta FLOAT
Use FLOAT as (c\-)logit's theta
.SS "Defaults Options:"
.TP
\fB\-\-flow\-output\fR.departlane STR
Assigns a default depart lane
.TP
\fB\-\-flow\-output\fR.departpos STR
Assigns a default depart position
.TP
\fB\-\-flow\-output\fR.departspeed STR
Assigns a default depart speed
.TP
\fB\-\-flow\-output\fR.arrivallane STR
Assigns a default arrival lane
.TP
\fB\-\-flow\-output\fR.arrivalpos STR
Assigns a default arrival position
.TP
\fB\-\-flow\-output\fR.arrivalspeed STR
Assigns a default arrival speed
.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 or selected topics
.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", "local", "auto" or "always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "local", "auto"
or "always")
.TP
\fB\-\-xml\-validation\fR.routes STR
Set schema validation scheme of SUMO route
inputs ("never", "local", "auto" or
"always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.TP
\fB\-\-aggregate\-warnings\fR INT
Aggregate warnings of the same type
whenever more than INT occur
.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
marouter \-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: Linux\-5.10.0\-19\-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
.br
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
.br
Eclipse SUMO marouter Version 1.15.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
This program may also be made available under the following Secondary
.br
Licenses when the conditions for such availability set forth in the Eclipse
.br
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
.br
SPDX\-License\-Identifier: EPL\-2.0 OR GPL\-2.0\-or\-later