ECLIPSE(1)

📦
version 1.27.1 · 7 versions
, in ubuntu stonking

💖 ECLIPSE(1) — User Commands 💖

okay bestie, buckle up, because this is eclipse — a User Commands girlie from the ECLIPSE(1) universe — and she computes emissions by driving a time line using SUMO's emission models. yes, literally that. she's giving physics but make it ✨aesthetic✨.

🌸 NAME 🌸

Eclipse — computes emissions by driving a time line using SUMO's emission models 🚗💨

🦋 SYNOPSIS 🦋

emissionsDrivingCycle [OPTION]*

like. that's it. that's the whole vibe. you call her, you hand her some OPTIONs, she does the emissions math. periodt.

👑 DESCRIPTION 👑

Eclipse SUMO emissionsDrivingCycle 1.27.1

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

Computes emissions by driving a time line using SUMO's emission models. no cap, that's the entire job description. she takes a timeline, she runs it, she tells you what came out of the tailpipe (metaphorically, and also extremely literally). 🍓

⚙️ Configuration Options ⚙️

  • -c, --configuration-file FILE — Loads the named config on startup. like handing her your little starter pack 🎀
  • -C, --save-configuration FILE — Saves current configuration into FILE. girlboss move: she writes down what she's doing so you can do it again
  • --save-configuration.relative — Enforce relative paths when saving the configuration
  • --save-template FILE — Saves a configuration template (empty) into FILE. it's giving blank canvas 🎨
  • --save-schema FILE — Saves the configuration schema into FILE
  • --save-commented — Adds comments to saved template, configuration, or schema. she's annotating her own notes, iconic behavior

📥 Input Options 📥

  • -t, --timeline-file FILE — Defines the file to read the driving cycle from.
  • --timeline-file.skip INT — Skips the first NUM lines.
  • --timeline-file.separator STR — Defines the entry separator.
  • -n, --netstate-file FILE — Defines the netstate, route and trajectory files to read the driving cycles from.
  • --additional-files FILE — Load emission parameters (vTypes) from FILE(s)
  • -e, --emission-class STR — Defines for which emission class the emissions shall be generated.
  • --vtype STR — Defines the vehicle type to use for emission parameters.

🔥 Processing Options 🔥

  • -a, --compute-a — If set, the acceleration is computed instead of being read from the file. she does the math herself, main character energy fr fr
  • --compute-a.forward — If set, the acceleration for time t is computed from v(t+1) - v(t) instead of v(t) - v(t-1)
  • --compute-a.zero-correction — If set, the acceleration for time t is set to 0 if the speed is 0
  • -s, --skip-first — If set, the first line of the read file is skipped.
  • --kmh — If set, the given speed is interpreted as being given in km/h.
  • --have-slope — If set, the fourth column is read and used as slope (in deg).
  • --slope FLOAT — Sets a global slope (in deg) that is used if the file does not contain slope information.
  • --begin TIME — Defines the begin time in seconds;
  • --end TIME — Defines the end time in seconds;

💅 Output Options 💅

  • -o, --output STR — Defines the file to write the emission cycle results into.
  • --output.attributes STR[] — Defines the attributes to write.
  • --emission-output FILE — Save the emission values of each vehicle in XML
  • --sum-output FILE — Save the aggregated and normed emission values of each vehicle in CSV
  • --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.
  • --output-suffix STR — Suffix 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 🕰️ she learned to read a clock, we're so proud

🌈 Emissions Options 🌈

  • --emissions.volumetric-fuel — Return fuel consumption values in (legacy) unit l instead of mg
  • --phemlight-path FILE — Determines where to load PHEMlight definitions from
  • --phemlight-year INT — Enable fleet age modelling with the given reference year in PHEMlight5
  • --phemlight-temperature FLOAT — Set ambient temperature to correct NOx emissions in PHEMlight5

📢 Report Options 📢

  • -v, --verbose — Switches to verbose output. she's telling you EVERYTHING now 🗣️
  • --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
  • -q, --quiet — Not writing anything. she's silence. she's mystery. she's not telling you a single thing 🤫

🫶 REPORTING BUGS 🫶

found a bug? bestie, TELL HER. she wants to know. 💀

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 emissionsDrivingCycle 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

⚠️ heads up: that whole legal chunk above is not a joke section. it's the actual license situation and it means exactly what it says. read it. respect it. 💜

aaaand that's the whole page!! 🎀 this little legend comes to you from Eclipse SUMO emissionsDrivingC..., dated August 2026, and she lives at ECLIPSE(1) forever and ever. now go run her, bestie, she's been waiting 💖✨🦋

📦 where this page comes from