Provided by: sumo_1.18.0+dfsg-3build1_amd64 bug

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-5.4.0-153-generic  x86_64 GNU 13.1.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