.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH SUMO "1" "November 2016" "SUMO marouter Version 0.28.0" "User Commands"
.SH NAME
SUMO \- Import O/D-matrices for macroscopic traffic assignment
.SH SYNOPSIS
.B marouter
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
SUMO marouter Version 0.28.0
.IP
Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de
.PP
Import O/D\-matrices for macroscopic traffic assignment
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\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\-\-output\-prefix\fR STR
Prefix which is applied to all output
files. The special string 'TIME' is
replaced by the current time.
.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\-\-ignore\-errors\fR
Continue if a route could not be build
.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
.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 <http://sumo.dlr.de/trac/>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: x86_64\-pc\-linux\-gnu InternalLanes DoublePrecision TRACI PROJ GDAL GUI
.br
Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de
.PP
.br
SUMO marouter Version 0.28.0 is part of SUMO.
.br
SUMO is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.PP
.br
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
.br
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.br
GNU General Public License for more details.
.PP
.br
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/gpl.html