Scroll to navigation

ECLIPSE(1) User Commands ECLIPSE(1)

NAME

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

SYNOPSIS

marouter [OPTION]*

DESCRIPTION

Eclipse SUMO marouter Version 1.15.0

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

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

Configuration Options:

Loads the named config on startup
Saves current configuration into FILE
Enforce relative paths when saving the configuration
Saves a configuration template (empty) into FILE
Saves the configuration schema into FILE
Adds comments to saved template, configuration, or schema

Input Options:

Use FILE as SUMO-network to route on
Read additional network data (districts, bus stops) from FILE(s)
Read sumo routes, alternatives, flows, and trips from FILE(s)
Determines where to load PHEMlight definitions from
Enable fleet age modelling with the given reference year in PHEMlight5
Set ambient temperature to correct NOx emissions in PHEMlight5
Read network weights from FILE(s)
Read lane-based network weights from FILE(s)
Name of the xml attribute which gives the edge weight
Initialize a TAZ for every junction to use attributes toJunction and fromJunction
Loads O/D-files from FILE(s)
Loads O/D-matrix in Amitran format from FILE(s)
Loads O/D-matrix in tazRelation format from FILE(s)
Define data attribute for loading counts (default 'count')
The travel time influence of prior intervals
Parameter key(s) defining source (and sink) taz
Ignore attributes 'fromTaz' and 'toTaz'

Output Options:

Write generated routes to FILE
Write used vehicle types into separate FILE
Keep vTypeDistribution ids when writing vehicles and their types
Return fuel consumption values in (legacy) unit l instead of mg
Write vehicles that reference routes by their id
Include license info into every output file
Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
Defines the number of digits after the comma for floating point output
Defines the number of digits after the comma for lon,lat output
Write time values as hour:minute:second or day:hour:minute:second rather than seconds
Does not save vtype information
Writes edge loads and final costs into FILE
Writes complete distance matrix into FILE
Write exit times (weights) for each edge

Processing Options:

Prune the number of alternatives to INT
Use origin and destination zones (districts) for in- and output
The number of parallel execution threads used for routing
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
Comma separated list of param keys to compare for additional restrictions
Interpolate edge weights at interval boundaries
Expand the end of the last loaded weight interval to infinity
Apply the given time penalty when computing routing costs for minor-link internal lanes
Defines the time interval when aggregating single vehicle input; Defaults to one hour
Ignore edge priorities when calculating capacities and restraints
Consider edge priorities in addition to travel times, weighted by factor
Aggregate routing queries with the same origin for different vehicle types
Aggregation period for the given weight files; triggers rebuilding of Contraction Hierarchy
Scales the loaded flows by FLOAT
Defines the name of the vehicle type to use
Defines the prefix for vehicle flow names
Uses STR[] as a timeline definition
Uses STR as a 24h-timeline definition
Keep traffic flows of all time slots in the net
Choose a assignment method: incremental, UE or SUE
Use FLOAT as tolerance when checking for SUE stability
Use left-turn penalty FLOAT to calculate link travel time when searching routes
Use INTEGER as the number of paths needed to be searched for each OD pair at each iteration
Penalize existing routes with FLOAT to find secondary routes
Use FLOAT as the upper bound to determine auxiliary link cost
Use FLOAT as the lower bound to determine auxiliary link cost
maximal number of iterations for new route searching in incremental and stochastic user assignment
maximal number of inner iterations for user equilibrium calculation in the stochastic user assignment
Choose a route choice method: gawron, logit, or lohse
Use FLOAT as Gawron's beta
Use FLOAT as Gawron's a
Save routes with near zero probability
Only reuse routes from input, do not calculate new ones
Use FLOAT as (c-)logit's beta for the commonality factor
Use FLOAT as (c-)logit's gamma for the commonality factor
Use FLOAT as (c-)logit's theta

Defaults Options:

Assigns a default depart lane
Assigns a default depart position
Assigns a default depart speed
Assigns a default arrival lane
Assigns a default arrival position
Assigns a default arrival speed

Time Options:

Defines the begin time; Previous trips will be discarded
Defines the end time; Later trips will be discarded; Defaults to the maximum time that SUMO can represent

Report Options:

Switches to verbose output
Prints option values before processing
-?, --help
Prints this screen or selected topics
Prints the current version
Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")
Set schema validation scheme of SUMO network inputs ("never", "local", "auto" or "always")
Set schema validation scheme of SUMO route inputs ("never", "local", "auto" or "always")
Disables output of warnings
Aggregate warnings of the same type whenever more than INT occur
Writes all messages to FILE (implies verbose)
Writes all non-error messages to FILE (implies verbose)
Writes all warnings and errors to FILE
Continue if a route could not be build
Defines how often statistics shall be printed
Disable console output of route parsing step

Random Number Options:

Initialises the random number generator with the current system time
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-5.10.0-19-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO marouter Version 1.15.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

December 2022 Eclipse SUMO marouter Version 1.15.0