DOKK / manpages / debian 12 / sumo / netconvert.1.en
ECLIPSE(1) User Commands ECLIPSE(1)

Eclipse - Road network importer / builder for the traffic simulation SUMO

netconvert [OPTION]*

Eclipse SUMO netconvert Version 1.15.0

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

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

SUMO.

Loads the named config on startup
Saves current configuration into FILE
Enforce relative paths when saving the configuration
Saves a configuration template (empty) into FILE
Saves the configuration schema into FILE
Adds comments to saved template, configuration, or schema

Read SUMO-net from FILE
Read XML-node defs from FILE
Read XML-edge defs from FILE
Read XML-connection defs from FILE
Read XML-traffic light defs from FILE
Read XML-type defs from FILE
Reads public transport stops from FILE
Reads public transport lines from FILE
Reads polygons from FILE for embedding in network where applicable
Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
Read OSM-network from path 'FILE(s)'
Read OpenDRIVE-network from FILE
Read VISUM-net from FILE
Read VISSIM-net from FILE
Read RoboCup-net from DIR
Read MATsim-net from FILE
Read ITSUMO-net from FILE
Read heightmap from ArcGIS shapefile
Read heightmap from GeoTIFF

Include license info into every output file
Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
Defines the number of digits after the comma for floating point output
Defines the number of digits after the comma for lon,lat output
Write time values as hour:minute:second or day:hour:minute:second rather than seconds
The generated net will be written to FILE
Prefix of files to write plain xml nodes, edges and connections to
Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins
Defines a prefix for edge and junction names
The generated net will be written to FILE using Amitran format
The generated net will be written to FILE using MATsim format
The generated net will be written to FILE using OpenDRIVE format
The generated net will be written to dlr-navteq files with the given PREFIX
The network coordinates are written with the specified level of output precision
Street names will be included in the output (if available)
Writes original names, if given, as parameter
Writes street signs as POIs to FILE
Writes public transport stops to FILE
Writes public transport lines to FILE
Clean-up pt stops that are not served by any line
Writes parking areas to FILE
Analyze topology of the railway network
Write shapes that are embedded in the network input and that are not supported by polyconvert (OpenDRIVE)
Builds parameterized curves whenever the angular change between straight segments exceeds FLOAT degrees

Uses a simple method for projection
Scaling factor for input coordinates
Rotation (clockwise degrees) for input coordinates
Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid, "Gauss-Krueger")
Uses STR as proj.4 definition for projection
Inverses projection
Convert from Gauss-Krueger to UTM
Write geo coordinates in plain-xml

vmax is parsed as given in km/h
Use YYYY-MM-DD date to determine the readiness of features under construction
Remove all z-data
If edge shapes do not end at the node positions, extend them
Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers
Remaps IDs of nodes to integers starting at INT
Remaps IDs of edges to integers starting at INT
Ensures that generated ids do not included any of the typed IDs from FILE (sumo-gui selection file format)
Removes vehicle class restrictions from imported edges
Splits edges across geometry nodes
Replace nodes which only define edge geometry by geometry points (joins edges)
Ensure that the given list of edges is not modified
Ensure that the edges in FILE are not modified (Each id on a single line. Selection files from sumo-gui are also supported)
Ensure that edges with public transport stops are not modified
Allow merging edges with differing attributes when their length is below min-length
Allow merging edges with differing lane widths if the difference is below FLOAT
splits geometry to restrict segment length
reduces too similar geometry points
Warn about edge geometries with an angle above DEGREES in successive segments
Warn about edge geometries with a turning radius less than METERS at the start or end
Straighten edge geometries to avoid turning radii less than geometry.min-radius
Straighten edge geometries to avoid turning radii less than geometry.min-radius (only railways)
Warn if the junction shape is to far away from the original node position
Warn if edges overlap by more than the given threshold value
Ignore overlapping edges if they are separated vertically by the given threshold.
Modify edge geometries to avoid overlap at junctions
join adjacent lanes that have the same permissions and which do not admit lane-changing (sidewalks and disallowed lanes)
Matches stops outside the road network to the referencing pt line when below the given distance
Skips automatic generation of stops on the bidi-edge of a loaded stop
Warn about edge geometries with a grade in % above FLOAT.
Smooth edge edge geometries with a grade in above the warning threshold.
Turn off normalizing node positions
Adds FLOAT to net x-positions
Adds FLOAT to net y-positions
Adds FLOAT to net z-positions
Flips the y-coordinate along zero
Enable roundabout-guessing
Default visibility when approaching a roundabout
Enable guessing of opposite direction lanes usable for overtaking
Ensure that opposite edges have the same length
Enable guessing of network fringe nodes
Guess disconnected edges above the given speed as outer fringe
Assumes left-hand traffic on the network
Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import)
Modifies all edge speeds by adding FLOAT
Modifies all edge speeds by multiplying by FLOAT
Modifies all edge speeds to at least FLOAT
Joins tram edges into road lanes with similar geometry (within FLOAT distance)

The default number of lanes in an edge
The default width of lanes
The default method for computing lane shapes from edge shapes
The default speed on an edge (in m/s)
The default friction on an edge
The default priority of an edge
The default edge type
The default width of added sidewalks
The default width of added bike lanes
The default width of a pedestrian crossing
The default for allowed vehicle classes
The default for disallowed vehicle classes
Whether junctions should be kept clear by default
The default turning radius of intersections
The default length when overriding connection lengths
The default algorithm for computing right of way rules ('default', 'edgePriority')

Does not instatiate traffic lights loaded from other formats than plain-XML
Does not instatiate traffic lights at geometry-like nodes loaded from other formats than plain-XML
Interprets STR[] as list of junctions to be controlled by TLS
Interprets STR[] as list of junctions to be not controlled by TLS
Turns on TLS guessing
Sets minimum value for the sum of all incoming lane speeds when guessing TLS
Sets district nodes as tls-controlled
Includes node clusters into guess
Tries to cluster tls-controlled nodes
Determines the maximal distance for joining traffic lights (defaults to 20)
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
Do not build mutually conflicting response matrix, potentially ignoring vehicles that are stuck at an internal junction when their phase has ended
Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks
Distance for interpreting nodes as signal locations
Use INT as cycle duration
Use INT as green phase duration
Defines smallest vehicle deceleration
Given yellow times are patched even if being too short
Set INT as fixed time for yellow phase durations
Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow
Set INT as fixed time for intermediate red phase after every switch
Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles
Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases
Set INT as fixed time for intermediate vehext phase after every switch
Set INT as fixed time for intermediate NEMA yelow phase after every switch
Set INT as fixed time for intermediate NEMA red phase after every switch
Use INT as minimum green duration for pedestrian crossings (s).
Use INT as clearance time for pedestrian crossings (s).
Use INT as green phase duration for pedestrian scramble phase (s).
TLSs in STR[] will be shifted by half-phase
TLSs in STR[] will be shifted by quarter-phase
TLSs with unspecified type will use STR as their algorithm
Set phase layout four grouping opposite directions or grouping all movements for one incoming edge ['opposites', 'incoming']
Avoid phases with green and red signals for different connections from the same lane
Default minimum phase duration for traffic lights with variable phase length
Default maximum phase duration for traffic lights with variable phase length
Assign the same tls link index to connections that share the same states
Assign a distinct tls link index to every connection

Enable ramp-guessing
Guess on-ramps and mark acceleration lanes if they exist but do not add new lanes
Treat edges with speed > FLOAT as no ramps
Treat edges with speed < FLOAT as no highways
Use FLOAT as ramp-length
Use FLOAT as minimum ramp-length
Tries to handle the given edges as ramps
Do not consider the given edges as ramps
Avoids edge splitting

Only keep edges with speed in meters/second > FLOAT
Remove edges in STR[]
Only keep edges in STR[] or those which are kept due to other keep-edges or remove-edges options
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 in FILE. (Each id on a single line. Selection files from sumo-gui are also supported)
Remove edges after joining
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,...>)
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,...>)
Only keep edges which allow one of the vclasses in STR[]
Remove edges which allow only vclasses from STR[]
Only keep edges where type is in STR[]
Only keep the INT largest weakly connected components
Remove edges where type is in STR[]
Removes isolated edges

All nodes will be unregulated
Do not regulate nodes in STR[]
Do not regulate district nodes

Allow building right-before-left junctions when the incoming edge speeds are below FLOAT (m/s)
Build left-before-right junctions instead of right-before-left junctions
Omits internal links
Disables building turnarounds
Disables building turnarounds at tls-controlled junctions
Disables building turnarounds at geometry-like junctions
Disables building turnarounds except at dead end junctions
Disables building turnarounds except at at junctions with a dedicated turning lane
Disables building turnarounds at fringe junctions
Disables building connections to left
Joins junctions that are close to each other (recommended for OSM import)
Determines the maximal distance for joining junctions (defaults to 10)
Interprets STR[] as list of junctions to exclude from joining
Joins junctions that have the same coordinates even if not connected
Abbreviate junction or TLS id if it joins more than INT junctions
Generate INT intermediate points to smooth out intersection corners
Generate INT intermediate points to smooth out lanes within the intersection
Generate longer intersections to allow for smooth s-curves when the number of lanes changes
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
Limits speed on junctions to an average lateral acceleration of at most FLOAT m/s^2)
Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius.
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.
Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT
Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT
Default radius for junctions that do not require wide vehicle turns
Use maximum value of incoming and outgoing edge speed on junction instead of average
Assumed vehicle width for computing internal junction positions
Forces rectangular cuts between lanes and intersections
Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)
Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)

Guess pedestrian sidewalks based on edge speed
Add sidewalks for edges with a speed equal or below the given limit
Add sidewalks for edges with a speed above the given limit
Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed
Do not guess sidewalks for the given list of edges
Guess pedestrian crossings based on the presence of sidewalks
At uncontrolled nodes, do not build crossings across edges with a speed above the threshold
Always build walking areas even if there are no crossings
Do not create a walkingarea between sidewalks that are connected by a pedestrian junction within FLOAT

Guess bike lanes based on edge speed
Add bike lanes for edges with a speed equal or below the given limit
Add bike lanes for edges with a speed above the given limit
Add bike lanes for edges that allow bicycles on any of their lanes regardless of speed
Do not guess bikelanes for the given list of edges

Discard all railway signal information loaded from other formats than plain-xml
Repair topology of the railway network
Repair topology of the railway network just enough to let loaded public transport lines to work
Allow bidirectional rail use wherever rails with opposite directions meet at a straight angle
Add turn-around connections at all loaded stops.
Make all rails usable in both direction
Make all rails edge ids from FILE usable in both direction
Set edge priority values based on estimated main direction
Extend loaded edge priority values based on estimated main direction
The search radius for finding suitable road accesses for rail stops
The maximum road accesses registered per rail stops
The walking length of the access is computed as air-line distance multiplied by FLOAT

Remove the list of keys from all params
List vehicle classes that may ignore lane changing restrictions ('all' discards all restrictions)
Skips the check for duplicate nodes and edges
Imports elevation data
Reconstruct (relative) elevation based on layer data. Each layer is raised by FLOAT m
Maximum grade threshold in % at 50km/h when reconstrucing elevation based on layer data. The value is scaled according to road speed.
Whether one-way roads should be spread to the side instead of centered
Import lane-specific access restrictions
Check additional attributes to fix directions and permissions on bike paths
Import sidewalks
Import turning arrows from OSM to help with connection building
The default length of a public transport stop in FLOAT m
The default length of a bus stop in FLOAT m
The default length of a tram stop in FLOAT m
The default length of a train stop in FLOAT m
Whether additional attributes shall be imported
List of additional attributes that shall be imported from OSM via osm.all-attributes (set 'all' to import all)
The speed limit to be set when there is no actual speed limit in reality
The edge lengths given in the MATSIM-file will be kept
The lane number will be computed from the capacity
Read edge ids from column STR
Read from-node ids from column STR
Read to-node ids from column STR
Read type ids from column STR
Read lane number from column STR
Read speed from column STR
Read (non-unique) name from column STR
Distance threshold for determining whether distinct shapes are connected (used when from-id and to-id are not available)
Add the list of field names as edge params
Uses edge type defaults on problems
Insert edges in both directions
Guess the proper projection
Use traditional axis order (lon, lat)
Allow more vehicle classes by default
The edge lengths given in the DLR Navteq-file will be kept
Structure join offset
Use FLOAT as default speed
Factor for edge velocity
Writes lanes without an explicit speed set
Load language mappings from FILE
Uses priorities from types
Uses lane numbers from types
Uses speeds from types
Sets connector speed
Sets connector lane number
Excludes connectors
Computes the number of lanes from the edges' capacities
Prints all warnings, some of which are due to VISUM misbehaviour
The factor for flow to no. lanes conversion
Imports all lane types
Whether lane widths shall be ignored.
The geometry resolution in m when importing curved geometries as line segments.
Allow stop lines to be built beyond the start of the junction if the geometries allow so
The minimum lane width for determining start or end of variable-width lanes
Import internal lane shapes
Sets edge-id based on road-id and offset in m (legacy)
Use custom lane shapes to compensate discarded lane types

Switches to verbose output
Prints option values before processing
-?, --help
Prints this screen or selected topics
Prints the current version
Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")
Set schema validation scheme of SUMO network inputs ("never", "local", "auto" or "always")
Disables output of warnings
Aggregate warnings of the same type whenever more than INT occur
Writes all messages to FILE (implies verbose)
Writes all non-error messages to FILE (implies verbose)
Writes all warnings and errors to FILE
Continue on broken input
Continue on invalid connections
Show errors in connections at parsing
Continue on unknown edge types

Initialises the random number generator with the current system time
Initialises the random number generator with the given value

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

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


Build features: Linux-5.10.0-20-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO netconvert Version 1.15.0 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

January 2023 Eclipse SUMO netconvert Version 1.15.0