Difference between revisions of "NETCONVERT"

From Sumo
Jump to navigation Jump to search
(Options)
Line 38: Line 38:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/>{{Option|--configuration-file {{DT_FILE}}}}
+
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/> {{Option|--configuration-file {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Loads the named config on startup
 
| valign="top" | Loads the named config on startup
 
|-
 
|-
 
| valign="top" | {{Option|--save-configuration {{DT_FILE}}}}
 
| valign="top" | {{Option|--save-configuration {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Saves current configuration into FILE
 
| valign="top" | Saves current configuration into FILE
 
|-
 
|-
 
| valign="top" | {{Option|--save-template {{DT_FILE}}}}
 
| valign="top" | {{Option|--save-template {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Saves a configuration template (empty) into FILE
 
| valign="top" | Saves a configuration template (empty) into FILE
 
|-
 
|-
 
| valign="top" | {{Option|--save-schema {{DT_FILE}}}}
 
| valign="top" | {{Option|--save-schema {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Saves the configuration schema into FILE
 
| valign="top" | Saves the configuration schema into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-commented}}
+
| valign="top" | {{Option|--save-commented {{DT_BOOL}}}}
| valign="top" | Adds comments to saved template, configuration, or schema; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Adds comments to saved template, configuration, or schema
 
|-
 
|-
 
|}
 
|}
Line 61: Line 67:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-s {{DT_FILE}}}}<br/>{{Option|--sumo-net-file {{DT_FILE}}}}
+
| valign="top" | {{Option|-s {{DT_FILE}}}}<br/> {{Option|--sumo-net-file {{DT_FILE}}}}
| valign="top" | Read [[Networks/SUMO_Road_Networks|SUMO network]] from FILE
+
| valign="top" |
 +
| valign="top" | Read SUMO-net from FILE
 
|-
 
|-
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/>{{Option|--node-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/> {{Option|--node-files {{DT_FILE}}}}
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Node_Descriptions|XML node definitions]] from FILE
+
| valign="top" |
 +
| valign="top" | Read XML-node defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-e {{DT_FILE}}}}<br/>{{Option|--edge-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-e {{DT_FILE}}}}<br/> {{Option|--edge-files {{DT_FILE}}}}
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Edge_Descriptions|XML edge definitions]] from FILE
+
| valign="top" |
 +
| valign="top" | Read XML-edge defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-x {{DT_FILE}}}}<br/>{{Option|--connection-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-x {{DT_FILE}}}}<br/> {{Option|--connection-files {{DT_FILE}}}}
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Connection_Descriptions|XML connection definitions]] from FILE
+
| valign="top" |
 +
| valign="top" | Read XML-connection defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-t {{DT_FILE}}}}<br/>{{Option|--type-files {{DT_FILE}}}}
+
| valign="top" | {{Option|-i {{DT_FILE}}}}<br/> {{Option|--tllogic-files {{DT_FILE}}}}
| valign="top" | Read [[SUMO edge type file|XML type definitions]] from FILE
+
| valign="top" |
 +
| valign="top" | Read XML-traffic light defs from FILE
 +
|-
 +
| valign="top" | {{Option|-t {{DT_FILE}}}}<br/> {{Option|--type-files {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | Read XML-type defs from FILE
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile-prefix {{DT_FILE}}}}
 
| valign="top" | {{Option|--shapefile-prefix {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
 
| valign="top" | Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
 
|-
 
|-
 
| valign="top" | {{Option|--dlr-navteq-prefix {{DT_FILE}}}}
 
| valign="top" | {{Option|--dlr-navteq-prefix {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
 
| valign="top" | Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
 
|-
 
|-
 
| valign="top" | {{Option|--osm-files {{DT_FILE}}}}
 
| valign="top" | {{Option|--osm-files {{DT_FILE}}}}
| valign="top" | Read [[OpenStreetMap_file|OpenStreetMap network]] from path 'FILE(s)'
+
| valign="top" |
 +
| valign="top" | Read OSM-network from path 'FILE(s)'
 
|-
 
|-
 
| valign="top" | {{Option|--opendrive-files {{DT_FILE}}}}
 
| valign="top" | {{Option|--opendrive-files {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read openDrive-network from FILE
 
| valign="top" | Read openDrive-network from FILE
 
|-
 
|-
 
| valign="top" | {{Option|--visum-file {{DT_FILE}}}}
 
| valign="top" | {{Option|--visum-file {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read VISUM-net from FILE
 
| valign="top" | Read VISUM-net from FILE
 
|-
 
|-
 
| valign="top" | {{Option|--vissim-file {{DT_FILE}}}}
 
| valign="top" | {{Option|--vissim-file {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read VISSIM-net from FILE
 
| valign="top" | Read VISSIM-net from FILE
 
|-
 
|-
 
| valign="top" | {{Option|--robocup-dir {{DT_FILE}}}}
 
| valign="top" | {{Option|--robocup-dir {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Read RoboCup-net from DIR
 
| valign="top" | Read RoboCup-net from DIR
 
|-
 
|-
 
| valign="top" | {{Option|--matsim-files {{DT_FILE}}}}
 
| valign="top" | {{Option|--matsim-files {{DT_FILE}}}}
| valign="top" | Read MATSim-net from FILE
+
| valign="top" |
 +
| valign="top" | Read MATsim-net from FILE
 +
|-
 +
| valign="top" | {{Option|--itsumo-files {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | Read ITSUMO-net from FILE
 
|-
 
|-
 
|}
 
|}
Line 108: Line 136:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-o {{DT_FILE}}}}<br/>{{Option|--output-file {{DT_FILE}}}}
+
| valign="top" | {{Option|-o {{DT_FILE}}}}<br/> {{Option|--output-file {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | The generated net will be written to FILE
 
| valign="top" | The generated net will be written to FILE
 
|-
 
|-
 
| valign="top" | {{Option|--plain-output-prefix {{DT_FILE}}}}
 
| valign="top" | {{Option|--plain-output-prefix {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Prefix of files to write plain xml nodes, edges and connections to
 
| valign="top" | Prefix of files to write plain xml nodes, edges and connections to
 
|-
 
|-
| valign="top" | {{Option|-M {{DT_FILE}}}}<br/>{{Option|--map-output {{DT_FILE}}}}
+
| valign="top" | {{Option|--junctions.join-output {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins
 +
|-
 +
| valign="top" | {{Option|-M {{DT_FILE}}}}<br/> {{Option|--map-output {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Writes joined edges information to FILE
 
| valign="top" | Writes joined edges information to FILE
 
|-
 
|-
 
| valign="top" | {{Option|--matsim-output {{DT_FILE}}}}
 
| valign="top" | {{Option|--matsim-output {{DT_FILE}}}}
| valign="top" | The generated net will be written to FILE using MATSIM format.
+
| valign="top" |
 +
| valign="top" | The generated net will be written to FILE using MATsim format.
 +
|-
 +
| valign="top" | {{Option|--opendrive-output {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | The generated net will be written to FILE using openDRIVE format.
 +
|-
 +
| valign="top" | {{Option|--dlr-navteq-output {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | The generated net will be written to dlr-navteq files with the given PREFIX.
 +
|-
 +
| valign="top" | {{Option|--output.street-names {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Street names will be included in the output (if available).
 
|-
 
|-
| valign="top" | {{Option|--output.street-names}}
+
| valign="top" | {{Option|--output.original-names {{DT_BOOL}}}}
| valign="top" | Street names will be included in the output (if available); ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Writes original names, if given, as parameter.
 +
|-
 +
| valign="top" | {{Option|--street-sign-output {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | Writes street signs as POIs to FILE.
 
|-
 
|-
 
|}
 
|}
  
 
===Projection===
 
===Projection===
Most data of real world networks has locations and shapes of streets and junctions specified with geocoordinates. This is especially true for OSM, Tiger networks (and most of the other shapefiles) and Navteq GDF and derivatives. Since SUMO works with cartesian coordinates only, you need to perform a projection of the geo coordinates into the plane. Unfortunately there are plenty of projections available but fortunately there exists the [http://trac.osgeo.org/proj/ Proj library] which is used by [[NETCONVERT]] to handle almost all of them. There are several options to use geo projection (and proj) together with [[NETCONVERT]]:
 
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--simple-projection}}
+
| valign="top" | {{Option|--simple-projection {{DT_BOOL}}}}
| valign="top" | Uses a simple method for projection; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Uses a simple method for projection
 
|-
 
|-
 
| valign="top" | {{Option|--proj.scale {{DT_INT}}}}
 
| valign="top" | {{Option|--proj.scale {{DT_INT}}}}
| valign="top" | Number of places to shift decimal point to right in geo-coordinates; ''default: '''0'''''
+
| valign="top" | 0
 +
| valign="top" | Number of places to shift decimal point to right in geo-coordinates
 
|-
 
|-
| valign="top" | {{Option|--proj.utm}}
+
| valign="top" | {{Option|--proj.utm {{DT_BOOL}}}}
| valign="top" | Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid); ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
 
|-
 
|-
| valign="top" | {{Option|--proj.dhdn}}
+
| valign="top" | {{Option|--proj.dhdn {{DT_BOOL}}}}
| valign="top" | Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid); ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid)
 
|-
 
|-
 
| valign="top" | {{Option|--proj {{DT_STR}}}}
 
| valign="top" | {{Option|--proj {{DT_STR}}}}
| valign="top" | Uses STR as proj.4 definition for projection; ''default: '''!'''''
+
| valign="top" | !
 +
| valign="top" | Uses STR as proj.4 definition for projection
 
|-
 
|-
| valign="top" | {{Option|--proj.inverse}}
+
| valign="top" | {{Option|--proj.inverse {{DT_BOOL}}}}
| valign="top" | Inverses projection; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Inverses projection
 +
|-
 +
| valign="top" | {{Option|--proj.plain-geo {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Write geo coordinates in plain-xml
 
|-
 
|-
 
|}
 
|}
In case you (or your network supplier) are already familiar with the use of proj you can pass the correct parameters directly to NETCONVERT using {{Option|--proj}}. Sometimes also the [http://en.wikipedia.org/wiki/European_Petroleum_Survey_Group EPSG] number of a projection is known, which together with [http://www.erdwesen.de/epsg.txt this list] (coming also with most proj installations) helps to find the correct proj parameters. Most of the networks have however WGS84 data, which is usually converted using [http://en.wikipedia.org/wiki/Universal_Transverse_Mercator_coordinate_system UTM]. In order to support this often used projection NETCONVERT provides another option {{Option|--proj.utm}} which determines the correct UTM zone to use from the longitude of the first point in the network. {{Option|--proj.dhdn}} does essentially the same for data referring to the "Deutsches HauptDreiecksNetz" which used to be the basis for most of the administrative data in germany.
 
  
If you want to "undo" a projection for instance if you need to modify an existing sumo network, you can do an inverse projection by giving {{Option|--proj.inverse}}. If you don't have proj available but desperately need a projection of some kind, you can try {{Option|--proj.simple}}. This should be a last resort only, if you have proj, you should always prefer {{Option|--proj.utm}}.
+
===Tls Building===
 
 
===TLS Building===
 
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
 
| valign="top" | {{Option|--tls.discard-loaded {{DT_BOOL}}}}
 
| valign="top" | {{Option|--tls.discard-loaded {{DT_BOOL}}}}
| valign="top" | [[NETCONVERT]] only; avoid to load traffic light definitions from all import formats despite XML; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Does not instatiate traffic lights loaded from other formats than XML
 
|-
 
|-
 
| valign="top" | {{Option|--tls.set {{DT_STR}}}}
 
| valign="top" | {{Option|--tls.set {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Interprets STR as list of junctions to be controlled by TLS
 
| valign="top" | Interprets STR as list of junctions to be controlled by TLS
 
|-
 
|-
 
| valign="top" | {{Option|--tls.unset {{DT_STR}}}}
 
| valign="top" | {{Option|--tls.unset {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Interprets STR as list of junctions to be not controlled by TLS
 
| valign="top" | Interprets STR as list of junctions to be not controlled by TLS
 
|-
 
|-
| valign="top" | {{Option|--tls.guess}}
+
| valign="top" | {{Option|--tls.guess {{DT_BOOL}}}}
| valign="top" | Turns on TLS guessing; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Turns on TLS guessing
 
|-
 
|-
| valign="top" | {{Option|--tls.taz-nodes}}
+
| valign="top" | {{Option|--tls.taz-nodes {{DT_BOOL}}}}
| valign="top" | Sets district nodes as tls-controlled; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Sets district nodes as tls-controlled
 
|-
 
|-
| valign="top" | {{Option|--tls-guess.joining}}
+
| valign="top" | {{Option|--tls-guess.joining {{DT_BOOL}}}}
| valign="top" | Includes node clusters into guess; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Includes node clusters into guess
 
|-
 
|-
| valign="top" | {{Option|--tls.join}}
+
| valign="top" | {{Option|--tls.join {{DT_BOOL}}}}
| valign="top" | Tries to cluster tls-controlled nodes; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Tries to cluster tls-controlled nodes
 
|-
 
|-
 
| valign="top" | {{Option|--tls.green.time {{DT_INT}}}}
 
| valign="top" | {{Option|--tls.green.time {{DT_INT}}}}
| valign="top" | Use INT as green phase duration; ''default: '''31'''''
+
| valign="top" | 31
 +
| valign="top" | Use INT as green phase duration
 
|-
 
|-
| valign="top" | {{Option|-D {{DT_FLOAT}}}}<br/>{{Option|--tls.yellow.min-decel {{DT_FLOAT}}}}
+
| valign="top" | {{Option|-D {{DT_FLOAT}}}}<br/> {{Option|--tls.yellow.min-decel {{DT_FLOAT}}}}
| valign="top" | Defines smallest vehicle deceleration; ''default: '''3'''''
+
| valign="top" | 3
 +
| valign="top" | Defines smallest vehicle deceleration
 
|-
 
|-
| valign="top" | {{Option|--tls.yellow.patch-small}}
+
| valign="top" | {{Option|--tls.yellow.patch-small {{DT_BOOL}}}}
| valign="top" | Given yellow times are patched even if being too short; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Given yellow times are patched even if being too short
 
|-
 
|-
 
| valign="top" | {{Option|--tls.yellow.time {{DT_INT}}}}
 
| valign="top" | {{Option|--tls.yellow.time {{DT_INT}}}}
 +
| valign="top" |
 
| valign="top" | Set INT as fixed time for yellow phase durations
 
| valign="top" | Set INT as fixed time for yellow phase durations
 
|-
 
|-
 
| valign="top" | {{Option|--tls.half-offset {{DT_STR}}}}
 
| valign="top" | {{Option|--tls.half-offset {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | TLSs in STR will be shifted by half-phase
 
| valign="top" | TLSs in STR will be shifted by half-phase
 
|-
 
|-
 
| valign="top" | {{Option|--tls.quarter-offset {{DT_STR}}}}
 
| valign="top" | {{Option|--tls.quarter-offset {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | TLSs in STR will be shifted by quarter-phase
 
| valign="top" | TLSs in STR will be shifted by quarter-phase
 
|-
 
|-
Line 208: Line 283:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--ramps.guess}}
+
| valign="top" | {{Option|--ramps.guess {{DT_BOOL}}}}
| valign="top" | Enable ramp-guessing; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Enable ramp-guessing
 
|-
 
|-
 
| valign="top" | {{Option|--ramps.max-ramp-speed {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--ramps.max-ramp-speed {{DT_FLOAT}}}}
| valign="top" | Treat edges with speed > FLOAT as no ramps; ''default: '''-1'''''
+
| valign="top" | -1
 +
| valign="top" | Treat edges with speed > FLOAT as no ramps
 
|-
 
|-
 
| valign="top" | {{Option|--ramps.min-highway-speed {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--ramps.min-highway-speed {{DT_FLOAT}}}}
| valign="top" | Treat edges with speed < FLOAT as no highways; ''default: '''21.94'''''
+
| valign="top" | 21.9444
 +
| valign="top" | Treat edges with speed < FLOAT as no highways
 
|-
 
|-
 
| valign="top" | {{Option|--ramps.ramp-length {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--ramps.ramp-length {{DT_FLOAT}}}}
| valign="top" | Use FLOAT as ramp-length; ''default: '''100'''''
+
| valign="top" | 100
 +
| valign="top" | Use FLOAT as ramp-length
 
|-
 
|-
 
| valign="top" | {{Option|--ramps.set {{DT_STR}}}}
 
| valign="top" | {{Option|--ramps.set {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Tries to handle the given edges as ramps
 
| valign="top" | Tries to handle the given edges as ramps
 +
|-
 +
| valign="top" | {{Option|--ramps.no-split {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Avoids edge splitting
 
|-
 
|-
 
|}
 
|}
Line 231: Line 316:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.min-speed {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--keep-edges.min-speed {{DT_FLOAT}}}}
| valign="top" | Remove edges with speed < FLOAT
+
| valign="top" |  
 +
| valign="top" | Only keep edges with speed in meters/second > FLOAT
 
|-
 
|-
 
| valign="top" | {{Option|--remove-edges.explicit {{DT_STR}}}}
 
| valign="top" | {{Option|--remove-edges.explicit {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Remove edges in STR
 
| valign="top" | Remove edges in STR
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.explicit {{DT_STR}}}}
 
| valign="top" | {{Option|--keep-edges.explicit {{DT_STR}}}}
| valign="top" | Remove edges not in STR
+
| valign="top" |  
 +
| valign="top" | Only keep edges in STR
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
 
| valign="top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
| valign="top" | Removed edges not in FILE
+
| valign="top" |  
 +
| valign="top" | Only keep edges in FILE
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.postload}}
+
| valign="top" | {{Option|--keep-edges.postload {{DT_BOOL}}}}
| valign="top" | Remove edges after joining; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Remove edges after joining
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.in-boundary {{DT_STR}}}}
 
| valign="top" | {{Option|--keep-edges.in-boundary {{DT_STR}}}}
| valign="top" | Keeps edges which are located within the given boundary
+
| valign="top" |  
 +
| valign="top" | 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,...>)
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
 
| valign="top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
| valign="top" | Keep edges that allow any of the vclasss in STR
+
| valign="top" |  
 +
| valign="top" | Only keep edges which allow one of the vclasss in STR
 
|-
 
|-
 
| valign="top" | {{Option|--remove-edges.by-vclass {{DT_STR}}}}
 
| valign="top" | {{Option|--remove-edges.by-vclass {{DT_STR}}}}
| valign="top" | Remove edges where vclass def is not in STR
+
| valign="top" |
 +
| valign="top" | Remove edges which allow only vclasses from STR
 +
|-
 +
| valign="top" | {{Option|--keep-edges.by-type {{DT_STR}}}}
 +
| valign="top" |
 +
| valign="top" | Only keep edges where type is in STR
 
|-
 
|-
| valign="top" | {{Option|--remove-edges.isolated}}
+
| valign="top" | {{Option|--remove-edges.by-type {{DT_STR}}}}
| valign="top" | Removes isolated edges; ''default: '''false'''''
+
| valign="top" |
 +
| valign="top" | Remove edges where type is in STR
 +
|-
 +
| valign="top" | {{Option|--remove-edges.isolated {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Removes isolated edges
 
|-
 
|-
 
|}
 
|}
Line 266: Line 369:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--keep-nodes-unregulated}}
+
| valign="top" | {{Option|--keep-nodes-unregulated {{DT_BOOL}}}}
| valign="top" | All nodes will be not regulated; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | All nodes will be unregulated
 
|-
 
|-
 
| valign="top" | {{Option|--keep-nodes-unregulated.explicit {{DT_STR}}}}
 
| valign="top" | {{Option|--keep-nodes-unregulated.explicit {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Do not regulate nodes in STR
 
| valign="top" | Do not regulate nodes in STR
 
|-
 
|-
| valign="top" | {{Option|--keep-nodes-unregulated.district-nodes}}
+
| valign="top" | {{Option|--keep-nodes-unregulated.district-nodes {{DT_BOOL}}}}
| valign="top" | Do not regulate district nodes; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Do not regulate district nodes
 
|-
 
|-
 
|}
 
|}
  
 
===Processing===
 
===Processing===
Normally, both [[NETCONVERT]] and [[NETGENERATE]] translate the read network so that the left- and down-most node are at coordinate (0,0). The following options allow to disable this and to apply different offsets for both the x- and the y-axis. If there are explicit offsets given, the normalization is disabled automatically (thus there is no need to give --disable-normalize-node-positions if there is at least one of the offsets given).
 
 
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--ignore-errors}}
+
| valign="top" | {{Option|--ignore-errors {{DT_BOOL}}}}
| valign="top" | Continue on broken input; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Continue on broken input
 
|-
 
|-
| valign="top" | {{Option|--ignore-errors.connections}}
+
| valign="top" | {{Option|--ignore-errors.connections {{DT_BOOL}}}}
| valign="top" | Continue on invalid connections; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Continue on invalid connections
 +
|-
 +
| valign="top" | {{Option|--show-errors.connections-first-try {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Show errors in connections at parsing
 
|-
 
|-
 
| valign="top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
| valign="top" | The factor for flow to no. lanes conversion; ''default: '''1800'''''
+
| valign="top" | 1800
 +
| valign="top" | The factor for flow to no. lanes conversion.
 
|-
 
|-
| valign="top" | {{Option|--speed-in-kmh}}
+
| valign="top" | {{Option|--speed-in-kmh {{DT_BOOL}}}}
| valign="top" | vmax is parsed as given in km/h (some); ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | vmax is parsed as given in km/h (some)
 
|-
 
|-
| valign="top" | {{Option|--plain.keep-edge-shape}}
+
| valign="top" | {{Option|--plain.extend-edge-shape {{DT_BOOL}}}}
| valign="top" | No node positions are added to the edge shape; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | If edge shapes do not end at the node positions, extend them
 
|-
 
|-
| valign="top" | {{Option|--matsim.keep-length}}
+
| valign="top" | {{Option|--matsim.keep-length {{DT_BOOL}}}}
| valign="top" | The edge lengths given in the MATSIM-file will be kept; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | The edge lengths given in the MATSIM-file will be kept.
 
|-
 
|-
| valign="top" | {{Option|--matsim.lanes-from-capacity}}
+
| valign="top" | {{Option|--matsim.lanes-from-capacity {{DT_BOOL}}}}
| valign="top" | The lane number will be computed from the capacity; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | The lane number will be computed from the capacity.
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.street-id {{DT_STR}}}}
 
| valign="top" | {{Option|--shapefile.street-id {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Read edge ids from column STR
 
| valign="top" | Read edge ids from column STR
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.from-id {{DT_STR}}}}
 
| valign="top" | {{Option|--shapefile.from-id {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Read from-node ids from column STR
 
| valign="top" | Read from-node ids from column STR
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.to-id {{DT_STR}}}}
 
| valign="top" | {{Option|--shapefile.to-id {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Read to-node ids from column STR
 
| valign="top" | Read to-node ids from column STR
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.type-id {{DT_STR}}}}
 
| valign="top" | {{Option|--shapefile.type-id {{DT_STR}}}}
 +
| valign="top" |
 
| valign="top" | Read type ids from column STR
 
| valign="top" | Read type ids from column STR
 
|-
 
|-
| valign="top" | {{Option|--shapefile.use-defaults-on-failure}}
+
| valign="top" | {{Option|--shapefile.use-defaults-on-failure {{DT_BOOL}}}}
| valign="top" | Uses edge type defaults on problems; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Uses edge type defaults on problems
 
|-
 
|-
| valign="top" | {{Option|--shapefile.all-bidirectional}}
+
| valign="top" | {{Option|--shapefile.all-bidirectional {{DT_BOOL}}}}
| valign="top" | Insert edges in both directions; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Insert edges in both directions
 
|-
 
|-
| valign="top" | {{Option|--shapefile.guess-projection}}
+
| valign="top" | {{Option|--shapefile.guess-projection {{DT_BOOL}}}}
| valign="top" | Guess the proper projection; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Guess the proper projection
 
|-
 
|-
 
| valign="top" | {{Option|--vissim.join-distance {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--vissim.join-distance {{DT_FLOAT}}}}
| valign="top" | Structure join offset; ''default: '''5'''''
+
| valign="top" | 5
 +
| valign="top" | Structure join offset
 
|-
 
|-
 
| valign="top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
| valign="top" | Use FLOAT as default speed; ''default: '''50'''''
+
| valign="top" | 50
 +
| valign="top" | Use FLOAT as default speed
 
|-
 
|-
 
| valign="top" | {{Option|--vissim.speed-norm {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--vissim.speed-norm {{DT_FLOAT}}}}
| valign="top" | Factor for edge velocity; ''default: '''1'''''
+
| valign="top" | 1
 +
| valign="top" | Factor for edge velocity
 
|-
 
|-
| valign="top" | {{Option|--vissim.report-unset-speeds}}
+
| valign="top" | {{Option|--vissim.report-unset-speeds {{DT_BOOL}}}}
| valign="top" | Writes lanes without an explicit speed set; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Writes lanes without an explicit speed set.
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-priority}}
+
| valign="top" | {{Option|--visum.use-type-priority {{DT_BOOL}}}}
| valign="top" | Uses priorities from types; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Uses priorities from types
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-laneno}}
+
| valign="top" | {{Option|--visum.use-type-laneno {{DT_BOOL}}}}
| valign="top" | Uses lane numbers from types; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Uses lane numbers from types
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-speed}}
+
| valign="top" | {{Option|--visum.use-type-speed {{DT_BOOL}}}}
| valign="top" | Uses speeds from types; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Uses speeds from types
 
|-
 
|-
 
| valign="top" | {{Option|--visum.connector-speeds {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--visum.connector-speeds {{DT_FLOAT}}}}
| valign="top" | Sets connector speed; ''default: '''100'''''
+
| valign="top" | 100
 +
| valign="top" | Sets connector speed
 
|-
 
|-
 
| valign="top" | {{Option|--visum.connectors-lane-number {{DT_INT}}}}
 
| valign="top" | {{Option|--visum.connectors-lane-number {{DT_INT}}}}
| valign="top" | Sets connector lane number; ''default: '''3'''''
+
| valign="top" | 3
 +
| valign="top" | Sets connector lane number
 +
|-
 +
| valign="top" | {{Option|--visum.no-connectors {{DT_BOOL}}}}
 +
| valign="top" | false
 +
| valign="top" | Excludes connectors
 
|-
 
|-
| valign="top" | {{Option|--visum.no-connectors}}
+
| valign="top" | {{Option|--visum.recompute-lane-number {{DT_BOOL}}}}
| valign="top" | Excludes connectors; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Computes the number of lanes from the edges' capacities
 
|-
 
|-
| valign="top" | {{Option|--visum.recompute-lane-number}}
+
| valign="top" | {{Option|--visum.verbose-warnings {{DT_BOOL}}}}
| valign="top" | Computes the number of lanes from the edges' capacities; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Prints all warnings, some of which are due to VISUM misbehaviour
 
|-
 
|-
| valign="top" | {{Option|--visum.verbose-warnings}}
+
| valign="top" | {{Option|--osm.skip-duplicates-check {{DT_BOOL}}}}
| valign="top" | Prints all warnings, some of which are due to VISUM misbehaviour; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Skips the check for duplicate nodes and edges.
 
|-
 
|-
| valign="top" | {{Option|--osm.skip-duplicates-check}}
+
| valign="top" | {{Option|--no-internal-links {{DT_BOOL}}}}
| valign="top" | Skips the check for duplicate nodes and edges; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Omits internal links
 
|-
 
|-
| valign="top" | {{Option|--no-internal-links}}
+
| valign="top" | {{Option|--dismiss-vclasses {{DT_BOOL}}}}
| valign="top" | Omits internal links; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Removes vehicle class restrictions from imported edges.
 
|-
 
|-
| valign="top" | {{Option|--dismiss-vclasses}}
+
| valign="top" | {{Option|--no-turnarounds {{DT_BOOL}}}}
| valign="top" | Removes vehicle class restrictions from imported edges; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Disables building turnarounds
 
|-
 
|-
| valign="top" | {{Option|--no-turnarounds}}
+
| valign="top" | {{Option|--no-turnarounds.tls {{DT_BOOL}}}}
| valign="top" | Disables building turnarounds; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Disables building turnarounds at tls-controlled junctions
 
|-
 
|-
| valign="top" | {{Option|--no-turnarounds.tls}}
+
| valign="top" | {{Option|--no-left-connections {{DT_BOOL}}}}
| valign="top" | Disables building turnarounds at tls-controlled junctions; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Disables building connections to left
 
|-
 
|-
| valign="top" | {{Option|--no-left-connections}}
+
| valign="top" | {{Option|--geometry.split {{DT_BOOL}}}}
| valign="top" | Disables building connections to left; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Splits edges across geometry nodes
 
|-
 
|-
| valign="top" | {{Option|--geometry.split}}
+
| valign="top" | {{Option|-R {{DT_BOOL}}}}<br/> {{Option|--geometry.remove {{DT_BOOL}}}}
| valign="top" | Splits edges across geometry nodes; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Replace nodes which only define edge geometry by geometry points (joins edges)
 
|-
 
|-
| valign="top" | {{Option|-R}}<br/>{{Option|--geometry.remove}}
+
| valign="top" | {{Option|--geometry.max-segment-length {{DT_FLOAT}}}}
| valign="top" | Removes geometry information from edges; ''default: '''false'''''
+
| valign="top" | 0
 +
| valign="top" | splits geometry to restrict segment length
 
|-
 
|-
| valign="top" | {{Option|--offset.disable-normalization}}
+
| valign="top" | {{Option|--offset.disable-normalization {{DT_BOOL}}}}
| valign="top" | Turn off normalizing node positions; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Turn off normalizing node positions
 
|-
 
|-
 
| valign="top" | {{Option|--offset.x {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--offset.x {{DT_FLOAT}}}}
| valign="top" | Adds FLOAT to net x-positions; ''default: '''0'''''
+
| valign="top" | 0
 +
| valign="top" | Adds FLOAT to net x-positions
 
|-
 
|-
 
| valign="top" | {{Option|--offset.y {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--offset.y {{DT_FLOAT}}}}
| valign="top" | Adds FLOAT to net y-positions; ''default: '''0'''''
+
| valign="top" | 0
 +
| valign="top" | Adds FLOAT to net y-positions
 
|-
 
|-
| valign="top" | {{Option|--flip-y-axis}}
+
| valign="top" | {{Option|--flip-y-axis {{DT_BOOL}}}}
| valign="top" | Flips the y-coordinate along zero; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Flips the y-coordinate along zero
 
|-
 
|-
| valign="top" | {{Option|--roundabouts.guess}}
+
| valign="top" | {{Option|--roundabouts.guess {{DT_BOOL}}}}
| valign="top" | Enable roundabout-guessing; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Enable roundabout-guessing
 
|-
 
|-
| valign="top" | {{Option|--lefthand}}
+
| valign="top" | {{Option|--lefthand {{DT_BOOL}}}}
| valign="top" | Assumes left-hand traffic on the network; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Assumes left-hand traffic on the network
 
|-
 
|-
| valign="top" | {{Option|--junctions.join}}
+
| valign="top" | {{Option|--junctions.join {{DT_BOOL}}}}
| valign="top" | Joins junctions that are close to each other (recommended for OSM import); ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Joins junctions that are close to each other (recommended for OSM import)
 
|-
 
|-
 
| valign="top" | {{Option|--junctions.join-dist {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--junctions.join-dist {{DT_FLOAT}}}}
| valign="top" | Determines the maximal distance for joining junctions; ''default: '''15'''''
+
| valign="top" | 10
 +
| valign="top" | Determines the maximal distance for joining junctions (defaults to 10)
 
|-
 
|-
| valign="top" | {{Option|--junctions.join-exclude {{DT_StringList}}}}
+
| valign="top" | {{Option|--junctions.join-exclude {{DT_STR}}}}
| valign="top" | Interprets argument as a list of junctions to exclude from joining
+
| valign="top" |
 +
| valign="top" | Interprets STR as list of junctions to exclude from joining
 
|-
 
|-
 
| valign="top" | {{Option|--speed.offset {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--speed.offset {{DT_FLOAT}}}}
 +
| valign="top" | 0
 
| valign="top" | Modifies all edge speeds by adding FLOAT
 
| valign="top" | Modifies all edge speeds by adding FLOAT
 
|-
 
|-
 
| valign="top" | {{Option|--speed.factor {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--speed.factor {{DT_FLOAT}}}}
 +
| valign="top" | 1
 
| valign="top" | Modifies all edge speeds by multiplying FLOAT
 
| valign="top" | Modifies all edge speeds by multiplying FLOAT
 +
|-
 +
| valign="top" | {{Option|--tls.join-dist {{DT_FLOAT}}}}
 +
| valign="top" | 20
 +
| valign="top" | Determines the maximal distance for joining traffic lights (defaults to 20)
 
|-
 
|-
 
|}
 
|}
Line 428: Line 591:
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-L {{DT_INT}}}}<br/>{{Option|--default.lanenumber {{DT_INT}}}}
+
| valign="top" | {{Option|-L {{DT_INT}}}}<br/> {{Option|--default.lanenumber {{DT_INT}}}}
| valign="top" | The default number of lanes in an edge; ''default: '''1'''''
+
| valign="top" | 1
 +
| valign="top" | The default number of lanes in an edge
 
|-
 
|-
| valign="top" | {{Option|-S {{DT_FLOAT}}}}<br/>{{Option|--default.speed {{DT_FLOAT}}}}
+
| valign="top" | {{Option|-S {{DT_FLOAT}}}}<br/> {{Option|--default.speed {{DT_FLOAT}}}}
| valign="top" | The default speed on an edge (in m/s); ''default: '''13.9'''''
+
| valign="top" | 13.9
 +
| valign="top" | The default speed on an edge (in m/s)
 
|-
 
|-
| valign="top" | {{Option|-P {{DT_INT}}}}<br/>{{Option|--default.priority {{DT_INT}}}}
+
| valign="top" | {{Option|-P {{DT_INT}}}}<br/> {{Option|--default.priority {{DT_INT}}}}
| valign="top" | The default priority of an edge; ''default: '''-1'''''
+
| valign="top" | -1
 +
| valign="top" | The default priority of an edge
 
|-
 
|-
 
|}
 
|}
  
 
===Report===
 
===Report===
All applications of the '''SUMO'''-suite handle most of the reporting options the same way. These options are discussed at [[Basics/Using the Command Line Applications#Reporting Options]].
 
 
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|-v}}<br/>{{Option|--verbose}}
+
| valign="top" | {{Option|-v {{DT_BOOL}}}}<br/> {{Option|--verbose {{DT_BOOL}}}}
| valign="top" | Switches to verbose output; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Switches to verbose output
 
|-
 
|-
| valign="top" | {{Option|-p}}<br/>{{Option|--print-options}}
+
| valign="top" | {{Option|-p {{DT_BOOL}}}}<br/> {{Option|--print-options {{DT_BOOL}}}}
| valign="top" | Prints option values before processing; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Prints option values before processing
 
|-
 
|-
| valign="top" | {{Option|-?}}<br/>{{Option|--help}}
+
| valign="top" | {{Option|-? {{DT_BOOL}}}}<br/> {{Option|--help {{DT_BOOL}}}}
| valign="top" | Prints this screen; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Prints this screen
 
|-
 
|-
| valign="top" | {{Option|-V}}<br/>{{Option|--version}}
+
| valign="top" | {{Option|-V {{DT_BOOL}}}}<br/> {{Option|--version {{DT_BOOL}}}}
| valign="top" | Prints the current version; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Prints the current version
 
|-
 
|-
| valign="top" | {{Option|-W}}<br/>{{Option|--no-warnings}}
+
| valign="top" | {{Option|-X {{DT_BOOL}}}}<br/> {{Option|--xml-validation {{DT_BOOL}}}}
| valign="top" | Disables output of warnings; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Enable schema validation of XML inputs
 
|-
 
|-
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/>{{Option|--log {{DT_FILE}}}}
+
| valign="top" | {{Option|-W {{DT_BOOL}}}}<br/> {{Option|--no-warnings {{DT_BOOL}}}}
| valign="top" | Writes all messages to FILE
+
| valign="top" | false
 +
| valign="top" | Disables output of warnings
 +
|-
 +
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/> {{Option|--log {{DT_FILE}}}}
 +
| valign="top" |
 +
| valign="top" | Writes all messages to FILE (implies verbose)
 
|-
 
|-
 
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
 
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
| valign="top" | Writes all non-error messages to FILE
+
| valign="top" |
 +
| valign="top" | Writes all non-error messages to FILE (implies verbose)
 
|-
 
|-
 
| valign="top" | {{Option|--error-log {{DT_FILE}}}}
 
| valign="top" | {{Option|--error-log {{DT_FILE}}}}
 +
| valign="top" |
 
| valign="top" | Writes all warnings and errors to FILE
 
| valign="top" | Writes all warnings and errors to FILE
 
|-
 
|-
Line 477: Line 655:
  
 
===Random Number===
 
===Random Number===
All applications of the '''SUMO'''-suite handle randomisation options the same way. These options are discussed at [[Basics/Using the Command Line Applications#Random Number Options]].
 
 
 
{| cellspacing="0" border="1" width="90%" align="center"
 
{| cellspacing="0" border="1" width="90%" align="center"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" width="350" | Option
+
! style="background:#ddffdd;" valign="top" | Option
 +
! style="background:#ddffdd;" valign="top" | Default Value
 
! style="background:#ddffdd;" valign="top" | Description
 
! style="background:#ddffdd;" valign="top" | Description
 
|-
 
|-
| valign="top" | {{Option|--random}}
+
| valign="top" | {{Option|--random {{DT_BOOL}}}}
| valign="top" | Initialises the random number generator with the current system time; ''default: '''false'''''
+
| valign="top" | false
 +
| valign="top" | Initialises the random number generator with the current system time
 
|-
 
|-
 
| valign="top" | {{Option|--seed {{DT_INT}}}}
 
| valign="top" | {{Option|--seed {{DT_INT}}}}
| valign="top" | Initialises the random number generator with the given value; ''default: '''23423'''''
+
| valign="top" | 23423
 +
| valign="top" | Initialises the random number generator with the given value
 
|-
 
|-
 
|}
 
|}
 
  
 
------
 
------
  
 
[[Category:ApplicationDescription]]
 
[[Category:ApplicationDescription]]

Revision as of 21:37, 3 December 2012

From 30.000 feet

NETCONVERT imports digital road networks from different sources and generates road networks that can be used by other tools from the package.

Purpose: Road networks import and conversion
System: portable (Linux/Windows is tested); runs on command line
Input (mandatory): Definition of a road network
Output: A generated SUMO-road network; optionally also other outputs
Programming Language: c++

Usage Description

NETCONVERT is a command line application. It assumes at least one parameter - the combination of the name of the file type to import as parameter name and the name of the file to import as parameter value. So, for importing a network from OpenStreetMap one could simply write:

netconvert --osm my_osm_net.xml

and for importing a VISUM-network:

netconvert --visum my_visum_net.net

In both cases, as no output name is given, the SUMO network generated from the imported data is written into the file "net.net.xml". To write the network into a different file, use the option -o <OUTPUT_FILE>. If you want to save the imported VISUM-network into a file named "my_sumo_net.net.xml", write:

netconvert --visum my_visum_net.net -o my_sumo_net.net.xml

Many further parameter steer how the network is imported and how the resulting SUMO-network is generated.

Supported Formats

NETCONVERT is able to import road networks from the following formats:

Options

You may use a XML schema definition file for setting up a NETCONVERT configuration: netconvertConfiguration.xsd.

Configuration

All applications of the SUMO-suite handle configuration options the same way. These options are discussed at Basics/Using the Command Line Applications#Configuration Files.

Option Default Value Description
-c <FILE>
--configuration-file <FILE>
Loads the named config on startup
--save-configuration <FILE> Saves current configuration into FILE
--save-template <FILE> Saves a configuration template (empty) into FILE
--save-schema <FILE> Saves the configuration schema into FILE
--save-commented <BOOL> false Adds comments to saved template, configuration, or schema

Input

Option Default Value Description
-s <FILE>
--sumo-net-file <FILE>
Read SUMO-net from FILE
-n <FILE>
--node-files <FILE>
Read XML-node defs from FILE
-e <FILE>
--edge-files <FILE>
Read XML-edge defs from FILE
-x <FILE>
--connection-files <FILE>
Read XML-connection defs from FILE
-i <FILE>
--tllogic-files <FILE>
Read XML-traffic light defs from FILE
-t <FILE>
--type-files <FILE>
Read XML-type defs from FILE
--shapefile-prefix <FILE> Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
--dlr-navteq-prefix <FILE> Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
--osm-files <FILE> Read OSM-network from path 'FILE(s)'
--opendrive-files <FILE> Read openDrive-network from FILE
--visum-file <FILE> Read VISUM-net from FILE
--vissim-file <FILE> Read VISSIM-net from FILE
--robocup-dir <FILE> Read RoboCup-net from DIR
--matsim-files <FILE> Read MATsim-net from FILE
--itsumo-files <FILE> Read ITSUMO-net from FILE

Output

Option Default Value Description
-o <FILE>
--output-file <FILE>
The generated net will be written to FILE
--plain-output-prefix <FILE> Prefix of files to write plain xml nodes, edges and connections to
--junctions.join-output <FILE> Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins
-M <FILE>
--map-output <FILE>
Writes joined edges information to FILE
--matsim-output <FILE> The generated net will be written to FILE using MATsim format.
--opendrive-output <FILE> The generated net will be written to FILE using openDRIVE format.
--dlr-navteq-output <FILE> The generated net will be written to dlr-navteq files with the given PREFIX.
--output.street-names <BOOL> false Street names will be included in the output (if available).
--output.original-names <BOOL> false Writes original names, if given, as parameter.
--street-sign-output <FILE> Writes street signs as POIs to FILE.

Projection

Option Default Value Description
--simple-projection <BOOL> false Uses a simple method for projection
--proj.scale <INT> 0 Number of places to shift decimal point to right in geo-coordinates
--proj.utm <BOOL> false Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
--proj.dhdn <BOOL> false Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid)
--proj <STRING> ! Uses STR as proj.4 definition for projection
--proj.inverse <BOOL> false Inverses projection
--proj.plain-geo <BOOL> false Write geo coordinates in plain-xml

Tls Building

Option Default Value Description
--tls.discard-loaded <BOOL> false Does not instatiate traffic lights loaded from other formats than XML
--tls.set <STRING> Interprets STR as list of junctions to be controlled by TLS
--tls.unset <STRING> Interprets STR as list of junctions to be not controlled by TLS
--tls.guess <BOOL> false Turns on TLS guessing
--tls.taz-nodes <BOOL> false Sets district nodes as tls-controlled
--tls-guess.joining <BOOL> false Includes node clusters into guess
--tls.join <BOOL> false Tries to cluster tls-controlled nodes
--tls.green.time <INT> 31 Use INT as green phase duration
-D <FLOAT>
--tls.yellow.min-decel <FLOAT>
3 Defines smallest vehicle deceleration
--tls.yellow.patch-small <BOOL> false Given yellow times are patched even if being too short
--tls.yellow.time <INT> Set INT as fixed time for yellow phase durations
--tls.half-offset <STRING> TLSs in STR will be shifted by half-phase
--tls.quarter-offset <STRING> TLSs in STR will be shifted by quarter-phase

Ramp Guessing

Option Default Value Description
--ramps.guess <BOOL> false Enable ramp-guessing
--ramps.max-ramp-speed <FLOAT> -1 Treat edges with speed > FLOAT as no ramps
--ramps.min-highway-speed <FLOAT> 21.9444 Treat edges with speed < FLOAT as no highways
--ramps.ramp-length <FLOAT> 100 Use FLOAT as ramp-length
--ramps.set <STRING> Tries to handle the given edges as ramps
--ramps.no-split <BOOL> false Avoids edge splitting

Edge Removal

Option Default Value Description
--keep-edges.min-speed <FLOAT> Only keep edges with speed in meters/second > FLOAT
--remove-edges.explicit <STRING> Remove edges in STR
--keep-edges.explicit <STRING> Only keep edges in STR
--keep-edges.input-file <FILE> Only keep edges in FILE
--keep-edges.postload <BOOL> false Remove edges after joining
--keep-edges.in-boundary <STRING> 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.by-vclass <STRING> Only keep edges which allow one of the vclasss in STR
--remove-edges.by-vclass <STRING> Remove edges which allow only vclasses from STR
--keep-edges.by-type <STRING> Only keep edges where type is in STR
--remove-edges.by-type <STRING> Remove edges where type is in STR
--remove-edges.isolated <BOOL> false Removes isolated edges

Unregulated Nodes

Option Default Value Description
--keep-nodes-unregulated <BOOL> false All nodes will be unregulated
--keep-nodes-unregulated.explicit <STRING> Do not regulate nodes in STR
--keep-nodes-unregulated.district-nodes <BOOL> false Do not regulate district nodes

Processing

Option Default Value Description
--ignore-errors <BOOL> false Continue on broken input
--ignore-errors.connections <BOOL> false Continue on invalid connections
--show-errors.connections-first-try <BOOL> false Show errors in connections at parsing
--lanes-from-capacity.norm <FLOAT> 1800 The factor for flow to no. lanes conversion.
--speed-in-kmh <BOOL> false vmax is parsed as given in km/h (some)
--plain.extend-edge-shape <BOOL> false If edge shapes do not end at the node positions, extend them
--matsim.keep-length <BOOL> false The edge lengths given in the MATSIM-file will be kept.
--matsim.lanes-from-capacity <BOOL> false The lane number will be computed from the capacity.
--shapefile.street-id <STRING> Read edge ids from column STR
--shapefile.from-id <STRING> Read from-node ids from column STR
--shapefile.to-id <STRING> Read to-node ids from column STR
--shapefile.type-id <STRING> Read type ids from column STR
--shapefile.use-defaults-on-failure <BOOL> false Uses edge type defaults on problems
--shapefile.all-bidirectional <BOOL> false Insert edges in both directions
--shapefile.guess-projection <BOOL> false Guess the proper projection
--vissim.join-distance <FLOAT> 5 Structure join offset
--vissim.default-speed <FLOAT> 50 Use FLOAT as default speed
--vissim.speed-norm <FLOAT> 1 Factor for edge velocity
--vissim.report-unset-speeds <BOOL> false Writes lanes without an explicit speed set.
--visum.use-type-priority <BOOL> false Uses priorities from types
--visum.use-type-laneno <BOOL> false Uses lane numbers from types
--visum.use-type-speed <BOOL> false Uses speeds from types
--visum.connector-speeds <FLOAT> 100 Sets connector speed
--visum.connectors-lane-number <INT> 3 Sets connector lane number
--visum.no-connectors <BOOL> false Excludes connectors
--visum.recompute-lane-number <BOOL> false Computes the number of lanes from the edges' capacities
--visum.verbose-warnings <BOOL> false Prints all warnings, some of which are due to VISUM misbehaviour
--osm.skip-duplicates-check <BOOL> false Skips the check for duplicate nodes and edges.
--no-internal-links <BOOL> false Omits internal links
--dismiss-vclasses <BOOL> false Removes vehicle class restrictions from imported edges.
--no-turnarounds <BOOL> false Disables building turnarounds
--no-turnarounds.tls <BOOL> false Disables building turnarounds at tls-controlled junctions
--no-left-connections <BOOL> false Disables building connections to left
--geometry.split <BOOL> false Splits edges across geometry nodes
-R <BOOL>
--geometry.remove <BOOL>
false Replace nodes which only define edge geometry by geometry points (joins edges)
--geometry.max-segment-length <FLOAT> 0 splits geometry to restrict segment length
--offset.disable-normalization <BOOL> false Turn off normalizing node positions
--offset.x <FLOAT> 0 Adds FLOAT to net x-positions
--offset.y <FLOAT> 0 Adds FLOAT to net y-positions
--flip-y-axis <BOOL> false Flips the y-coordinate along zero
--roundabouts.guess <BOOL> false Enable roundabout-guessing
--lefthand <BOOL> false Assumes left-hand traffic on the network
--junctions.join <BOOL> false Joins junctions that are close to each other (recommended for OSM import)
--junctions.join-dist <FLOAT> 10 Determines the maximal distance for joining junctions (defaults to 10)
--junctions.join-exclude <STRING> Interprets STR as list of junctions to exclude from joining
--speed.offset <FLOAT> 0 Modifies all edge speeds by adding FLOAT
--speed.factor <FLOAT> 1 Modifies all edge speeds by multiplying FLOAT
--tls.join-dist <FLOAT> 20 Determines the maximal distance for joining traffic lights (defaults to 20)

Building Defaults

Option Default Value Description
-L <INT>
--default.lanenumber <INT>
1 The default number of lanes in an edge
-S <FLOAT>
--default.speed <FLOAT>
13.9 The default speed on an edge (in m/s)
-P <INT>
--default.priority <INT>
-1 The default priority of an edge

Report

Option Default Value Description
-v <BOOL>
--verbose <BOOL>
false Switches to verbose output
-p <BOOL>
--print-options <BOOL>
false Prints option values before processing
-? <BOOL>
--help <BOOL>
false Prints this screen
-V <BOOL>
--version <BOOL>
false Prints the current version
-X <BOOL>
--xml-validation <BOOL>
false Enable schema validation of XML inputs
-W <BOOL>
--no-warnings <BOOL>
false Disables output of warnings
-l <FILE>
--log <FILE>
Writes all messages to FILE (implies verbose)
--message-log <FILE> Writes all non-error messages to FILE (implies verbose)
--error-log <FILE> Writes all warnings and errors to FILE

Random Number

Option Default Value Description
--random <BOOL> false Initialises the random number generator with the current system time
--seed <INT> 23423 Initialises the random number generator with the given value