ECLIPSE(1)
💖 ECLIPSE(1) — the netedit glow-up 💖
okay bestie, gather round, because this is the manual page for eclipse, living in the User Commands section of your man pages, bestie. it's giving "i open the graphical editor and suddenly it's 3am" energy. let's get into it 🫶
✨ NAME ✨
Eclipse — road network editor for the traffic simulation SUMO 🌸
✨ SYNOPSIS ✨
netedit [OPTION]*✨ DESCRIPTION ✨
literally the icon itself:
Eclipse SUMO netedit 1.27.1 💅
Copyright (C) 2001-2026 German Aerospace Center (DLR) and others; https://sumo.dlr.de
and what does it do, you ask? it's the graphical editor for SUMO networks, demand and additional infrastructure. no cap, that's the whole vibe — you point, you click, you build a whole city's worth of roads. iconique. 👑
🎀 Configuration Options: 🎀
the "getting set up" section. your config, your rules.
-c,--configuration-fileFILE — loads the named config on startup. it's giving "preferences, but make it a file."-C,--save-configurationFILE — saves current configuration into FILE. freeze that moment, bestie 📸--save-configuration.relative— enforce relative paths when saving the configuration. no absolute-path drama please.--save-templateFILE — saves a configuration template (empty) into FILE. a blank canvas, a fresh start 🦋--save-schemaFILE — saves the configuration schema into FILE--save-commented— adds comments to saved template, configuration, or schema. not me annotating everything like it's a group chat 💀
🌈 Input Options: 🌈
where your data comes from. feed her, she's hungry.
--netecfg-fileFILE — load netedit config--sumocfg-fileFILE — load sumo config--netccfg-fileFILE — load netconvert config-a,--additional-filesFILE — load additional and shapes descriptions from FILE(s)-r,--route-filesFILE — load demand elements descriptions from FILE(s)-d,--data-filesFILE — load data elements descriptions from FILE(s)-m,--meandata-filesFILE — load meanData descriptions from FILE(s)--ignore-missing-inputs— reset path values (additional, route, data...) after loading netedit config. it's giving "forget what you saw, we start over" 🙈--autosave-netconvert-file— if enabled, automatically save a netconvert configuration after saving a netedit config. main character energy that does your homework for you ✨--selection-fileFILE — load element selection--test-fileFILE — test file-s,--sumo-net-fileFILE — read SUMO-net from FILE-n,--node-filesFILE — read XML-node defs from FILE-e,--edge-filesFILE — read XML-edge defs from FILE-x,--connection-filesFILE — read XML-connection defs from FILE-i,--tllogic-filesFILE — read XML-traffic light defs from FILE-t,--type-filesFILE — read XML-type defs from FILE--shapefile-prefixFILE — read shapefiles (ArcView, Tiger, ...) from files starting with'FILE'--dlr-navteq-prefixFILE — read converted Navteq GDF data (unsplitted Elmar-network) from path'FILE'--osm-filesFILE — read OSM-network from path'FILE(s)'--opendrive-filesFILE — read OpenDRIVE-network from FILE--visum-fileFILE — read VISUM-net from FILE--vissim-fileFILE — read VISSIM-net from FILE--robocup-dirFILE — read RoboCup-net from DIR 🏆--matsim-filesFILE — read MATSim-net from FILE--itsumo-filesFILE — read ITSUMO-net from FILE--heightmap.shapefilesFILE — read heightmap from ArcGIS shapefile--heightmap.geotiffFILE — read heightmap from GeoTIFF
💜 Output Options: 💜
everything you produce and where it goes. the "posting the content" arc.
--tls-fileFILE — file in which TLS Programs must be saved--edgetypes-fileFILE — file in which edgeTypes must be saved--write-license— include license info into every output file. cite your sources, bestie 📝--write-metadata— write parsable metadata (configuration etc.) instead of comments--output-prefixSTR — prefix which is applied to all output files. The special string'TIME'is replaced by the current time. ⏰--output-suffixSTR — suffix which is applied to all output files. The special string'TIME'is replaced by the current time. ⏰--precisionINT — defines the number of digits after the comma for floating point output--precision.geoINT — defines the number of digits after the comma for lon,lat output--output.compressionSTR — defines the standard compression algorithm (currently only for parquet output)--output.formatSTR — defines the standard output format if not derivable from the file name ('xml','csv','parquet')--output.column-headerSTR — how to derive column headers from attribute names ('none','tag','auto','plain')--output.column-separatorSTR — separator in CSV output-H,--human-readable-time— write time values ashour:minute:secondorday:hour:minute:secondrather than seconds. so you can actually read it, we love that for us 💅-o,--output-fileFILE — the generated net will be written to FILE-p,--plain-output-prefixFILE — prefix of files to write plain xml nodes, edges and connections to--plain-output.lanes— write all lanes and their attributes even when they are not customized--junctions.join-outputFILE — writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins ⚠️ — note the original has an unclosed paren there, we don't gatekeep, we just report)--prefixSTR — defines a prefix for edge and junction IDs--prefix.junctionSTR — defines a prefix for junction IDs--prefix.edgeSTR — defines a prefix for edge IDs--amitran-outputFILE — the generated net will be written to FILE using Amitran format--matsim-outputFILE — the generated net will be written to FILE using MATSim format--opendrive-outputFILE — the generated net will be written to FILE using OpenDRIVE format--dlr-navteq-outputFILE — the generated net will be written to dlr-navteq files with the given PREFIX--dlr-navteq.versionSTR — the dlr-navteq output format version to write--dlr-navteq.precisionINT — the network coordinates are written with the specified level of output precision--output.street-names— street names will be included in the output (if available)--output.original-names— writes original names, if given, as parameter--output.removed-nodes— writes IDs of nodes remove with--geometry.removeinto edge param--street-sign-outputFILE — writes street signs as POIs to FILE--ptstop-outputFILE — writes public transport stops to FILE 🚌--ptline-outputFILE — writes public transport lines to FILE--ptline-clean-up— clean-up pt stops that are not served by any line. ghost stops, be gone 💀--parking-outputFILE — writes parking areas to FILE 🅿️--railway.topology.outputFILE — analyze topology of the railway network 🚆--polygon-outputFILE — write shapes that are embedded in the network input and that are not supported by polyconvert (OpenDRIVE)--opendrive-output.straight-thresholdFLOAT — builds parameterized curves whenever the angular change between straight segments exceeds FLOAT degrees--opendrive-output.lefthand-left— write lanes in lefthand networks on the left side (positive indices)--opendrive-output.shape-match-distFLOAT — match loaded shapes to the closest edge within FLOAT and export as road objects
🦋 Projection Options: 🦋
where on the planet are we, actually.
--simple-projection— uses a simple method for projection--proj.scaleFLOAT — scaling factor for input coordinates--proj.rotateFLOAT — 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")--projSTR — 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 plain-xml
👑 Processing Options: 👑
the glow-up station. this is where the network gets transformed.
--default.action-step-lengthFLOAT — length of the default interval length between action points for the car-following and lane-change models (in seconds). If not specified, the simulation step-length is used per default. Vehicle- or VType-specific settings override the default. Must be a multiple of the simulation step-length.--default.speeddevFLOAT — select default speed deviation. A negative value implies vClass specific defaults (0.1 for the default passenger class)--speed-in-kmh—vmaxis parsed as given in km/h 🚗--construction-dateSTR — useYYYY-MM-DDdate to determine the readiness of features under construction--flatten— remove all z-data. flat like my emotional range when debugging 🫠--plain.extend-edge-shape— if edge shapes do not end at the node positions, extend them--numerical-ids— remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers--numerical-ids.node-startINT — remaps IDs of nodes to integers starting at INT--numerical-ids.edge-startINT — remaps IDs of edges to integers starting at INT--reserved-idsFILE — ensures that generated ids do not included any of the typed IDs from FILE (sumo-gui selection file format)--kept-idsFILE — ensures that objects with typed IDs from FILE (sumo-gui selection file format) are not renamed--dismiss-vclasses— removes vehicle class restrictions from imported edges--geometry.split— splits edges across geometry nodes-R,--geometry.remove— replace nodes which only define edge geometry by geometry points (joins edges)--geometry.remove.keep-edges.explicitSTR[] — ensure that the given list of edges is not modified--geometry.remove.keep-edges.input-fileFILE — ensure that the edges in FILE are not modified (Each id on a single line. Selection files from sumo-gui are also supported)--geometry.remove.keep-ptstops— ensure that edges with public transport stops are not modified--geometry.remove.min-lengthFLOAT — allow merging edges with differing attributes when their length is below min-length--geometry.remove.width-toleranceFLOAT — allow merging edges with differing lane widths if the difference is below FLOAT--geometry.remove.max-junction-sizeFLOAT — prevent removal of junctions with a size above FLOAT as defined by custom edge endpoints--geometry.max-segment-lengthFLOAT — splits geometry to restrict segment length--geometry.min-distFLOAT — reduces too similar geometry points--geometry.max-angleFLOAT — warn about edge geometries with an angle above DEGREES in successive segments
and that's where part 1 wraps, bestie — there's more coming, don't go anywhere 🧚
--geometry.max-angle.fix— Straightens edge geometries with an angle abovemax-anglesuccessive segments. No cap. ✨--geometry.min-radius FLOAT— Heads up: warns about edge geometries with a turning radius less than METERS at the start or end. It's giving safety check. 🦋--geometry.min-radius.fix— Straightens edge geometries to avoid turning radii less thangeometry.min-radius. Slay. 💅--geometry.min-radius.fix.railways— Same energy as above but only railways: straightens edge geometries to avoid turning radii less thangeometry.min-radius. 🚂--geometry.junction-mismatch-threshold FLOAT— Warns if the junction shape is too far away from the original node position. 😭--geometry.check-overlap FLOAT— Warns if edges overlap by more than the given threshold value. 🔥--geometry.check-overlap.vertical-threshold FLOAT— Ignores overlapping edges if they are separated vertically by the given threshold. 🙈--geometry.avoid-overlap— Modifies edge geometries to avoid overlap at junctions. Periodt. ✨--join-lanes— Joins adjacent lanes that have the same permissions and which do not admit lane-changing (sidewalks and disallowed lanes). 👑--ptline.match-dist FLOAT— Matches stops outside the road network to the referencing pt line when below the given distance. 🧚--ptstop-output.no-bidi— Skips automatic generation of stops on the bidi-edge of a loaded stop. 💀--geometry.max-grade FLOAT— Warns about edge geometries with a grade in % above FLOAT. ⚠️--geometry.max-grade.fix— Smooths edge geometries with a grade above the warning threshold. 🌈--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. 🔄--roundabouts.guess— Enables roundabout-guessing. 🌀--roundabouts.guess.max-length FLOAT— Structures with a circumference above 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. 🚗--edges.join— Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import). Lowkey iconic. 💖--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. Options:[traffic_light|priority|right_before_left|left_before_right|traffic_light_right_on_red|priority_stop|allway_stop|...](seedocs/Networks/PlainXML#node_types). 🚦--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 list of junctions to be controlled by TLS. 📋--tls.unset STR[]— Interprets STR[] as 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 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. ⚠️--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. 🛠️
✨ 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-fileFILE — bestie, this one is a whitelist: only keep the edges that are listed in FILE (one id per line, and yes the selection files that sumo-gui spits out are supported too 💖), plus any edges that survive thanks to your other--keep-edgesor--remove-edgesoptions.--remove-edges.input-fileFILE — the opposite vibe ✨ remove the edges listed in FILE. Each id goes on its own line, and sumo-gui selection files are supported here as well.--keep-edges.postload— do the edge-removal after loading, patching and joining instead of before. Order of operations really is everything, no cap.--keep-edges.in-boundarySTR[] — only keep edges that live inside the boundary you hand it. Pass it either as CARTESIAN corner coordinates<xmin,ymin,xmax,ymax>or as a polygon<x0,y0,x1,y1,...>📐--keep-edges.in-geo-boundarySTR[] — same idea but make it GEODETIC 🌍 give it corner coordinates<lon-min,lat-min,lon-max,lat-max>or a polygon<lon0,lat0,lon1,lat1,...>.--keep-edges.by-vclassSTR[] — only keep edges that allow at least one of the vclasses in STR[].--remove-edges.by-vclassSTR[] — remove edges that allow only vclasses from STR[].--keep-edges.by-typeSTR[] — only keep edges where the type is in STR[].--keep-edges.componentsINT — keep only the INT largest weakly connected components. Survival of the connected-est fr fr.--remove-edges.by-typeSTR[] — remove edges where the type is in STR[].--remove-edges.isolated— yeets the isolated edges. They had nobody, it's giving lonely.--keep-lanes.min-widthFLOAT — only keep lanes whose width in meters is> FLOAT.
🛣️ Unregulated Nodes Options
--keep-nodes-unregulated— all nodes will be unregulated. Every single one. Periodt.--keep-nodes-unregulated.explicitSTR[] — don't regulate the nodes in STR[].--keep-nodes-unregulated.district-nodes— don't regulate district nodes 🫶
💅 Junctions Options
--junctions.right-before-left.speed-thresholdFLOAT — allows building right-before-left junctions when the incoming edge speeds are below FLOAT (m/s).--junctions.left-before-right— build left-before-right junctions instead of the usual right-before-left ones. Flip the whole script 🔄--no-internal-links— omits internal links, full stop.--no-turnarounds— disables building turnarounds.--no-turnarounds.tls— disables building turnarounds at tls-controlled junctions specifically.--no-turnarounds.geometry— disables building turnarounds at geometry-like junctions.--no-turnarounds.except-deadend— disables turnarounds except at dead end junctions (the lil dead-ends still get to u-turn, iconic).--no-turnarounds.except-turnlane— disables turnarounds except at junctions that have a dedicated turning lane.--no-turnarounds.fringe— disables building turnarounds at fringe junctions.--no-left-connections— disables building connections to the left.--junctions.join— joins junctions that are close to each other. Highly recommended for OSM import, iykyk ✨--junctions.join-distFLOAT — sets the maximal distance for joining junctions (defaults to10).--junctions.join.parallel-thresholdFLOAT — the angular threshold in degrees for rejecting parallel edges when joining junctions.--junctions.join-excludeSTR[] — reads STR[] as a list of junctions to keep out of the joining party 🙅--junctions.join-sameFLOAT — joins junctions that have similar coordinates even if they aren't connected.--junctions.join-reset— reset connections for joined junctions.--junctions.attach-removedFLOAT — attach the junction to the closest edge within FLOAT distance that has its id in paramremovedNodeIDs. This one is for joining networks 🫶--max-join-idsINT — abbreviate a junction or TLS id if it joins more than INT junctions.--junctions.corner-detailINT — generate INT intermediate points to smooth out intersection corners. Soft edges only 💅--junctions.internal-link-detailINT — generate INT intermediate points to smooth out lanes within the intersection.--junctions.scurve-stretchFLOAT — generate longer intersections so you can have smooth s-curves when the number of lanes changes. Glow-up for your geometry 🌈--junctions.join-turns— builds common edges for turning connections that share the same from- and to-edge. Heads up though, bestie: this causes discrepancies between geometrical length and assigned length because of averaging 😭 but it does enable lane-changing while turning, so, trade-offs.--junctions.limit-turn-speedFLOAT — limits speed on junctions to an average lateral acceleration of at most FLOAT (m/s^2).--junctions.limit-turn-speed.min-angleFLOAT — do not limit turn speed for angular changes below FLOAT (degrees). The value gets subtracted from the geometric angle before computing the turning radius.--junctions.limit-turn-speed.min-angle.railwayFLOAT — same deal but for railway edges: don't limit turn speed for angular changes below FLOAT (degrees). Again, the value is subtracted from the geometric angle before computing the turning radius 🚂--junctions.limit-turn-speed.warn.straightFLOAT — warns about turn speed limits that reduce the speed of straight connections by more than FLOAT.--junctions.limit-turn-speed.warn.turnFLOAT — warns about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT.--junctions.small-radiusFLOAT — default radius for junctions that don't require wide vehicle turns.--junctions.higher-speed— use the maximum value of incoming and outgoing edge speed on the junction instead of the average. Main character energy for your fastest lane 👑--junctions.minimal-shape— build junctions with minimal shapes (ignoring edge overlap).--junctions.endpoint-shape— build junction shapes based on edge endpoints (again, ignoring edge overlap).--internal-junctions.vehicle-widthFLOAT — the assumed vehicle width used for computing internal junction positions.--rectangular-lane-cut— forces rectangular cuts between lanes and intersections. Geometry said be square 📐--check-lane-foes.roundabout— allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts).--check-lane-foes.all— allow driving onto a multi-lane road if there are foes on other lanes (everywhere). Same vibe, bigger range.
🚶 Pedestrian Options
--sidewalks.guess— guess pedestrian sidewalks based on edge speed.--sidewalks.guess.max-speedFLOAT — add sidewalks for edges with a speed equal to or below the given limit.--sidewalks.guess.min-speedFLOAT — 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 🚶♀️--sidewalks.guess.excludeSTR[] — do not guess sidewalks for the given list of edges.--crossings.guess— guess pedestrian crossings based on whether sidewalks are present.--crossings.guess.speed-thresholdFLOAT — at uncontrolled nodes, don't build crossings across edges with a speed above the threshold.--crossings.guess.roundabout-priority— give priority to guessed crossings at roundabouts. Roundabout walkers deserve rights ✨--walkingareas— always build walking areas, even if there are no crossings at all.--walkingareas.join-distFLOAT — don't 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.--bikelanes.guess.max-speedFLOAT — add bike lanes for edges with a speed equal to or below the given limit.--bikelanes.guess.min-speedFLOAT — 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 🚴--bikelanes.guess.excludeSTR[] — do not guess bikelanes for the given list of edges.
🚂 Railway Options
--railway.signals.discard— discard all railway signal information that got loaded from formats other than plain-xml. Bye bestie 💀--railway.topology.repair— repair the topology of the railway network.--railway.topology.repair.minimal— repair the railway network topology just enough to let the loaded public transport lines work. Bare minimum era.--railway.topology.repair.connect-straight— allow bidirectional rail use wherever rails with opposite directions meet at a straight angle.--railway.topology.repair.stop-turn— add turn-around connections at all loaded stops.--railway.topology.repair.bidi-penaltyFLOAT — penalty factor for adding new bidi edges to connect public transport stops.--railway.topology.all-bidi— make all rails usable in both directions.--railway.topology.all-bidi.input-fileFILE — make all rail edge ids from FILE usable in both directions.--railway.topology.direction-priority— set edge priority values based on the estimated main direction.--railway.topology.ptline-prioritySTR[] — set edge priority values based on public transport lines for the given list of vClasses.--railway.topology.extend-priority— extend the loaded edge priority values based on the estimated main direction.--railway.geometry.straighten— move junctions to straighten a sequence of rail edges. Straightening? We love a clean line 📏--railway.signal.guess.by-stops— guess the signals that guard public transport stops.--railway.signal.guess.by-stops.split— split edges to improve the positioning of those guessed signals and to prevent switches from being used asrail_signals.--railway.signal.permit-unsignalizedSTR[] — list of rail classes that are allowed to run without rail signals.--railway.access-distanceFLOAT — the search radius for finding suitable road accesses for rail stops.--railway.max-accessesINT — the maximum number of road accesses registered per rail stop.--railway.access-factorFLOAT — the walking length of the access is computed as the air-line distance multiplied by FLOAT.
📦 Formats Options
--discard-paramsSTR[] — remove this list of keys from all params. Clean sweep 🧹--ignore-change-restrictionsSTR[] — list of vehicle classes that may ignore lane changing restrictions ('all'discards every restriction, no survivors).--ignore-widths— whether lane widths shall be ignored. Yes, it's a yes/no vibe.--osm.skip-duplicates-check— skips the duplicate node and edge check. Living dangerously, respect 🙈--osm.elevation— imports elevation data.--osm.layer-elevationFLOAT — reconstruct the (relative) elevation based on layer data. Each layer gets raised by FLOAT m 🏔️--osm.layer-elevation.max-gradeFLOAT — the max grade threshold, in %, at 50km/h, for when you're reconstructing elevation off layer data. bestie the value gets scaled according to road speed, so it's not just one flat number 💫--osm.oneway-spread-right— should one-way roads be spread out to the side, or just sit there centered? this decides 🌈--osm.lane-access— import those lane-specific access restrictions, yes ma'am 💅--osm.bike-access— pulls in bike lanes and fixes up directions + permissions on bike paths 🚲✨--osm.sidewalks— import sidewalks 🚶♀️--osm.oneway-reverse-sidewalk— defaults to building two sidewalks on oneway streets (heads up: this may also affect divided roads 👀)--osm.crossings— import crossings 🚸--osm.turn-lanes— imports turning arrows from OSM so connection building is easier, iconic behavior fr fr ⬅️➡️--osm.stop-output.lengthFLOAT — the default length of a public transport stop, in FLOAT m 🚏--osm.stop-output.length.busFLOAT — default length of a bus stop in FLOAT m 🚌--osm.stop-output.length.tramFLOAT — default length of a tram stop in FLOAT m 🚊--osm.stop-output.length.trainFLOAT — default length of a train stop in FLOAT m 🚆--osm.railsignalsSTR[] — give your own custom rules for importing railway signals 🚦--osm.all-attributes— should extra attributes get imported at all, or nah?--osm.extra-attributesSTR[] — the list of extra attributes to import from OSM viaosm.all-attributes(set it to'all'to import literally everything, go off 👑)--osm.speedlimit-noneFLOAT — the speed limit to use when there's actually no real speed limit in reality. spooky but ok 💀--osm.annotate-defaults— should edges carry info about whether typemap defaults got used? 🏷️--matsim.keep-length— edge lengths from the MATSim file are kept exactly as given 🔒--matsim.lanes-from-capacity— the lane number gets computed from the capacity, math girl behavior 🧮--shapefile.street-idSTR — read edge ids from column STR--shapefile.from-idSTR — read from-node ids from column STR--shapefile.to-idSTR — read to-node ids from column STR--shapefile.type-idSTR — read type ids from column STR--shapefile.laneNumberSTR — read lane number from column STR--shapefile.speedSTR — read speed from column STR 🏎️--shapefile.lengthSTR — read custom edge length from column STR--shapefile.widthSTR — read total edge width from column STR--shapefile.nameSTR — read the (non-unique, so watch out bestie) name from column STR--shapefile.node-join-distFLOAT — distance threshold for deciding whether distinct shapes are connected (this one's used whenfrom-idandto-idaren't available) 🔗--shapefile.add-paramsSTR[] — add this list of field names as edge params--shapefile.use-defaults-on-failure— uses edge type defaults when things go wrong 🩹--shapefile.all-bidirectional— inserts edges in both directions, double the fun 🔁--shapefile.guess-projection— guess the proper projection 🔮--shapefile.traditional-axis-mapping— use the traditional axis order,(lon, lat)📍--dlr-navteq.tolerant-permissions— allows more vehicle classes by default, very forgiving of you 💖--dlr-navteq.keep-length— edge lengths given in the DLR Navteq file get kept as-is 🛑--vissim.join-distanceFLOAT — structure join offset--vissim.default-speedFLOAT — use FLOAT as the default speed--vissim.speed-normFLOAT — factor for edge velocity--vissim.report-unset-speeds— writes out the lanes that have no explicit speed set 🗣️--visum.language-fileFILE — 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-speedsFLOAT — sets connector speed--visum.connectors-lane-numberINT — sets connector lane number--visum.no-connectors— excludes connectors 🚫--visum.recompute-lane-number— computes the number of lanes from the edges' capacities--visum.verbose-warnings— prints all warnings, and ngl some of those are just VISUM misbehaving, not you 🙈--visum.lanes-from-capacity.normFLOAT — the factor for converting flow to number-of-lanes--opendrive.import-all-lanes— imports every lane type, all of them, no skipping 💯--opendrive.curve-resolutionFLOAT — the geometry resolution in m when curved geometries get imported as line segments 📐--opendrive.advance-stoplineFLOAT — lets stop lines be built past the start of the junction, if the geometries allow it--opendrive.min-widthFLOAT — the minimum lane width used 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 plus offset in m (this one's legacy, fyi 🦕)--opendrive.lane-shapes— use custom lane shapes to compensate for discarded lane types--opendrive.signal-groups— use the OpenDRIVE controller info for the generated signal program 🚥--opendrive.ignore-misplaced-signals— ignore traffic signals that don't control any driving lane, not their problem not your problem 💅
✨ Netedit Options ✨
okay netedit girlies this whole chunk is for you 🎀
--new-network— start netedit with a brand new network 🆕--attribute-help-outputFILE — write attribute help to a file--ignore-supermode-question— ignore that question dialog when you're switching between supermodes in undo-redo, we get it, no need to ask again 🙈--ignore.additionalelements— ignore additional elements while loading sumo-configs--ignore.routeelements— ignore route elements while loading sumo-configs--e2.friendlyPos.automatic— if the lane is shorter than the additional, automatically enablefriendlyPos🫶--force-saving— if enabled, loaded elements get saved whether or not they've been edited (usually used in netedit tests, so don't be weird about it)--node-prefixSTR — prefix for node naming--edge-prefixSTR — prefix for edge naming--edge-infixSTR — enable edge-infix, which is<fromNodeID><infix><toNodeID>🧩--busStop-prefixSTR — prefix for busStop naming--trainStop-prefixSTR — prefix for trainStop naming--containerStop-prefixSTR — prefix for containerStop naming--chargingStation-prefixSTR — prefix for chargingStation naming ⚡--parkingArea-prefixSTR — prefix for parkingArea naming--e1Detector-prefixSTR — prefix for e1Detector naming--e2Detector-prefixSTR — prefix for e2Detector naming--e3Detector-prefixSTR — prefix for e3Detector naming--e1InstantDetector-prefixSTR — prefix for e1InstantDetector naming--rerouter-prefixSTR — prefix for rerouter naming--calibrator-prefixSTR — prefix for calibrator naming--routeProbe-prefixSTR — prefix for routeProbe naming--vss-prefixSTR — prefix for variable speed sign naming--tractionSubstation-prefixSTR — prefix for traction substation naming--overheadWire-prefixSTR — prefix for overhead wire naming--polygon-prefixSTR — prefix for polygon naming--poi-prefixSTR — prefix for poi naming--jps.walkableArea-prefixSTR — prefix for jps walkable area naming--jps.obstacle-prefixSTR — prefix for jps obstacle naming--route-prefixSTR — prefix for route naming--routeDistribution-prefixSTR — prefix for route distribution naming--vType-prefixSTR — prefix for type naming--vTypeDistribution-prefixSTR — prefix for type distribution naming--vehicle-prefixSTR — prefix for vehicle naming--trip-prefixSTR — prefix for trip naming--flow-prefixSTR — prefix for flow naming--person-prefixSTR — prefix for person naming--personflow-prefixSTR — prefix for personFlow naming--container-prefixSTR — prefix for container naming--containerflow-prefixSTR — prefix for containerFlow naming--dataSet-prefixSTR — prefix for dataSet naming--meanDataEdge-prefixSTR — prefix for meanDataEdge naming--meanDataLane-prefixSTR — prefix for meanDataLane naming
🌸 Visualisation Options 🌸
the aesthetic section, lowkey my fave 💖
--disable-laneIcons— disable icons of special lanes-T,--disable-textures— disable textures-g,--gui-settings-fileFILE — load visualisation settings from FILE 🎨--registry-viewport— load the current viewport from the registry--window-sizeSTR[] — create the initial window with the given x,y size--window-posSTR[] — create the initial window at the given x,y position--gui-testing— enable the overlay for screen recognition--gui-testing-debug— enable output messages during GUI-Testing--gui-testing-debug-gl— enable output messages during GUI-Testing that are specific to gl functions--gui-testing.setting-outputFILE — save gui settings into the given settings-output file
⏰ Time Options ⏰
--beginTIME — defines the begin time in seconds; the simulation starts at this time 🕐--endTIME — defines the end time in seconds; the simulation ends at this time 🕛
📋 Report Options 📋
-v,--verbose— switches to verbose output, chatty mode ON 🗣️--print-options— prints option values before processing-?,--help— prints this screen, or just the selected topics 🆘-V,--version— prints the current version-X,--xml-validationSTR — sets the schema validation scheme for XML inputs (your choices are"never","local","auto"or"always")--xml-validation.netSTR — sets the schema validation scheme for SUMO network inputs ("never","local","auto"or"always")--xml-validation.routesSTR — sets the schema validation scheme for SUMO route inputs ("never","local","auto"or"always")-W,--no-warnings— disables output of warnings, we're pretending everything's fine 🤫--aggregate-warningsINT — aggregate warnings of the same type whenever more than INT of them occur-l,--logFILE — writes all messages to FILE (and yes, it implies verbose)--message-logFILE — writes all non-error messages to FILE (implies verbose too)--error-logFILE — 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 🆔--languageSTR — picks which language the messages come at you in 💬 lowkey handy if English isn't the vibe today.--ignore-errors— do NOT stop, bestie. keeps going even when the input is broken 🫶 (chaotic but brave).--ignore-errors.connections— same energy but specifically for invalid connections. those get skipped instead of ending your whole run 🚧.--show-errors.connections-first-try— shows you the connection errors right at parsing time, so you catch them first try 👀✨.--ignore-errors.edge-type— edge type is unknown? doesn't matter. carry on 🦋.
🎲 Random Number Options 🎲
--random— seeds the random number generator with the current system time ⏰ so every run is a lil different. living spontaneously fr.--seedINT — seeds that same random number generator with your chosen value 🎯 so your runs are reproducible. same seed, same slay.
🎉 EXAMPLES 🎉
okay this is the part where it gets fun, bestie. copy these EXACTLY, no typos 💅
netedit --newStarts a plain GUI with an empty net 🫧 just vibes, no data.
netedit -s <SUMO_NET>Opens a SUMO network 🌐 give it a net and it'll pop right open.
netedit -c <CONFIGURATION>Opens a configuration file — and yup, it can be a netedit config or a netconvert config, either one works 🎀.
netedit -sumocfg-file <CONFIGURATION>Opens a SUMO config file 📂 that's the SUMO config, not the netedit one, mind the difference bestie.
🐛 REPORTING BUGS 🐛
found a bug? not the cute kind 😭 tell the devs right here:
want actual human contact instead of a tracker?
sumo@dlr.de
and here's the build tea, straight from the program itself ☕:
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.deEclipse SUMO netedit 1.27.1 is part of SUMO 💜 and everything that ships with it is available under the terms of the Eclipse Public License v2.0 — which comes with this distribution and lives at:
http://www.eclipse.org/legal/epl-v20.html
it can ALSO be made available under these Secondary Licenses, but only when the conditions for that availability set out in the Eclipse Public License 2.0 are satisfied 🌈: the GNU General Public License, version 2 or later, sitting pretty at:
https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
and the official licensing tag, hand it to your lawyer bestie:
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
and that's the whole page, you made it 🥹💖 this one was Eclipse SUMO netedit 1.27.1, dated August 2026, filed under ECLIPSE(1) — go open a net, you absolute icon 👑✨
📦 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 : a language model's rewrite of the original, under its terms