Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
eclipse
GitHub Repository: eclipse/sumo
Path: blob/main/tests/od2trips/meta/help/output.od2trips
169686 views
Eclipse SUMO od2trips v1_24_0+0753-7ddc191931e
 Copyright (C) 2001-2025 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Importer of O/D-matrices for the microscopic, multi-modal traffic simulation
 SUMO.

Usage: od2trips [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, --taz-files FILE             Loads TAZ (districts;
                                    also from networks) from FILE(s)
  -d, --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')

Output Options:
  --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.
  --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
  -o, --output-file FILE           Writes trip definitions into FILE
  --flow-output FILE               Writes flow definitions into FILE
  --flow-output.probability        Writes probabilistic flow instead of evenly
                                    spaced flow
  --pedestrians                    Writes pedestrians instead of vehicles
  --persontrips                    Writes persontrips instead of vehicles
  --persontrips.modes STR[]        Add modes attribute to personTrips
  --ignore-vehicle-type            Does not save vtype information
  --junctions                      Writes trips between junctions

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

Processing Options:
  -s, --scale FLOAT                Scales the loaded flows by FLOAT
  --spread.uniform                 Spreads trips uniformly over each time
                                    period
  --different-source-sink          Always choose source and sink edge which are
                                    not identical
  --vtype STR                      Defines the name of the vehicle type to use
  --prefix STR                     Defines the prefix for vehicle names
  --timeline STR[]                 Uses STR[] as a timeline definition
  --timeline.day-in-hours          Uses STR as a 24h-timeline definition
  --no-step-log                    Disable console output of current time step

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

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")
  -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 on broken input

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:
  od2trips -c <CONFIGURATION>
    run with configuration file

Report bugs at <https://github.com/eclipse-sumo/sumo/issues>.
Get in contact via <[email protected]>.