ECLIPSE(1)

📦

version 1.27.1 · 7 versions

Eclipse 💖 aka `ECLIPSE(1)`, a User Commands page

okay bestie, sit down, hydrate, because this is your road network importer / builder for the traffic simulation SUMO and it's a LOT. it's literally netconvert, and there's a whole manual for it. we're doing this together 🫶

🎀 NAME 🎀

Eclipse — the road network importer / builder for the traffic simulation SUMO. that's the whole vibe. that's the job.

✨ SYNOPSIS ✨

netconvert [OPTION]*

that's it. that's the incantation. give it options, get a network 👑

🌸 DESCRIPTION 🌸

Eclipse SUMO netconvert 1.27.1

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

Network importer / builder for the microscopic, multi-modal traffic simulation SUMO.

like. it takes all your road data — from OSM, from shapefiles, from Navteq, whatever — and it builds you an actual simulation-ready network. main character energy fr.

💅 Configuration Options:

the "how do we even remember all these flags" section. iconic honestly.

-c, --configuration-file FILE — loads up the named config for you the moment you start 📂
-C, --save-configuration FILE — saves whatever config you've currently got going into FILE
--save-configuration.relative — forces relative paths when it's saving a config, no absolute-path drama 🙈
--save-template FILE — saves an empty config template into FILE
--save-schema FILE — saves the configuration schema into FILE
--save-commented — adds comments to whatever you just saved (template, config, or schema). cute AND helpful ✨

🚗 Input Options:

where the roads come from. so many glow-ups available here.

-s, --sumo-net-file FILE — reads a SUMO-net from FILE
-n, --node-files FILE — reads XML-node defs from FILE
-e, --edge-files FILE — reads XML-edge defs from FILE
-x, --connection-files FILE — reads XML-connection defs from FILE
-i, --tllogic-files FILE — reads XML-traffic light defs from FILE 🚦
-t, --type-files FILE — reads XML-type defs from FILE
--ptstop-files FILE — reads public transport stops from FILE 🚌
--ptline-files FILE — reads public transport lines from FILE
--polygon-files FILE — reads polygons from FILE so they can be embedded into the network wherever that actually applies
--shapefile-prefix FILE — reads shapefiles (ArcView, Tiger, ...) out of the files that start with 'FILE'
--dlr-navteq-prefix FILE — reads converted Navteq GDF data (the unsplitted Elmar-network) from the path 'FILE'
--osm-files FILE — reads an OSM-network from the path 'FILE(s)' 🗺️
--opendrive-files FILE — reads an OpenDRIVE-network from FILE
--visum-file FILE — reads a VISUM-net from FILE
--vissim-file FILE — reads a VISSIM-net from FILE
--robocup-dir FILE — reads a RoboCup-net from DIR
--matsim-files FILE — reads a MATSim-net from FILE
--itsumo-files FILE — reads an ITSUMO-net from FILE
--heightmap.shapefiles FILE — reads the heightmap from an ArcGIS shapefile ⛰️
--heightmap.geotiff FILE — reads the heightmap from a GeoTIFF

👑 Output Options:

what you get out the other side. this is where you get to be picky.

--write-license — drops license info into every single output file you make
--write-metadata — writes parsable metadata (configuration and whatnot) instead of comments
--output-prefix STR — a prefix slapped onto all your output files. the special string 'TIME' gets swapped out for the current time 🕐
--output-suffix STR — a suffix slapped onto all your output files. the special string 'TIME' gets swapped out for the current time
--precision INT — sets how many digits after the comma you get for floating point output
--precision.geo INT — sets how many digits after the comma you get for lon,lat output
--output.compression STR — defines the standard compression algorithm (currently only a thing for parquet output)
--output.format STR — defines the standard output format when it can't just be figured out from the file name ('xml', 'csv', 'parquet')
--output.column-header STR — how column headers get derived from attribute names ('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 just seconds. so much more readable, no cap
-o, --output-file FILE — the generated net gets written to FILE
-p, --plain-output-prefix FILE — prefix of the files that the plain xml nodes, edges and connections get written to
--plain-output.lanes — writes out all lanes and their attributes, even the ones that aren't customized
--junctions.join-output FILE — writes info about joined junctions into FILE (you can load that right back in as an extra node-file to reproduce the joins)
--prefix STR — sets a prefix for edge and junction IDs
--prefix.junction STR — sets a prefix just for junction IDs
--prefix.edge STR — sets a prefix just for edge IDs
--amitran-output FILE — the generated net gets written to FILE using Amitran format
--matsim-output FILE — the generated net gets written to FILE using MATSim format
--opendrive-output FILE — the generated net gets written to FILE using OpenDRIVE format
--dlr-navteq-output FILE — the generated net gets written to dlr-navteq files with the given PREFIX
--dlr-navteq.version STR — which dlr-navteq output format version to write
--dlr-navteq.precision INT — the network coordinates get written at the output precision level you specify
--output.street-names — street names get included in the output (when they're available) 🛣️
--output.original-names — writes original names as a parameter, if they were given
--output.removed-nodes — writes the IDs of nodes removed via --geometry.remove into an edge param
--street-sign-output FILE — writes street signs as POIs into FILE
--ptstop-output FILE — writes public transport stops into FILE
--ptline-output FILE — writes public transport lines into FILE
--ptline-clean-up — cleans up pt stops that no line actually serves 🧹
--parking-output FILE — writes parking areas into FILE
--railway.topology.output FILE — analyzes the topology of the railway network 🚆
--polygon-output FILE — writes the shapes that got embedded in the network input and that polyconvert doesn't support (OpenDRIVE)
--opendrive-output.straight-threshold FLOAT — builds parameterized curves any time the angular change between straight segments goes over FLOAT degrees
--opendrive-output.lefthand-left — writes lanes in lefthand networks on the left side (positive indices)
--opendrive-output.shape-match-dist FLOAT — matches loaded shapes to the closest edge within FLOAT and exports them as road objects

🌈 Projection Options:

because the earth is round and your coordinate system is Not, and something has to give.

--simple-projection — uses a simple method for projection
--proj.scale FLOAT — scaling factor for input coordinates
--proj.rotate FLOAT — rotation (in clockwise degrees) for input coordinates
--proj.utm — figures out the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
--proj.dhdn — figures out the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid, aka "Gauss-Krueger")
--proj STR — uses STR as the proj.4 definition for projection
--proj.inverse — inverses the projection 🙃
--proj.dhdnutm — converts from Gauss-Krueger to UTM
--proj.plain-geo — writes geo coordinates in plain-xml

🔥 Processing Options:

the glow-up section. this is where the raw data becomes a real, drivable network.

--speed-in-kmh — vmax gets parsed as if it were given in km/h
--construction-date STR — use a YYYY-MM-DD date to figure out the readiness of features that are under construction 🚧
--flatten — removes ALL the z-data. flat. periodt
--plain.extend-edge-shape — if edge shapes don't end at the node positions, extends them
--numerical-ids — remaps alphanumerical IDs of nodes and edges so that every ID is an integer
--numerical-ids.node-start INT — remaps node IDs to integers starting at INT
--numerical-ids.edge-start INT — remaps edge IDs to integers starting at INT
--reserved-ids FILE — makes sure generated IDs don't collide with any of the typed IDs from FILE (sumo-gui selection file format)
--kept-ids FILE — makes sure that objects with typed IDs from FILE (sumo-gui selection file format) don't get renamed
--dismiss-vclasses — removes vehicle class restrictions from the imported edges
--geometry.split — splits edges across geometry nodes
-R, --geometry.remove — replaces nodes that only define edge geometry with geometry points (this joins edges together)
--geometry.remove.keep-edges.explicit STR[] — makes sure the given list of edges is left completely unmodified
--geometry.remove.keep-edges.input-file FILE — makes sure the edges in FILE are left unmodified (each id on its own line. selection files from sumo-gui also work here)
--geometry.remove.keep-ptstops — makes sure edges that have public transport stops on them are left unmodified
--geometry.remove.min-length FLOAT — allows merging edges that have differing attributes when their length is below min-length
--geometry.remove.width-tolerance FLOAT — allows merging edges with differing lane widths when the difference is below FLOAT
--geometry.remove.max-junction-size FLOAT — prevents removal of junctions whose size is above FLOAT, as defined by custom edge endpoints
--geometry.max-segment-length FLOAT — splits geometry to restrict segment length
--geometry.min-dist FLOAT — reduces geometry points that are too similar to each other
--geometry.max-angle FLOAT — warns you about edge geometries that have an angle above DEGREES in successive segments
--geometry.max-angle.fix — straightens out edge geometries that have an angle above max-angle between successive segments
--geometry.min-radius FLOAT — warns you about edge geometries with a turning radius less than METERS at the start or the end
--geometry.min-radius.fix — straightens edge geometries so you don't get turning radii under geometry.min-radius
--geometry.min-radius.fix.railways — straightens edge geometries so you don't get turning radii under geometry.min-radius (railways only)
--geometry.junction-mismatch-threshold FLOAT — warns you if the junction shape has drifted too far from the original node position
--geometry.check-overlap FLOAT — warns you if edges overlap by more than the given threshold value
--geometry.check-overlap.vertical-threshold FLOAT — ignores overlapping edges when they're separated vertically by the given threshold
--geometry.avoid-overlap — modifies edge geometries to dodge overlap at junctions
--join-lanes — joins adjacent lanes that have the same permissions and that don't allow lane-changing (think sidewalks and disallowed lanes)
--ptline.match-dist FLOAT — matches stops that sit outside the road network to the pt line they reference, when they're below the given distance

and yeah, that's not even all of it bestie 😭

--ptstop-output.no-bidi — skips automatic generation of stops on the bidi-edge of a loaded stop, bestie.
--geometry.max-grade FLOAT — Warns you about edge geometries with a grade in % above FLOAT.
--geometry.max-grade.fix — Smoothes edge geometries with a grade above the warning threshold. fix it, periodt 💅
--offset.disable-normalization — Turns off normalizing node positions.
--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.
--flip-y-axis — Flips the y-coordinate along zero. mirror moment 🪞
--roundabouts.guess — Enables roundabout-guessing. no cap 🌀
--roundabouts.guess.max-length FLOAT — Structures with a circumference above the FLOAT threshold are not classified as roundabout.
--roundabouts.visibility-distance FLOAT — Default visibility when approaching a roundabout.
--opposites.guess — Enables guessing of opposite direction lanes usable for overtaking.
--opposites.guess.fix-lengths — Ensures that opposite edges have the same length.
--fringe.guess — Enables guessing of network fringe nodes.
--fringe.guess.speed-threshold FLOAT — Guesses disconnected edges above the given speed as outer fringe.
--lefthand — Assumes left-hand traffic on the network. UK/Japan main character energy 🇬🇧
--edges.join — Merges edges which connect the same nodes and are close to each other. Recommended for VISSIM import, iykyk.
--speed.offset FLOAT — Modifies all edge speeds by adding FLOAT.
--speed.factor FLOAT — Modifies all edge speeds by multiplying by FLOAT.
--speed.minimum FLOAT — Modifies all edge speeds to at least FLOAT.
--edges.join-tram-dist FLOAT — Joins tram edges into road lanes with similar geometry, within FLOAT distance.

🎀 Building Defaults Options 🎀

-L, --default.lanenumber INT — The default number of lanes in an edge.
--default.lanewidth FLOAT — The default width of lanes.
--default.spreadtype STR — The default method for computing lane shapes from edge shapes.
-S, --default.speed FLOAT — The default speed on an edge, in m/s.
--default.friction FLOAT — The default friction on an edge.
-P, --default.priority INT — The default priority of an edge.
--default.type STR — The default edge type.
--default.sidewalk-width FLOAT — The default width of added sidewalks.
--default.bikelane-width FLOAT — The default width of added bike lanes.
--default.crossing-width FLOAT — The default width of a pedestrian crossing.
--default.crossing-speed FLOAT — The default speed 'limit' on a pedestrian crossing, in m/s.
--default.walkingarea-speed FLOAT — The default speed 'limit' on a pedestrian walkingarea, in m/s.
--default.allow STR — The default for allowed vehicle classes.
--default.disallow STR — The default for disallowed vehicle classes.
--default.junctions.keep-clear — Whether junctions should be kept clear by default.
--default.junctions.radius FLOAT — The default turning radius of intersections.
-j, --default.junctions.type STR — Determines default junction type from this iconic list: [traffic_light|priority|right_before_left|left_before_right|traffic_light_right_on_red|priority_stop|allway_stop|...]. See docs/Networks/PlainXML#node_types for the deets.
--default.connection-length FLOAT — The default length when overriding connection lengths.
--default.connection.cont-pos FLOAT — Whether/where connections should have an internal junction.
--default.right-of-way STR — The default algorithm for computing right of way rules: 'default', 'edgePriority'.

🚦 TLS Building Options 🚦

--tls.discard-loaded — Does not instantiate traffic lights loaded from other formats than plain-XML.
--tls.discard-simple — Does not instantiate traffic lights at geometry-like nodes loaded from other formats than plain-XML.
--tls.set STR[] — Interprets STR[] as a list of junctions to be controlled by TLS.
--tls.unset STR[] — Interprets STR[] as a list of junctions to be not controlled by TLS.
--tls.guess — Turns on TLS guessing.
--tls.guess.threshold FLOAT — Sets minimum value for the sum of all incoming lane speeds when guessing TLS.
--tls.taz-nodes — Sets district nodes as tls-controlled.
--tls.guess.joining — Includes node clusters into guess.
--tls.join — Tries to cluster tls-controlled nodes.
--tls.join-dist FLOAT — Determines the maximal distance for joining traffic lights. Defaults to 20.
--tls.join-exclude STR[] — Interprets STR[] as a list of tls ids to exclude from joining.
--tls.uncontrolled-within — Do not control edges that lie fully within a joined traffic light. This may cause collisions but allows old traffic light plans to be used. risky but nostalgic 😭
--tls.ignore-internal-junction-jam — Do not build mutually conflicting response matrix, potentially ignoring vehicles that are stuck at an internal junction when their phase has ended.
--tls.guess-signals — Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks.
--tls.guess-signals.dist FLOAT — Distance for interpreting nodes as signal locations.
--tls.guess-signals.slack INT — Number of uncontrolled entry edges to accept and still consider the central node as a traffic light.
--tls.cycle.time INT — Use INT as cycle duration.
--tls.green.time INT — Use INT as green phase duration.
-D, --tls.yellow.min-decel FLOAT — Defines smallest vehicle deceleration.
--tls.yellow.patch-small — Given yellow times are patched even if being too short.
--tls.yellow.time INT — Set INT as fixed time for yellow phase durations.
--tls.red.time INT — Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow.
--tls.allred.time INT — Set INT as fixed time for intermediate red phase after every switch.
--tls.minor-left.max-speed FLOAT — Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles.
--tls.left-green.time INT — Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases.
--tls.nema.vehExt INT — Set INT as fixed time for intermediate vehext phase after every switch.
--tls.nema.yellow INT — Set INT as fixed time for intermediate NEMA yellow phase after every switch.
--tls.nema.red INT — Set INT as fixed time for intermediate NEMA red phase after every switch.
--tls.crossing-min.time INT — Use INT as minimum green duration for pedestrian crossings (s).
--tls.crossing-clearance.time INT — Use INT as clearance time for pedestrian crossings (s).
--tls.scramble.time INT — Use INT as green phase duration for pedestrian scramble phase (s).
--tls.half-offset STR[] — TLSs in STR[] will be shifted by half-phase.
--tls.quarter-offset STR[] — TLSs in STR[] will be shifted by quarter-phase.
--tls.default-type STR — TLSs with unspecified type will use STR as their algorithm.
--tls.layout STR — Set phase layout four grouping opposite directions or grouping all movements for one incoming edge: ['opposites', 'incoming'].
--tls.no-mixed — Avoid phases with green and red signals for different connections from the same lane.
--tls.min-dur INT — Default minimum phase duration for traffic lights with variable phase length.
--tls.max-dur INT — Default maximum phase duration for traffic lights with variable phase length.
--tls.group-signals — Assign the same tls link index to connections that share the same states.
--tls.ungroup-signals — Assign a distinct tls link index to every connection.
--tls.rebuild — Rebuild all traffic light plans in the network. glow-up time ✨

🛣️ Ramp Guessing Options 🛣️

--ramps.guess — Enable ramp-guessing.
--ramps.guess-acceleration-lanes — Guess on-ramps and mark acceleration lanes if they exist but do not add new lanes.
--ramps.max-ramp-speed FLOAT — Treat edges with speed > FLOAT as no ramps.
--ramps.min-highway-speed FLOAT — Treat edges with speed < FLOAT as no highways.
--ramps.ramp-length FLOAT — Use FLOAT as ramp-length.
--ramps.min-weave-length FLOAT — Use FLOAT as minimum ramp-length.
--ramps.set STR[] — Tries to handle the given edges as ramps.
--ramps.unset STR[] — Do not consider the given edges as ramps.
--ramps.no-split — Avoids edge splitting.

🗑️ Edge Removal Options 🗑️

--keep-edges.min-speed FLOAT — Only keep edges with speed in meters/second > FLOAT.
--remove-edges.explicit STR[] — Remove edges in STR[].
--keep-edges.explicit STR[] — Only keep edges in STR[] or those which are kept due to other keep-edges or remove-edges options.
--keep-edges.input-file FILE — Only keep edges in FILE (each id on a single line. Selection files from sumo-gui are also supported) or those which are kept due to other keep-edges or remove-edges options.
--remove-edges.input-file FILE — Remove edges in FILE. Each id on a single line. Selection files from sumo-gui are also supported.
--keep-edges.postload — Remove edges after loading, patching and joining.
--keep-edges.in-boundary STR[] — Only keep edges which are located within the given boundary (given either as CARTESIAN corner coordinates <xmin,ymin,xmax,ymax> or as polygon <x0,y0,x1,y1,...>).
--keep-edges.in-geo-boundary STR[] — Only keep edges which are located within the given boundary (given either as GEODETIC corner coordinates <lon-min,lat-min,lon-max,lat-max> or as polygon <lon0,lat0,lon1,lat1,...>).
--keep-edges.by-vclass STR[] — Only keep edges which allow one of the vclasses in STR[].
--remove-edges.by-vclass STR[] — Remove edges which allow only vclasses from STR[].
--keep-edges.by-type STR[] — Only keep edges where type is in STR[].
--keep-edges.components INT — Only keep the INT largest weakly connected components.
--remove-edges.by-type STR[] — Removes every edge whose type is in STR[]. 💅 bye bye, edge bestie
--remove-edges.isolated — Removes isolated edges — like, no connections? not on my watch 🫶
--keep-lanes.min-width FLOAT — Only keeps lanes with width in meters greater than FLOAT. ✨ skinny lanes can go

Unregulated Nodes Options 💖

--keep-nodes-unregulated — All nodes will be unregulated. literally every single one, no cap 👑
--keep-nodes-unregulated.explicit STR[] — Do not regulate the nodes in STR[]. 🎀
--keep-nodes-unregulated.district-nodes — Do not regulate district nodes. 🦋

Junctions Options 🔥

--junctions.right-before-left.speed-threshold FLOAT — Allow building right-before-left junctions when the incoming edge speeds are below</p> FLOAT (m/s). 🚦
--junctions.left-before-right — Build left-before-right junctions instead of right-before-left junctions. plot twist 💅
--no-internal-links — Omits internal links. poof, gone ✨
--no-turnarounds — Disables building turnarounds. periodt 🛑
--no-turnarounds.tls — Disables building turnarounds at tls-controlled junctions. 🚧
--no-turnarounds.geometry — Disables building turnarounds at geometry-like junctions. 📐
--no-turnarounds.except-deadend — Disables building turnarounds except at dead end junctions. 💀
--no-turnarounds.except-turnlane — Disables building turnarounds except at junctions with a dedicated turning lane. 🛣️
--no-turnarounds.fringe — Disables building turnarounds at fringe junctions. 🌿
--no-left-connections — Disables building connections to left. left? denied 🙅‍♀️
--junctions.join — Joins junctions that are close to each other (recommended for OSM import). bestie, this is the OSM import glow-up 🫶
--junctions.join-dist FLOAT — Determines the maximal distance for joining junctions (defaults to 10). 📏
--junctions.join.parallel-threshold FLOAT — The angular threshold in degrees for rejection of parallel edges when joining junctions. 📐
--junctions.join-exclude STR[] — Interprets STR[] as list of junctions to exclude from joining. 🚫
--junctions.join-same FLOAT — Joins junctions that have similar coordinates even if not connected. twin flames but for coordinates 👯
--junctions.join-reset — Reset connections for joined junctions. fresh start ✨
--junctions.attach-removed FLOAT — Attach junction to the closest edge within FLOAT distance that has its id in param removedNodeIDs (for joining networks). 🔗
--max-join-ids INT — Abbreviate junction or TLS id if it joins more than INT junctions. short king behavior 👑
--junctions.corner-detail INT — Generate INT intermediate points to smooth out intersection corners. soft corners, soft life 🌸
--junctions.internal-link-detail INT — Generate INT intermediate points to smooth out lanes within the intersection. 🛣️✨
--junctions.scurve-stretch FLOAT — Generate longer intersections to allow for smooth s-curves when the number of lanes changes. s-curve slay 🐍
--junctions.join-turns — Builds common edges for turning connections with common from- and to-edge. This causes discrepancies between geometrical length and assigned length due to averaging but enables lane-changing while turning. ⚠️ tradeoffs, bestie
--junctions.limit-turn-speed FLOAT — Limits speed on junctions to an average lateral acceleration of at most FLOAT (m/s^2). 🏎️💨
--junctions.limit-turn-speed.min-angle FLOAT — Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius. 📐
--junctions.limit-turn-speed.min-angle.railway FLOAT — Do not limit turn speed for angular changes below FLOAT (degrees) on railway edges. The value is subtracted from the geometric angle before computing the turning radius. 🚂
--junctions.limit-turn-speed.warn.straight FLOAT — Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT. 🚨
--junctions.limit-turn-speed.warn.turn FLOAT — Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT. 🚨
--junctions.small-radius FLOAT — Default radius for junctions that do not require wide vehicle turns. 🚗
--junctions.higher-speed — Use maximum value of incoming and outgoing edge speed on junction instead of average. max it out 💅
--junctions.minimal-shape — Build junctions with minimal shapes (ignoring edge overlap). minimalism era 🎀
--junctions.endpoint-shape — Build junction shapes based on edge endpoints (ignoring edge overlap). 📍
--internal-junctions.vehicle-width FLOAT — Assumed vehicle width for computing internal junction positions. 🚙
--rectangular-lane-cut — Forces rectangular cuts between lanes and intersections. 📐📦
--check-lane-foes.roundabout — Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts). roundabout chaos theory 🌀
--check-lane-foes.all — Allow driving onto a multi-lane road if there are foes on other lanes (everywhere). everywhere, bestie 😭

Pedestrian Options 🚶‍♀️💖

--sidewalks.guess — Guess pedestrian sidewalks based on edge speed. psychic sidewalk vibes 🔮
--sidewalks.guess.max-speed FLOAT — Add sidewalks for edges with a speed equal or below the given limit. 🚶
--sidewalks.guess.min-speed FLOAT — Add sidewalks for edges with a speed above the given limit. 🚶‍♀️💨
--sidewalks.guess.from-permissions — Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed. permissions said yes, so we say yes 🫶
--sidewalks.guess.exclude STR[] — Do not guess sidewalks for the given list of edges. 🚫
--crossings.guess — Guess pedestrian crossings based on the presence of sidewalks. crossing couture ✨
--crossings.guess.speed-threshold FLOAT — At uncontrolled nodes, do not build crossings across edges with a speed above the threshold. 🛑
--crossings.guess.roundabout-priority — Give priority to guessed crossings at roundabouts. roundabout royalty 👑
--walkingareas — Always build walking areas even if there are no crossings. walking area main character energy 🚶‍♀️
--walkingareas.join-dist FLOAT — Do not create a walkingarea between sidewalks that are connected by a pedestrian junction within FLOAT. 📏

Bicycle Options 🚴‍♀️🌸

--bikelanes.guess — Guess bike lanes based on edge speed. bike lane intuition 🔮
--bikelanes.guess.max-speed FLOAT — Add bike lanes for edges with a speed equal or below the given limit. 🚲
--bikelanes.guess.min-speed FLOAT — Add bike lanes for edges with a speed above the given limit. 🚲💨
--bikelanes.guess.from-permissions — Add bike lanes for edges that allow bicycles on any of their lanes regardless of speed. permission granted, bestie ✅
--bikelanes.guess.exclude STR[] — Do not guess bikelanes for the given list of edges. 🚫

Railway Options 🚂💜

--railway.signals.discard — Discard all railway signal information loaded from other formats than plain-xml. plain-xml only, periodt 📦
--railway.topology.repair — Repair topology of the railway network. glow-up time 🛠️
--railway.topology.repair.minimal — Repair topology of the railway network just enough to let loaded public transport lines to work. minimal effort, maximal function 💅
--railway.topology.repair.connect-straight — Allow bidirectional rail use wherever rails with opposite directions meet at a straight angle. straight angle? bidirectional. slay 📐
--railway.topology.repair.stop-turn — Add turn-around connections at all loaded stops. 🔄
--railway.topology.repair.bidi-penalty FLOAT — Penalty factor for adding new bidi edges to connect public transport stops. ⚖️
--railway.topology.all-bidi — Make all rails usable in both direction. both ways, no cap 🚂🚂
--railway.topology.all-bidi.input-file FILE — Make all rails edge ids from FILE usable in both direction. 📄
--railway.topology.direction-priority — Set edge priority values based on estimated main direction. main character direction 👑
--railway.topology.ptline-priority STR[] — Set edge priority values based on public transport lines for the given list of vClasses. vClasses besties 🚌
--railway.topology.extend-priority — Extend loaded edge priority values based on estimated main direction. extend it, periodt ✨
--railway.geometry.straighten — Move junctions to straighten a sequence of rail edges. no more wonky rails 📏
--railway.signal.guess.by-stops — Guess signals that guard public transport stops. 🔮
--railway.signal.guess.by-stops.split — Split edges to improve positioning of guessed signals and prevent switches as rail_signals. rail_signals stays iconic 🚦
--railway.signal.permit-unsignalized STR[] — List rail classes that may run without rail signals. no signals? allowed for these classes 🎀
--railway.access-distance FLOAT — The search radius for finding suitable road accesses for rail stops. 🔎
--railway.max-accesses INT — The maximum road accesses registered per rail stops. maxxed out 🚧
--railway.access-factor FLOAT — The walking length of the access is computed as air-line distance multiplied by FLOAT. 🚶‍♀️📐

Formats Options 📂✨

--discard-params STR[] — Remove the list of keys from all params. 🗑️
--ignore-change-restrictions STR[] — List vehicle classes that may ignore lane changing restrictions ('all' discards all restrictions). 'all' means chaos mode 😭
--ignore-widths — Whether lane widths shall be ignored. widths? ignored 👀
--osm.skip-duplicates-check — Skips the check for duplicate nodes and edges. duplicate? don't care, didn't ask 🙈
--osm.elevation — Imports elevation data. up and down vibes 🏔️
--osm.layer-elevation FLOAT — Reconstruct (relative) elevation based on layer data. Each layer is raised by FLOAT m. 📚
--osm.layer-elevation.max-grade FLOAT — Maximum grade threshold in % at 50km/h when reconstructing elevation based on layer data. The value is scaled according to road speed. 50km/h core 🚗
--osm.oneway-spread-right — Whether one-way roads should be spread to the side instead of centered. side quest 🛣️
--osm.lane-access — Import lane-specific access restrictions. 🚧
--osm.bike-access — Import bike lanes and fix directions and permissions on bike paths. bike glow-up 🚲✨
--osm.sidewalks — Import sidewalks. 🚶‍♀️
--osm.oneway-reverse-sidewalk — Default to building two sidewalks on oneway streets (may affect divided roads). ⚠️ maybe affects divided roads, bestie
--osm.crossings — Import crossings. 🚸
--osm.turn-lanes — Import turning arrows from OSM to help with connection building. arrows slay ➡️
--osm.stop-output.length FLOAT — The default length of a public transport stop in FLOAT m. 🚏
--osm.stop-output.length.bus FLOAT — The default length of a bus stop in FLOAT m. 🚌
--osm.stop-output.length.tram FLOAT — The default length of a tram stop in FLOAT m. 🚊
--osm.stop-output.length.train FLOAT — The default length of a train stop in FLOAT m. 🚆
--osm.railsignals STR[] — Specify custom rules for importing railway signals. custom rules era 🚦
--osm.all-attributes — Whether additional attributes shall be imported. all the attributes, no cap 💅
--osm.extra-attributes STR[] — extra attributes bestie, like a whole list of them, that get imported from OSM through osm.all-attributes (set it to 'all' if you want literally everything imported 🌍)
--osm.speedlimit-none FLOAT — the speed limit to use when there's, uh, actually no real speed limit in reality
--osm.annotate-defaults — do we want edges to carry info about whether typemap defaults got used? this says yes
--matsim.keep-length — the edge lengths that came in the MATSim file stay exactly as they are, no touchy 🚫
--matsim.lanes-from-capacity — the lane number gets computed from the capacity
--shapefile.street-id STR — read edge ids from column STR
--shapefile.from-id STR — read from-node ids from column STR
--shapefile.to-id STR — read to-node ids from column STR
--shapefile.type-id STR — read type ids from column STR
--shapefile.laneNumber STR — read lane number from column STR
--shapefile.speed STR — read speed from column STR
--shapefile.length STR — read custom edge length from column STR
--shapefile.width STR — read total edge width from column STR
--shapefile.name STR — read that (non-unique) name from column STR
--shapefile.node-join-dist FLOAT — distance threshold for deciding whether distinct shapes are connected (used when from-id and to-id aren't available)
--shapefile.add-params STR[] — add that list of field names as edge params
--shapefile.use-defaults-on-failure — falls back on edge type defaults when things go wrong
--shapefile.all-bidirectional — insert edges in both directions, both ways, periodt
--shapefile.guess-projection — guess the proper projection
--shapefile.traditional-axis-mapping — use traditional axis order (lon, lat)
--dlr-navteq.tolerant-permissions — allow more vehicle classes by default
--dlr-navteq.keep-length — the edge lengths from the DLR Navteq-file stay untouched
--vissim.join-distance FLOAT — structure join offset
--vissim.default-speed FLOAT — use FLOAT as the default speed
--vissim.speed-norm FLOAT — factor for edge velocity
--vissim.report-unset-speeds — writes out lanes that don't have an explicit speed set
--visum.language-file FILE — load language mappings from FILE
--visum.use-type-priority — uses priorities from types
--visum.use-type-laneno — uses lane numbers from types
--visum.use-type-speed — uses speeds from types
--visum.connector-speeds FLOAT — sets connector speed
--visum.connectors-lane-number INT — sets connector lane number
--visum.no-connectors — excludes connectors entirely 🙅
--visum.recompute-lane-number — computes the number of lanes from the edges' capacities
--visum.verbose-warnings — prints all the warnings, and some of those are literally just VISUM misbehaving 😭
--visum.lanes-from-capacity.norm FLOAT — the factor for flow → number-of-lanes conversion
--opendrive.import-all-lanes — imports all lane types
--opendrive.curve-resolution FLOAT — the geometry resolution in m when importing curved geometries as line segments
--opendrive.advance-stopline FLOAT — lets stop lines be built beyond the start of the junction, if the geometries allow it
--opendrive.min-width FLOAT — the minimum lane width for figuring out the start or end of variable-width lanes
--opendrive.internal-shapes — import internal lane shapes
--opendrive.position-ids — sets edge-id based on road-id and offset in m (legacy, iykyk)
--opendrive.lane-shapes — use custom lane shapes to compensate for discarded lane types
--opendrive.signal-groups — use the OpenDRIVE controller information for the generated signal program
--opendrive.ignore-misplaced-signals — ignore traffic signals that don't control any driving lane

👑 Report Options

-v, --verbose — switches to verbose output, so you see literally everything
--print-options — prints option values before processing
-?, --help — prints this screen, or selected topics if you give it topics
-V, --version — prints the current version
-X, --xml-validation STR — set the schema validation scheme for XML inputs ("never", "local", "auto" or "always")
--xml-validation.net STR — set the schema validation scheme for 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 of them show up
-l, --log FILE — writes all messages to FILE (and yes, this implies verbose)
--message-log FILE — writes all non-error messages to FILE (implies verbose too)
--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 — language to use in messages 🌐
--ignore-errors — continue on broken input, we stay unbothered 💅
--ignore-errors.connections — continue on invalid connections
--show-errors.connections-first-try — show errors in connections at parsing
--ignore-errors.edge-type — continue on unknown edge types

🎲 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

okay bestie, here's how it actually looks in the wild:

netconvert -c <CONFIGURATION>

generate net with options read from file ✨

netconvert -n ./nodes.xml -e ./edges.xml -v -t ./owntypes.xml

generate net with given nodes, edges, and edge types doing verbose output

🫶 REPORTING BUGS

Found a bug? That's on purpose so we can fix it (jk). 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 netconvert 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

and that's the whole page, bestie 💖 this was Eclipse SUMO netconvert 1.27.1, dated August 2026, filed under ECLIPSE(1) — go build some iconic networks, no cap 🎀✨

📦 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-02: a language model's rewrite of the original, under its terms