.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.17.
.TH ECLIPSE "1" "January 2021" "Eclipse SUMO marouter Version 1.8.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.8.0
.IP
Copyright (C) 2001\-2020 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\-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\-d\fR, \fB\-\-additional\-files\fR FILE
Read additional network data (districts,
bus stops) from FILE
.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\-r\fR, \fB\-\-route\-files\fR FILE
Read sumo\-routes or 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\-\-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\-\-junction\-taz\fR
Initialize a TAZ for every junction to use
attributes toJunction and fromJunction
.SS "Output Options:"
.TP
\fB\-o\fR, \fB\-\-output\-file\fR FILE
Write flow definitions with route
distributions to FILE
.TP
\fB\-\-vtype\-output\fR FILE
Write used vehicle types into separate
FILE
.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\-\-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\-\-exit\-times\fR
Write exit times (weights) for each edge
.SS "Processing Options:"
.TP
\fB\-\-aggregation\-interval\fR TIME
Defines the time interval when aggregating
single vehicle input; Defaults to one hour
.TP
\fB\-\-max\-alternatives\fR INT
Prune the number of alternatives to INT
.TP
\fB\-\-weights\fR.interpolate
Interpolate edge weights at interval
boundaries
.TP
\fB\-\-weights\fR.expand
Expand weights behind the simulation's end
.TP
\fB\-\-weights\fR.priority\-factor FLOAT
Consider edge priorities in addition to
travel times, weighted by factor
.TP
\fB\-\-routing\-algorithm\fR STR
Select among routing algorithms
['dijkstra', 'astar', 'CH', 'CHWrapper']
.TP
\fB\-\-bulk\-routing\fR.vtypes
Aggregate routing queries with the same
origin for different vehicle types
.TP
\fB\-\-routing\-threads\fR INT
The number of parallel execution threads
used for routing
.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", "auto" or "always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "auto" or
"always")
.TP
\fB\-\-xml\-validation\fR.routes STR
Set schema validation scheme of SUMO route
inputs ("never", "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
.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\-4.19.0\-13\-amd64 x86_64 GNU 10.2.1 None Proj GUI SWIG GDAL FFmpeg OSG GL2PS Eigen
.br
Copyright (C) 2001\-2020 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
.br
Eclipse SUMO marouter Version 1.8.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