ECLIPSE(1)

📦

version 1.27.1 · 7 versions

🌸 ECLIPSE(1) — the glow-up edition 🌸

okay bestie, welcome to the ECLIPSE(1) manual page in the User Commands section 💅 this is the whole thing, nothing skipped, we're just doing it with flavor now ✨

💖 NAME 💖

Eclipse — no cap, it's the Importer of polygons and POIs for the traffic simulation SUMO 🦋

✨ SYNOPSIS ✨

polyconvert [OPTION]*

🎀 DESCRIPTION 🎀

So this is Eclipse SUMO polyconvert 1.27.1 👑

Importer of polygons and POIs for the microscopic, multi-modal traffic simulation SUMO 🌈

Basically, it takes polygons and points-of-interest from all kinds of sources and turns them into something SUMO can vibe with. Iconic behavior honestly 🙈

💅 Configuration Options: 💅

like the settings, but make them a file, yk?

-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 (no absolute-path drama)
--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 (thoughtful queen behavior 💭)

🌸 Input Options: 🌸

where the polygons come from, the source material, the lore 📖

-n, --net-file FILE — Loads SUMO-network FILE as reference to offset and projection 🗺️
--dlr-navteq-poly-files FILE — Reads polygons from FILE assuming they're coded in DLR-Navteq (Elmar)-format
--dlr-navteq-poi-files FILE — Reads pois from FILE assuming they're coded in DLR-Navteq (Elmar)-format
--visum-files FILE — Reads polygons from FILE assuming it's a Visum-net
--visum.language-file FILE — Load language mappings from FILE 🗣️
--xml-files FILE — Reads pois and shapes from FILE assuming they're coded in XML
--osm-files FILE — Reads pois from FILE assuming they're coded in OSM 🌍
--osm.keep-full-type — The type will be made of the key-value - pair
--osm.use-name — The id will be set from the given 'name' attribute ✨
--osm.merge-relations FLOAT — If FLOAT >= 0, assemble one polygon from all ways of a relation if they all connect with gaps below FLOAT 🧩
--geojson-files FILE — Reads shapes from geojson FILE
--shapefile-prefixes FILE — Reads shapes from shapefiles FILE
--shapefile.guess-projection — Guesses the shapefile's projection 🔮
--shapefile.traditional-axis-mapping — Use traditional axis order (lon, lat)
--shapefile.id-column STR — Defines in which column the id can be found
--shapefile.type-columns STR[] — Defines which columns form the type id (comma separated list)
--shapefile.use-running-id — A running number will be used as id 🔢
--shapefile.add-param — Extract all additional columns as params
--shapefile.fill STR — [auto|true|false]. Forces the 'fill' status to the given value. Default 'auto' tries to determine it from the data type
--type-file FILE — Reads types from FILE

🦋 Output Options: 🦋

the way it gives back 💖

--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 🙌
-o, --output-file FILE — Write generated polygons/pois to FILE
--dlr-tdp-output FILE — Write generated polygons/pois to a dlr-tdp file with the given prefix

🌈 Projection Options: 🌈

mapping the earth's whole curve situation onto a flat grid, nbd 🌍➡️📐

--simple-projection — Uses a simple method for projection
--proj.scale FLOAT — Scaling factor for input coordinates
--proj.rotate FLOAT — Rotation (clockwise degrees) for input coordinates 🔄
--proj.utm — Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
--proj.dhdn — Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid, "Gauss-Krueger")
--proj STR — Uses STR as proj.4 definition for projection
--proj.inverse — Inverses projection 🙃
--proj.dhdnutm — Convert from Gauss-Krueger to UTM
--proj.plain-geo — Write geo coordinates in output 📍

🍓 Pruning Options: 🍓

cutting stuff out, but tastefully ✂️

--prune.in-net — Enables pruning on net boundaries
--prune.in-net.offsets STR — Uses FLOAT,FLOAT,FLOAT,FLOAT as offset definition added to the net boundary. Positive values grow the boundary on all sides while negative values shrink it.
--prune.boundary STR — Uses STR as pruning boundary
--prune.keep-list STR — Items in STR will be kept though out of boundary (protected besties 🫶)
--prune.explicit STR[] — Items with names in STR[] will be removed

🧚 Processing Options: 🧚

the actual cooking 👩🍳

--offset.x FLOAT — Adds FLOAT to net x-positions
--offset.y FLOAT — Adds FLOAT to net y-positions
--offset.z FLOAT — Adds FLOAT to net z-positions
--all-attributes — Imports all attributes as key/value pairs 🔑
--ignore-errors — Continue on broken input (we don't stop for drama 💀)
--poi-layer-offset FLOAT — Adds FLOAT to the layer value for each poi (i.e. to raise it above polygons)
--flatten — Remove all z-data ⚖️

👑 Building Defaults Options: 👑

set it once, let it be the default, main character energy 💅

--color STR — Sets STR as default color 🎨
--prefix STR — Sets STR as default prefix
--type STR — Sets STR as default type
--fill — Fills polygons by default
--icon STR — Sets STR as default icon 📌
--layer FLOAT — Sets FLOAT as default layer
--discard — Sets default action to discard 🗑️

⭐ Report Options: ⭐

the yapping settings, respectfully 🗣️

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

💜 EXAMPLES 💜

here's the vibe, copy-paste ready 🫶

polyconvert -c <CONFIGURATION>

run with configuration options set in file ✨

🙈 REPORTING BUGS 🙈

Found a bug? not the vibe, tell the devs:

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

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

Eclipse SUMO polyconvert 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 ⚖️

ok that's literally the whole page, every flag, every default, every file, every license line, nothing cut 💯

and that's a wrap bestie 🎀 this was Eclipse SUMO polyconvert 1.27.1, dated August 2026, from the ECLIPSE(1) manual — periodt 💅✨🦋

📦 where this page comes from

ubuntu stonking: sumo 1.27.1+dfsg-1 · EPL-2.0 OR GPL-2.0-or-later
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-11-03: a language model's rewrite of the original, under its terms