.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH ECLIPSE "1" "February 2019" "Eclipse SUMO marouter Version 1.1.0" "User Commands"
.SH NAME
Eclipse \- Import O/D-matrices for macroscopic traffic assignment
.SH SYNOPSIS
.B marouter
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO marouter Version 1.1.0
.IP
Copyright (C) 2001\-2018 German Aerospace Center (DLR) and others; http://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
.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 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\-\-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\-\-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 calcuation 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
.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
.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: 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 marouter 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