Eclipse SUMO marouter Version v1_14_1+1294-35e14935ffb
 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

Usage: marouter [OPTION]*
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
  --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

Report bugs at <https://github.com/eclipse/sumo/issues>.
Get in contact via <sumo@dlr.de>.
