Scroll to navigation

SUMO(1) User Commands SUMO(1)

NAME

SUMO - Import O/D-matrices for macroscopic traffic assignment

SYNOPSIS

marouter [ OPTION]*

DESCRIPTION

SUMO marouter Version 0.28.0
Copyright (C) 2001-2016 DLR and contributors; http://sumo.dlr.de
Import O/D-matrices for macroscopic traffic assignment

Configuration Options:

-c, --configuration-file FILE
Loads the named config on startup
--save-configuration FILE
Saves current configuration into FILE
--save-template FILE
Saves a configuration template (empty) into FILE
--save-schema FILE
Saves the configuration schema into FILE
--save-commented
Adds comments to saved template, configuration, or schema

Input Options:

-n, --net-file FILE
Use FILE as SUMO-network to route on
-d, --additional-files FILE
Read additional network data (districts, bus stops) from FILE
-m, --od-matrix-files FILE
Loads O/D-files from FILE(s)
--od-amitran-files FILE
Loads O/D-matrix in Amitran format from FILE(s)
-r, --route-files FILE
Read sumo-routes or trips from FILE(s)
-w, --weight-files FILE
Read network weights from FILE(s)
--lane-weight-files FILE
Read lane-based network weights from FILE(s)
-x, --weight-attribute STR
Name of the xml attribute which gives the edge weight
--weight-adaption FLOAT
The travel time influence of prior intervals
--taz-param STR
Parameter key(s) defining source (and sink) taz

Output Options:

--output-prefix STR
Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
-o, --output-file FILE
Write flow definitions with route distributions to FILE
--vtype-output FILE
Write used vehicle types into separate FILE
--ignore-vehicle-type
Does not save vtype information
--netload-output FILE
Writes edge loads and final costs into FILE
--all-pairs-output FILE
Writes complete distance matrix into FILE
--exit-times
Write exit times (weights) for each edge

Processing Options:

--aggregation-interval TIME
Defines the time interval when aggregating single vehicle input; Defaults to one hour
--ignore-errors
Continue if a route could not be build
--max-alternatives INT
Prune the number of alternatives to INT
--weights.interpolate
Interpolate edge weights at interval boundaries
--weights.expand
Expand weights behind the simulation's end
--routing-algorithm STR
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
--bulk-routing.vtypes
Aggregate routing queries with the same origin for different vehicle types
--routing-threads INT
The number of parallel execution threads used for routing
--weight-period TIME
Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy
-s, --scale FLOAT
Scales the loaded flows by FLOAT
--vtype STR
Defines the name of the vehicle type to use
--prefix STR
Defines the prefix for vehicle flow names
--timeline STR
Uses STR as a timeline definition
--timeline.day-in-hours
Uses STR as a 24h-timeline definition
--additive-traffic
Keep traffic flows of all time slots in the net
--assignment-method STR
Choose a assignment method: incremental, UE or SUE
--tolerance FLOAT
Use FLOAT as tolerance when checking for SUE stability
--left-turn-penalty FLOAT
Use left-turn penalty FLOAT to calculate link travel time when searching routes
--paths INT
Use INTEGER as the number of paths needed to be searched for each OD pair at each iteration
--paths.penalty FLOAT
Penalize existing routes with FLOAT to find secondary routes
--upperbound FLOAT
Use FLOAT as the upper bound to determine auxiliary link cost
--lowerbound FLOAT
Use FLOAT as the lower bound to determine auxiliary link cost
-i, --max-iterations INT
maximal number of iterations for new route searching in incremental and stochastic user assignment
--max-inner-iterations INT
maximal number of inner iterations for user equilibrium calcuation in the stochastic user assignment
--route-choice-method STR
Choose a route choice method: gawron, logit, or lohse
--gawron.beta FLOAT
Use FLOAT as Gawron's beta
--gawron.a FLOAT
Use FLOAT as Gawron's a
--keep-all-routes
Save routes with near zero probability
--skip-new-routes
Only reuse routes from input, do not calculate new ones
--logit.beta FLOAT
Use FLOAT as (c-)logit's beta for the commonality factor
--logit.gamma FLOAT
Use FLOAT as (c-)logit's gamma for the commonality factor
--logit.theta FLOAT
Use FLOAT as (c-)logit's theta

Defaults Options:

--flow-output.departlane STR
Assigns a default depart lane
--flow-output.departpos STR
Assigns a default depart position
--flow-output.departspeed STR
Assigns a default depart speed
--flow-output.arrivallane STR
Assigns a default arrival lane
--flow-output.arrivalpos STR
Assigns a default arrival position
--flow-output.arrivalspeed STR
Assigns a default arrival speed

Time Options:

-b, --begin TIME
Defines the begin time; Previous trips will be discarded
-e, --end TIME
Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent

Report Options:

-v, --verbose
Switches to verbose output
--print-options
Prints option values before processing
-?, --help
Prints this screen
-V, --version
Prints the current version
-X, --xml-validation STR
Set schema validation scheme of XML inputs ("never", "auto" or "always")
--xml-validation.net STR
Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
-W, --no-warnings
Disables output of warnings
-l, --log FILE
Writes all messages to FILE (implies verbose)
--message-log FILE
Writes all non-error messages to FILE (implies verbose)
--error-log FILE
Writes all warnings and errors to FILE

Random Number Options:

--random
Initialises the random number generator with the current system time
--seed INT
Initialises the random number generator with the given value

EXAMPLES

marouter -c <CONFIGURATION>
run routing with options from file

REPORTING BUGS

Report bugs at <http://sumo.dlr.de/trac/>.
 
Get in contact via <sumo@dlr.de>.
 
Build features: x86_64-pc-linux-gnu InternalLanes DoublePrecision TRACI PROJ GDAL GUI
 
Copyright (C) 2001-2016 DLR and contributors; http://sumo.dlr.de
SUMO marouter Version 0.28.0 is part of SUMO.
 
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.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 
GNU General Public License for more details.
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
March 2017 SUMO marouter Version 0.28.0