Provided by: sumo_1.18.0+dfsg-4build2_amd64 
NAME
Eclipse - Import O/D-matrices and trips using macroscopic traffic assignment for SUMO
SYNOPSIS
marouter [OPTION]*
DESCRIPTION
Eclipse SUMO marouter Version 1.18.0
Copyright (C) 2001-2023 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-configuration.relative
Enforce relative paths when saving the configuration
--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
-a, --additional-files FILE
Read additional network data (districts, bus stops) from FILE(s)
-r, --route-files FILE
Read sumo routes, alternatives, flows, and trips from FILE(s)
--phemlight-path FILE
Determines where to load PHEMlight definitions from
--phemlight-year INT
Enable fleet age modelling with the given reference year in PHEMlight5
--phemlight-temperature FLOAT
Set ambient temperature to correct NOx emissions in PHEMlight5
-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
--junction-taz
Initialize a TAZ for every junction to use attributes toJunction and fromJunction
-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)
-z, --tazrelation-files FILE
Loads O/D-matrix in tazRelation format from FILE(s)
--tazrelation-attribute STR
Define data attribute for loading counts (default 'count')
--weight-adaption FLOAT
The travel time influence of prior intervals
--taz-param STR[]
Parameter key(s) defining source (and sink) taz
--ignore-taz
Ignore attributes 'fromTaz' and 'toTaz'
Output Options:
-o, --output-file FILE
Write generated routes to FILE
--vtype-output FILE
Write used vehicle types into separate FILE
--keep-vtype-distributions
Keep vTypeDistribution ids when writing vehicles and their types
--emissions.volumetric-fuel
Return fuel consumption values in (legacy) unit l instead of mg
--named-routes
Write vehicles that reference routes by their id
--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
--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:
--max-alternatives INT
Prune the number of alternatives to INT
--with-taz
Use origin and destination zones (districts) for in- and output
--routing-threads INT
The number of parallel execution threads used for routing
--routing-algorithm STR
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
--restriction-params STR[]
Comma separated list of param keys to compare for additional restrictions
--weights.interpolate
Interpolate edge weights at interval boundaries
--weights.expand
Expand the end of the last loaded weight interval to infinity
--weights.minor-penalty FLOAT
Apply the given time penalty when computing routing costs for minor-link internal lanes
--aggregation-interval TIME
Defines the time interval when aggregating single vehicle input; Defaults to one hour
--capacities.default
Ignore edge priorities when calculating capacities and restraints
--weights.priority-factor FLOAT
Consider edge priorities in addition to travel times, weighted by factor
--bulk-routing.vtypes
Aggregate routing queries with the same origin for different vehicle types
--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", "local", "auto" or "always")
--xml-validation.net STR
Set schema validation scheme of SUMO network inputs ("never", "local", "auto" or "always")
--xml-validation.routes STR
Set schema validation scheme of SUMO route inputs ("never", "local", "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
--language STR
Language to use in messages
--ignore-errors
Continue if a route could not be build
--stats-period INT
Defines how often statistics shall be printed
--no-step-log
Disable console output of route parsing step
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-6.8.0-51-generic x86_64 GNU 14.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg
OSG GL2PS Eigen
Copyright (C) 2001-2023 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Eclipse SUMO marouter Version 1.18.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
This program may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse
Public License 2.0 are satisfied: GNU General Public License, version 2 or later which is available at
https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
Eclipse SUMO marouter Version 1.18.0 January 2025 ECLIPSE(1)