Eclipse SUMO jtrrouter v1_25_0+0045-28a3daf62ee
 Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Router for the microscopic, multi-modal traffic simulation SUMO based on
 junction turning ratios.

Usage: jtrrouter [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
  --junction-taz                      Initialize a TAZ for every junction to
                                       use attributes toJunction and
                                       fromJunction
  -t, --turn-ratio-files FILE         Read turning ratios from FILE(s)

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
  --write-metadata                    Write parsable metadata (configuration
                                       etc.) instead of comments
  --output-prefix STR                 Prefix which is applied to all output
                                       files. The special string 'TIME' is
                                       replaced by the current time.
  --output-suffix STR                 Suffix 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
  --output.compression STR            Defines the standard compression
                                       algorithm (currently only for parquet
                                       output)
  --output.format STR                 Defines the standard output format if not
                                       derivable from the file name ('xml',
                                       'csv', 'parquet')
  --output.column-header STR          How to derive column headers from
                                       attribute names ('none', 'tag', 'auto',
                                       'plain')
  --output.column-separator STR       Separator in CSV output
  -H, --human-readable-time           Write time values as hour:minute:second
                                       or day:hour:minute:second rather than
                                       seconds
  --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
  --unsorted-input                    Assume input is unsorted
  -s, --route-steps TIME              Load routes for the next number of
                                       seconds ahead
  --no-internal-links                 Disable (junction) internal links
  --randomize-flows                   generate random departure times for flow
                                       input
  --remove-loops                      Remove loops within the route;
                                       Remove turnarounds at start and end of
                                       the route
  --repair                            Tries to correct a false route
  --repair.from                       Tries to correct an invalid starting edge
                                       by using the first usable edge instead
  --repair.to                         Tries to correct an invalid destination
                                       edge by using the last usable edge
                                       instead
  --repair.max-detour-factor FLOAT    Backtrack on route if the detour is
                                       longer than the gap by FACTOR
  --mapmatch.distance FLOAT           Maximum distance when mapping input
                                       coordinates (fromXY etc.) to the road
                                       network
  --mapmatch.junctions                Match positions to junctions instead of
                                       edges
  --mapmatch.taz                      Match positions to taz instead of edges
  --bulk-routing                      Aggregate routing queries with the same
                                       origin
  --routing-threads INT               The number of parallel execution threads
                                       used for routing
  --restriction-params STR[]          Comma separated list of param keys to
                                       compare for additional restrictions
  --weights.minor-penalty FLOAT       Apply the given time penalty when
                                       computing routing costs for minor-link
                                       internal lanes
  --weights.tls-penalty FLOAT         Apply the given time penalty when
                                       computing routing costs across a traffic
                                       light
  --weights.turnaround-penalty FLOAT  Apply the given time penalty when
                                       computing routing costs for turnaround
                                       internal lanes
  --weights.reversal-penalty FLOAT    Apply the given time penalty when
                                       computing routing costs for train
                                       reversal. Negative values disable
                                       reversal
  --max-edges-factor FLOAT            Routes are cut off when the route edges
                                       to net edges ratio is larger than FLOAT
  -T, --turn-defaults STR[]           Use STR[] as default turn definition
  --sink-edges STR[]                  Use STR[] as list of sink edges
  -A, --accept-all-destinations       Whether all edges are allowed as sink
                                       edges
  -i, --ignore-vclasses               Ignore road restrictions based on vehicle
                                       class
  --allow-loops                       Allow to re-use a road
  -S, --sources-are-sinks             Use all source edges as sink edges.
  -D, --discount-sources              Subtract upstream flow when inserting a
                                       new flow. When option --sources-are-sinks
                                       is set, the upstream flow is limited to
                                       the value of the source flow and the
                                       remaining part terminates.

Defaults Options:
  --departlane STR                    Assigns a default depart lane
  --departpos STR                     Assigns a default depart position
  --departspeed STR                   Assigns a default depart speed
  --arrivallane STR                   Assigns a default arrival lane
  --arrivalpos STR                    Assigns a default arrival position
  --arrivalspeed STR                  Assigns a default arrival speed
  --defaults-override                 Defaults will override given values

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
  --log.timestamps                    Writes timestamps in front of all
                                       messages
  --log.processid                     Writes process ID in front of all
                                       messages
  --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:
  jtrrouter -c <CONFIGURATION>
    run with routing options defined in file

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