NAME

Eclipse - Import O/D-matrices and trips using macroscopic traffic assignment for SUMO

SYNOPSIS

marouter [OPTION]*

DESCRIPTION

Eclipse SUMO marouter Version 1.8.0

: Copyright (C) 2001-2020 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Import O/D-matrices for macroscopic traffic assignment to generate SUMO routes

Configuration Options:

-c, --configuration-file FILE: Loads the named config on startup
-C, --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
--junction-taz: Initialize a TAZ for every junction to use attributes toJunction and fromJunction

Output Options:

-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
--write-license: Include license info into every output file
--output-prefix STR: Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
--precision INT: Defines the number of digits after the comma for floating point output
--precision.geo INT: Defines the number of digits after the comma for lon,lat output
-H, --human-readable-time: Write time values as hour:minute:second or day:hour:minute:second rather than seconds
--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
--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
--weights.priority-factor FLOAT: Consider edge priorities in addition to travel times, weighted by factor
--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 calculation 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 or selected topics
-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")
--xml-validation.routes STR: Set schema validation scheme of SUMO route inputs ("never", "auto" or "always")
-W, --no-warnings: Disables output of warnings
--aggregate-warnings INT: Aggregate warnings of the same type whenever more than INT occur
-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
--ignore-errors: Continue if a route could not be build

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 <https://github.com/eclipse/sumo/issues>.
Get in contact via <sumo@dlr.de>.

: Build features: Linux-4.19.0-13-amd64 x86_64 GNU 10.2.1 None Proj GUI SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2020 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO marouter Version 1.8.0 is part of SUMO.
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
SPDX-License-Identifier: EPL-2.0

January 2021

Eclipse SUMO marouter Version 1.8.0