ECLIPSE(1)

📦
version 1.27.1 · 7 versions
, in ubuntu stonking

💖 ECLIPSE(1) — the activitygen glow-up 💖

okay bestie, sit down, hydrate, because we're talking about Eclipse — aka the activitygen tool — and she's literally the main character of trip generation for SUMO, the microscopic multi-modal traffic simulation. this is the page from the ECLIPSE(1) manual, section 1, User Commands. let's get into it 💅

✨ NAME ✨

Eclipse — she generates routes of persons throughout a day, for the microscopic traffic simulation SUMO. no cap, that's the whole job description and she eats every time 🎀

🌸 SYNOPSIS 🌸

activitygen [OPTION]*

that's it. that's the vibe. options go in, trips come out. 🦋

👑 DESCRIPTION 👑

Eclipse SUMO activitygen 1.27.1

  • Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; <https://sumo.dlr.de>
  • Copyright (C) 2010-2012 Technische Universitaet Muenchen

so basically: she generates trips of persons throughout a day for the microscopic, multi-modal traffic simulation SUMO. that's the whole personality. iconic, honestly. 🌈

⚙️ Configuration Options: ⚙️

  • -c, --configuration-file FILE — loads the named config on startup. yes queen, bring your own setup ✨
  • -C, --save-configuration FILE — saves the current configuration into FILE, so you never have to remember it again 🫶
  • --save-configuration.relative — enforces relative paths when saving the configuration. no absolute-path drama allowed 💅
  • --save-template FILE — saves a configuration template (empty) into FILE. a little blank canvas, a fresh start 🎀
  • --save-schema FILE — saves the configuration schema into FILE
  • --save-commented — adds comments to saved template, configuration, or schema. commentary! we love a narrator 💬

📥 Input Options: 📥

  • -n, --net-file FILE — use FILE as the SUMO-network to create trips for. this is the map, bestie, we need the map 🗺️
  • -s, --stat-file FILE — loads the SUMO-statistics FILE

📤 Output Options: 📤

  • --write-license — include license info into every output file. receipts, but legal 🧾
  • --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. cute timestamp era ⏰
  • --output-suffix STR — suffix which is applied to all output files. the special string TIME is replaced by the current time. she matches the prefix, they're a set 💞
  • --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. sooo much more readable, we stan 🕐
  • -o, --output-file FILE — write generated trips to FILE

Processing Options:

(that's it. that's the section. she's empty. a mystery. we respect her privacy 🙈)

⏳ 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. she will tell you everything 💀
  • --print-options — prints option values before processing
  • -?, --help — prints this screen or selected topics. hi, this is me 📖
  • -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. ignorance is bliss, allegedly 🌸
  • --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. she is locked in 🔍

🎲 Random Number Options: 🎲

  • --random — initialises the random number generator with the current system time. chaos mode, let the universe decide ✨
  • --seed INT — initialises the random number generator with the given value. deterministic girlies, this one's for you

🔥 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>. (be nice, they're doing their best 🫶)

Build features: Linux-6.8.0-139-generic x86_64 GNU 15.3.0 None FMI Proj GUI Intl SWIG Eigen GDAL FFmpeg OSG GL2PS

  • Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; <https://sumo.dlr.de>
  • Copyright (C) 2010-2012 Technische Universitaet Muenchen

Eclipse SUMO activitygen 1.27.1 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

licensing lore drop. read it. it's not optional, bestie 😌

and that's the whole page, fr fr. this was Eclipse SUMO activitygen 1.27.1, from the ECLIPSE(1) manual, dated August 2026. go generate some trips, you absolute icon 💖✨🎀🦋👑

📦 where this page comes from