ECLIPSE(1)

📦
version 1.27.1 · 7 versions
, in ubuntu stonking

💖 ECLIPSE(1) — like, the od2trips era 💖

okay bestie, welcome to the User Commands corner of the manual. This is the page for Eclipse — aka the importer of O/D-matrices for the traffic simulation SUMO. Yes it's giving very serious-research-tool, but I'm gonna walk you through it like we're texting at 2am 🦋

✨ NAME ✨

Eclipse — Importer of O/D-matrices for the traffic simulation SUMO. That's it, that's the whole gig 💅

🌸 SYNOPSIS 🌸

od2trips [OPTION]*

🎀 DESCRIPTION 🎀

Eclipse SUMO od2trips 1.27.1

Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; https://sumo.dlr.de

So what does it do? It's the Importer of O/D-matrices for the microscopic, multi-modal traffic simulation — and obviously that simulation is SUMO. Lowkey iconic 🚗✨

⚙️ Configuration Options: (the setup era)

  • -c, --configuration-file FILE — loads the config you name right at startup. Your whole vibe, pre-loaded.
  • -C, --save-configuration FILE — saves your current configuration into FILE.
  • --save-configuration.relative — forces relative paths when it's saving the configuration. No absolute-path drama.
  • --save-template FILE — saves a configuration template (empty, a lil blank canvas 🎨) into FILE.
  • --save-schema FILE — saves the configuration schema into FILE.
  • --save-commented — adds comments to the saved template, configuration, or schema. Little notes to your future self 🫶

📥 Input Options: (feed me the data)

  • -n, --taz-files FILE — loads TAZ (that's districts, and yes 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 — defines the data attribute used for loading counts. The default is 'count', and honestly the default ate.

📤 Output Options: (here's what you get back)

  • --write-license — puts license info into every output file. Every single one. No skipping 💀
  • --write-metadata — writes parsable metadata (configuration etc.) instead of comments.
  • --output-prefix STR — a prefix applied to all output files. Special lil string: 'TIME' gets replaced by the current time ⏰
  • --output-suffix STR — same energy but at the end. And yes, 'TIME' also gets replaced by the current time.
  • --precision INT — how many digits after the comma for floating point output.
  • --precision.geo INT — how many digits after the comma for lon,lat output.
  • --output.compression STR — sets the standard compression algorithm (currently only for parquet output).
  • --output.format STR — sets the standard output format when it can't be derived from the file name. Your choices: 'xml', 'csv', 'parquet'.
  • --output.column-header STR — how to derive column headers from attribute names. Options: 'none', 'tag', 'auto', 'plain'.
  • --output.column-separator STR — the separator used in CSV output.
  • -H, --human-readable-time — writes time values as hour:minute:second or day:hour:minute:second instead of plain seconds. Way nicer to read, ngl.
  • -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.
  • --flow-output.poisson — writes poisson distributed flow instead of evenly spaced flow.
  • --pedestrians — writes pedestrians instead of vehicles 🚶
  • --persontrips — writes persontrips instead of vehicles.
  • --persontrips.modes STR[] — adds a modes attribute to personTrips.
  • --ignore-vehicle-type — does not save vtype information. Just doesn't. Bye 👋
  • --junctions — writes trips between junctions.

⏳ Time Options: (clock check)

  • -b, --begin TIME — defines the begin time. Heads up: previous trips will be discarded.
  • -e, --end TIME — defines the end time. Also dramatic: later trips will be discarded. Defaults to the maximum time that SUMO can represent. (Yes, that's absurdly far in the future. It's fine.)

🧠 Processing Options: (the actual brain work)

  • -s, --scale FLOAT — scales the loaded flows by FLOAT.
  • --spread.uniform — spreads trips uniformly over each time period.
  • --different-source-sink — always choose a source and sink edge that are not identical. No round-tripping to the same spot 🫠
  • --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 — disables console output of the current time step. For when the scrolling is too much 😭

🧸 Defaults Options: (the preset slay)

  • --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: (tell me everything)

  • -v, --verbose — switches to verbose output. Spill the tea ☕
  • --print-options — prints option values before processing.
  • -?, --help — prints this screen, or selected topics.
  • -V, --version — prints the current version.
  • -X, --xml-validation STR — sets the schema validation scheme for XML inputs: "never", "local", "auto" or "always".
  • -W, --no-warnings — disables output of warnings.
  • --aggregate-warnings INT — aggregates warnings of the same type whenever more than INT occur.
  • -l, --log FILE — writes all messages to FILE. (Also implies verbose, fyi.)
  • --message-log FILE — writes all non-error messages to FILE. (Also implies verbose.)
  • --error-log FILE — writes all warnings and errors to FILE.
  • --log.timestamps — writes timestamps in front of all messages.
  • --log.processid — writes the process ID in front of all messages.
  • --language STR — the language to use in messages 🌍
  • --ignore-errors — keeps going even on broken input. Chaotic but brave.

🎲 Random Number Options: (rng girlies rise)

  • --random — initialises the random number generator with the current system time.
  • --seed INT — initialises the random number generator with the value you give it.

🌈 EXAMPLES 🌈

okay here's the moment, the demo, the main character scene:

od2trips -c <CONFIGURATION>

run with configuration file. That's literally it. Chef's kiss 👑

🐛 REPORTING BUGS 🐛

Found something cursed? Report bugs at <https://github.com/eclipse-sumo/sumo/issues>.

Wanna get in contact? <sumo@dlr.de> — they're friendly, promise 🫶

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

Eclipse SUMO od2trips 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

okay that's the whole page bestie, go import some matrices 💖

Eclipse SUMO od2trips 1.27.1 — August 2026 — ECLIPSE(1) 🦋✨

📦 where this page comes from