NAME

       Eclipse - Generates routes of persons throughout a day for the microscopic traffic simulation SUMO

SYNOPSIS

       activitygen [OPTION]*

DESCRIPTION

       Eclipse SUMO activitygen 1.25.0

              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.

   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)

REPORTING BUGS

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

              Build features: Linux-6.8.0-87-generic x86_64 GNU 15.2.0 None FMI Proj GUI Intl  SWIG  Eigen  GDAL
              FFmpeg OSG GL2PS
              Copyright (C) 2001-2025 German Aerospace Center (DLR) and others; https://sumo.dlr.de
              Copyright (C) 2010-2012 Technische Universitaet Muenchen

       Eclipse SUMO activitygen 1.25.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

Eclipse SUMO activitygen 1.25.0                   November 2025                                       ECLIPSE(1)