Path: blob/main/tests/activitygen/meta/help/output.activitygen
169686 views
Eclipse SUMO activitygen v1_24_0+0753-7ddc191931e
Copyright (C) 2001-2025 German Aerospace Center (DLR) and others; https://sumo.dlr.de
Copyright (C) 2010-2012 Technische Universitaet Muenchen
Generates trips of persons throughout a day for the microscopic, multi-modal
traffic simulation SUMO.
Usage: activitygen [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 create trips for
-s, --stat-file FILE Loads the SUMO-statistics FILE
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 Write generated trips to FILE
Processing Options:
Time Options:
-b, --begin INT Sets the time of beginning of the simulation
during the first day (in seconds)
-e, --end INT Sets the time of ending of the simulation
during the last day (in seconds)
--duration-d INT Sets the duration of the simulation in days
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")
-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
--debug Detailed messages about every single 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:
activitygen --net-file <INPUT>.net.xml --stat-file <INPUT>.stat.xml --output <OUTPUT>.rou.xml --rand
generate a trips file from a stats file on a given net using arbitrary random seed
activitygen --net-file <INPUT>.net.xml --stat-file <INPUT>.stat.xml --output <OUTPUT>.rou.xml --duration-d <NBR_OF_DAYS>
generate a trips file from a stats file on a given net for numerous days (with fixed random seed)
Report bugs at <https://github.com/eclipse-sumo/sumo/issues>.
Get in contact via <[email protected]>.