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.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:

Loads the named config on startup
Saves current configuration into FILE
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
Loads O/D-files from FILE(s)
Loads O/D-matrix in Amitran format from FILE(s)
Read sumo-routes or trips from FILE(s)
Read network weights from FILE(s)
Read lane-based network weights from FILE(s)
Name of the xml attribute which gives the edge weight
The travel time influence of prior intervals
Parameter key(s) defining source (and sink) taz
Initialize a TAZ for every junction to use attributes toJunction and fromJunction

Output Options:

Write flow definitions with route distributions to FILE
Write used vehicle types into separate FILE
Does not save vtype information
Writes edge loads and final costs into FILE
Writes complete distance matrix into FILE
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
Write exit times (weights) for each edge

Processing Options:

Defines the time interval when aggregating single vehicle input; Defaults to one hour
Prune the number of alternatives to INT
Interpolate edge weights at interval boundaries
Expand weights behind the simulation's end
Consider edge priorities in addition to travel times, weighted by factor
Select among routing algorithms ['dijkstra', 'astar', 'CH', 'CHWrapper']
Aggregate routing queries with the same origin for different vehicle types
The number of parallel execution threads used for routing
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", "auto" or "always")
Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
Set schema validation scheme of SUMO route inputs ("never", "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

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-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