Difference between revisions of "NETCONVERT"

From Sumo
Jump to navigation Jump to search
(Options)
Line 13: Line 13:
 
and for importing a VISUM-network:
 
and for importing a VISUM-network:
 
  netconvert --visum my_visum_net.net
 
  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:
+
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 ''&lt;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
 
  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.
 
Many further parameter steer how the network is imported and how the resulting SUMO-network is generated.
Line 36: Line 36:
 
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]].
 
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]].
  
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-c {{DT_FILE}}}}<br/> {{Option|--configuration-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-c {{DT_FILE}}}}<br/> {{Option|--configuration-file {{DT_FILE}}}}
| valign="top" | Loads the named config on startup
+
| style="vertical-align:top" | Loads the named config on startup
 
|-
 
|-
| valign="top" | {{Option|--save-configuration {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--save-configuration {{DT_FILE}}}}
| valign="top" | Saves current configuration into FILE
+
| style="vertical-align:top" | Saves current configuration into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-template {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--save-template {{DT_FILE}}}}
| valign="top" | Saves a configuration template (empty) into FILE
+
| style="vertical-align:top" | Saves a configuration template (empty) into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-schema {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--save-schema {{DT_FILE}}}}
| valign="top" | Saves the configuration schema into FILE
+
| style="vertical-align:top" | Saves the configuration schema into FILE
 
|-
 
|-
| valign="top" | {{Option|--save-commented {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--save-commented {{DT_BOOL}}}}
| valign="top" | Adds comments to saved template, configuration, or schema; ''default: false''
+
| style="vertical-align:top" | Adds comments to saved template, configuration, or schema; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Input===
 
===Input===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-s {{DT_FILE}}}}<br/> {{Option|--sumo-net-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-s {{DT_FILE}}}}<br/> {{Option|--sumo-net-file {{DT_FILE}}}}
| valign="top" | Read SUMO-net from FILE
+
| style="vertical-align:top" | Read SUMO-net from FILE
 
|-
 
|-
| valign="top" | {{Option|-n {{DT_FILE}}}}<br/> {{Option|--node-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-n {{DT_FILE}}}}<br/> {{Option|--node-files {{DT_FILE}}}}
| valign="top" | Read XML-node defs from FILE
+
| style="vertical-align:top" | Read XML-node defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-e {{DT_FILE}}}}<br/> {{Option|--edge-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-e {{DT_FILE}}}}<br/> {{Option|--edge-files {{DT_FILE}}}}
| valign="top" | Read XML-edge defs from FILE
+
| style="vertical-align:top" | Read XML-edge defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-x {{DT_FILE}}}}<br/> {{Option|--connection-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-x {{DT_FILE}}}}<br/> {{Option|--connection-files {{DT_FILE}}}}
| valign="top" | Read XML-connection defs from FILE
+
| style="vertical-align:top" | Read XML-connection defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-i {{DT_FILE}}}}<br/> {{Option|--tllogic-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-i {{DT_FILE}}}}<br/> {{Option|--tllogic-files {{DT_FILE}}}}
| valign="top" | Read XML-traffic light defs from FILE
+
| style="vertical-align:top" | Read XML-traffic light defs from FILE
 
|-
 
|-
| valign="top" | {{Option|-t {{DT_FILE}}}}<br/> {{Option|--type-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-t {{DT_FILE}}}}<br/> {{Option|--type-files {{DT_FILE}}}}
| valign="top" | Read XML-type defs from FILE
+
| style="vertical-align:top" | Read XML-type defs from FILE
 
|-
 
|-
| valign="top" | {{Option|--shapefile-prefix {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--shapefile-prefix {{DT_FILE}}}}
| valign="top" | Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
+
| style="vertical-align:top" | Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'
 
|-
 
|-
| valign="top" | {{Option|--dlr-navteq-prefix {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--dlr-navteq-prefix {{DT_FILE}}}}
| valign="top" | Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
+
| style="vertical-align:top" | Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'
 
|-
 
|-
| valign="top" | {{Option|--osm-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--osm-files {{DT_FILE}}}}
| valign="top" | Read OSM-network from path 'FILE(s)'
+
| style="vertical-align:top" | Read OSM-network from path 'FILE(s)'
 
|-
 
|-
| valign="top" | {{Option|--opendrive-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--opendrive-files {{DT_FILE}}}}
| valign="top" | Read OpenDRIVE-network from FILE
+
| style="vertical-align:top" | Read OpenDRIVE-network from FILE
 
|-
 
|-
| valign="top" | {{Option|--visum-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--visum-file {{DT_FILE}}}}
| valign="top" | Read VISUM-net from FILE
+
| style="vertical-align:top" | Read VISUM-net from FILE
 
|-
 
|-
| valign="top" | {{Option|--vissim-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--vissim-file {{DT_FILE}}}}
| valign="top" | Read VISSIM-net from FILE
+
| style="vertical-align:top" | Read VISSIM-net from FILE
 
|-
 
|-
| valign="top" | {{Option|--robocup-dir {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--robocup-dir {{DT_FILE}}}}
| valign="top" | Read RoboCup-net from DIR
+
| style="vertical-align:top" | Read RoboCup-net from DIR
 
|-
 
|-
| valign="top" | {{Option|--matsim-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--matsim-files {{DT_FILE}}}}
| valign="top" | Read MATsim-net from FILE
+
| style="vertical-align:top" | Read MATsim-net from FILE
 
|-
 
|-
| valign="top" | {{Option|--itsumo-files {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--itsumo-files {{DT_FILE}}}}
| valign="top" | Read ITSUMO-net from FILE
+
| style="vertical-align:top" | Read ITSUMO-net from FILE
 
|-
 
|-
 
|}
 
|}
  
 
===Output===
 
===Output===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-o {{DT_FILE}}}}<br/> {{Option|--output-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-o {{DT_FILE}}}}<br/> {{Option|--output-file {{DT_FILE}}}}
| valign="top" | The generated net will be written to FILE
+
| style="vertical-align:top" | The generated net will be written to FILE
 
|-
 
|-
| valign="top" | {{Option|--plain-output-prefix {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--plain-output-prefix {{DT_FILE}}}}
| valign="top" | Prefix of files to write plain xml nodes, edges and connections to
+
| style="vertical-align:top" | Prefix of files to write plain xml nodes, edges and connections to
 
|-
 
|-
| valign="top" | {{Option|--junctions.join-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--junctions.join-output {{DT_FILE}}}}
| valign="top" | Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins
+
| style="vertical-align: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}}}}
+
| style="vertical-align:top" | {{Option|-M {{DT_FILE}}}}<br/> {{Option|--map-output {{DT_FILE}}}}
| valign="top" | Writes joined edges information to FILE
+
| style="vertical-align:top" | Writes joined edges information to FILE
 
|-
 
|-
| valign="top" | {{Option|--matsim-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--matsim-output {{DT_FILE}}}}
| valign="top" | The generated net will be written to FILE using MATsim format.
+
| style="vertical-align:top" | The generated net will be written to FILE using MATsim format
 
|-
 
|-
| valign="top" | {{Option|--opendrive-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--opendrive-output {{DT_FILE}}}}
| valign="top" | The generated net will be written to FILE using OpenDRIVE format.
+
| style="vertical-align:top" | The generated net will be written to FILE using OpenDRIVE format
 
|-
 
|-
| valign="top" | {{Option|--dlr-navteq-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--dlr-navteq-output {{DT_FILE}}}}
| valign="top" | The generated net will be written to dlr-navteq files with the given PREFIX.
+
| style="vertical-align:top" | The generated net will be written to dlr-navteq files with the given PREFIX
 
|-
 
|-
| valign="top" | {{Option|--output.street-names {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--output.street-names {{DT_BOOL}}}}
| valign="top" | Street names will be included in the output (if available); ''default: false''
+
| style="vertical-align:top" | Street names will be included in the output (if available); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--output.original-names {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--output.original-names {{DT_BOOL}}}}
| valign="top" | Writes original names, if given, as parameter; ''default: false''
+
| style="vertical-align:top" | Writes original names, if given, as parameter; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--street-sign-output {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--street-sign-output {{DT_FILE}}}}
| valign="top" | Writes street signs as POIs to FILE.
+
| style="vertical-align:top" | Writes street signs as POIs to FILE
 
|-
 
|-
 
|}
 
|}
  
 
===Projection===
 
===Projection===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--simple-projection {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--simple-projection {{DT_BOOL}}}}
| valign="top" | Uses a simple method for projection; ''default: false''
+
| style="vertical-align:top" | Uses a simple method for projection; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--proj.scale {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--proj.scale {{DT_INT}}}}
| valign="top" | Number of places to shift decimal point to right in geo-coordinates; ''default: 0''
+
| style="vertical-align:top" | Number of places to shift decimal point to right in geo-coordinates; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--proj.utm {{DT_BOOL}}}}
+
| style="vertical-align: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''
+
| style="vertical-align:top" | Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--proj.dhdn {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--proj.dhdn {{DT_BOOL}}}}
| valign="top" | Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid); ''default: false''
+
| style="vertical-align:top" | Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--proj {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--proj {{DT_STR}}}}
| valign="top" | Uses STR as proj.4 definition for projection; ''default: !''
+
| style="vertical-align:top" | Uses STR as proj.4 definition for projection; ''default: '''!'''''
 
|-
 
|-
| valign="top" | {{Option|--proj.inverse {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--proj.inverse {{DT_BOOL}}}}
| valign="top" | Inverses projection; ''default: false''
+
| style="vertical-align:top" | Inverses projection; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--proj.plain-geo {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--proj.plain-geo {{DT_BOOL}}}}
| valign="top" | Write geo coordinates in plain-xml; ''default: false''
+
| style="vertical-align:top" | Write geo coordinates in plain-xml; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
===TLS Building===
+
===Tls Building===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--tls.discard-loaded {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tls.discard-loaded {{DT_BOOL}}}}
| valign="top" | Does not instatiate traffic lights loaded from other formats than XML; ''default: false''
+
| style="vertical-align:top" | Does not instatiate traffic lights loaded from other formats than XML; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.set {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--tls.discard-simple {{DT_BOOL}}}}
| valign="top" | Interprets STR as list of junctions to be controlled by TLS
+
| style="vertical-align:top" | Does not instatiate traffic lights at geometry-like nodes loaded from other formats than XML; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.unset {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--tls.set {{DT_STR}}}}
| valign="top" | Interprets STR as list of junctions to be not controlled by TLS
+
| style="vertical-align:top" | Interprets STR as list of junctions to be controlled by TLS
 
|-
 
|-
| valign="top" | {{Option|--tls.guess {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tls.unset {{DT_STR}}}}
| valign="top" | Turns on TLS guessing; ''default: false''
+
| style="vertical-align:top" | Interprets STR as list of junctions to be not controlled by TLS
 
|-
 
|-
| valign="top" | {{Option|--tls.taz-nodes {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tls.guess {{DT_BOOL}}}}
| valign="top" | Sets district nodes as tls-controlled; ''default: false''
+
| style="vertical-align:top" | Turns on TLS guessing; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls-guess.joining {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tls.taz-nodes {{DT_BOOL}}}}
| valign="top" | Includes node clusters into guess; ''default: false''
+
| style="vertical-align:top" | Sets district nodes as tls-controlled; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.join {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--tls-guess.joining {{DT_BOOL}}}}
| valign="top" | Tries to cluster tls-controlled nodes; ''default: false''
+
| style="vertical-align:top" | Includes node clusters into guess; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.green.time {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--tls.join {{DT_BOOL}}}}
| valign="top" | Use INT as green phase duration; ''default: 31''
+
| style="vertical-align:top" | Tries to cluster tls-controlled nodes; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-D {{DT_FLOAT}}}}<br/> {{Option|--tls.yellow.min-decel {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--tls.green.time {{DT_INT}}}}
| valign="top" | Defines smallest vehicle deceleration; ''default: 3''
+
| style="vertical-align:top" | Use INT as green phase duration; ''default: '''31'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.yellow.patch-small {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-D {{DT_FLOAT}}}}<br/> {{Option|--tls.yellow.min-decel {{DT_FLOAT}}}}
| valign="top" | Given yellow times are patched even if being too short; ''default: false''
+
| style="vertical-align:top" | Defines smallest vehicle deceleration; ''default: '''3'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.yellow.time {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--tls.yellow.patch-small {{DT_BOOL}}}}
| valign="top" | Set INT as fixed time for yellow phase durations
+
| style="vertical-align:top" | Given yellow times are patched even if being too short; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.half-offset {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--tls.yellow.time {{DT_INT}}}}
| valign="top" | TLSs in STR will be shifted by half-phase
+
| style="vertical-align:top" | Set INT as fixed time for yellow phase durations
 
|-
 
|-
| valign="top" | {{Option|--tls.quarter-offset {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--tls.half-offset {{DT_STR}}}}
| valign="top" | TLSs in STR will be shifted by quarter-phase
+
| style="vertical-align:top" | TLSs in STR will be shifted by half-phase
 +
|-
 +
| style="vertical-align:top" | {{Option|--tls.quarter-offset {{DT_STR}}}}
 +
| style="vertical-align:top" | TLSs in STR will be shifted by quarter-phase
 +
|-
 +
| style="vertical-align:top" | {{Option|--tls.default-type {{DT_STR}}}}
 +
| style="vertical-align:top" | TLSs with unspecified type will use STR as their algorithm; ''default: '''static'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Ramp Guessing===
 
===Ramp Guessing===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--ramps.guess {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--ramps.guess {{DT_BOOL}}}}
| valign="top" | Enable ramp-guessing; ''default: false''
+
| style="vertical-align:top" | Enable ramp-guessing; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--ramps.max-ramp-speed {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--ramps.max-ramp-speed {{DT_FLOAT}}}}
| valign="top" | Treat edges with speed > FLOAT as no ramps; ''default: -1''
+
| style="vertical-align:top" | Treat edges with speed > FLOAT as no ramps; ''default: '''-1'''''
 
|-
 
|-
| valign="top" | {{Option|--ramps.min-highway-speed {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--ramps.min-highway-speed {{DT_FLOAT}}}}
| valign="top" | Treat edges with speed < FLOAT as no highways; ''default: 21.9444''
+
| style="vertical-align:top" | Treat edges with speed < FLOAT as no highways; ''default: '''21.9444'''''
 
|-
 
|-
| valign="top" | {{Option|--ramps.ramp-length {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--ramps.ramp-length {{DT_FLOAT}}}}
| valign="top" | Use FLOAT as ramp-length; ''default: 100''
+
| style="vertical-align:top" | Use FLOAT as ramp-length; ''default: '''100'''''
 
|-
 
|-
| valign="top" | {{Option|--ramps.set {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--ramps.set {{DT_STR}}}}
| valign="top" | Tries to handle the given edges as ramps
+
| style="vertical-align:top" | Tries to handle the given edges as ramps
 
|-
 
|-
| valign="top" | {{Option|--ramps.no-split {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--ramps.no-split {{DT_BOOL}}}}
| valign="top" | Avoids edge splitting; ''default: false''
+
| style="vertical-align:top" | Avoids edge splitting; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Edge Removal===
 
===Edge Removal===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 +
|-
 +
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
 +
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
| style="vertical-align:top" | {{Option|--keep-edges.min-speed {{DT_FLOAT}}}}
! style="background:#ddffdd;" valign="top" | Description
+
| style="vertical-align:top" | Only keep edges with speed in meters/second > FLOAT
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.min-speed {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--remove-edges.explicit {{DT_STR}}}}
| valign="top" | Only keep edges with speed in meters/second > FLOAT
+
| style="vertical-align:top" | Remove edges in STR
 
|-
 
|-
| valign="top" | {{Option|--remove-edges.explicit {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.explicit {{DT_STR}}}}
| valign="top" | Remove edges in STR
+
| style="vertical-align:top" | Only keep edges in STR
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.explicit {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
| valign="top" | Only keep edges in STR
+
| style="vertical-align:top" | Only keep edges in FILE
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.postload {{DT_BOOL}}}}
| valign="top" | Only keep edges in FILE
+
| style="vertical-align:top" | Remove edges after joining; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.postload {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.in-boundary {{DT_STR}}}}
| valign="top" | Remove edges after joining; ''default: false''
+
| style="vertical-align: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.in-boundary {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.in-geo-boundary {{DT_STR}}}}
| 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,...>)
+
| style="vertical-align:top" | 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,...>)
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
| valign="top" | Only keep edges which allow one of the vclasss in STR
+
| style="vertical-align:top" | Only keep edges which allow one of the vclasss in STR
 
|-
 
|-
| valign="top" | {{Option|--remove-edges.by-vclass {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--remove-edges.by-vclass {{DT_STR}}}}
| valign="top" | Remove edges which allow only vclasses from STR
+
| style="vertical-align:top" | Remove edges which allow only vclasses from STR
 
|-
 
|-
| valign="top" | {{Option|--keep-edges.by-type {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-edges.by-type {{DT_STR}}}}
| valign="top" | Only keep edges where type is in STR
+
| style="vertical-align:top" | Only keep edges where type is in STR
 
|-
 
|-
| valign="top" | {{Option|--remove-edges.by-type {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--remove-edges.by-type {{DT_STR}}}}
| valign="top" | Remove edges where type is in STR
+
| style="vertical-align:top" | Remove edges where type is in STR
 
|-
 
|-
| valign="top" | {{Option|--remove-edges.isolated {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--remove-edges.isolated {{DT_BOOL}}}}
| valign="top" | Removes isolated edges; ''default: false''
+
| style="vertical-align:top" | Removes isolated edges; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Unregulated Nodes===
 
===Unregulated Nodes===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--keep-nodes-unregulated {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--keep-nodes-unregulated {{DT_BOOL}}}}
| valign="top" | All nodes will be unregulated; ''default: false''
+
| style="vertical-align:top" | All nodes will be unregulated; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--keep-nodes-unregulated.explicit {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--keep-nodes-unregulated.explicit {{DT_STR}}}}
| valign="top" | Do not regulate nodes in STR
+
| style="vertical-align:top" | Do not regulate nodes in STR
 
|-
 
|-
| valign="top" | {{Option|--keep-nodes-unregulated.district-nodes {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--keep-nodes-unregulated.district-nodes {{DT_BOOL}}}}
| valign="top" | Do not regulate district nodes; ''default: false''
+
| style="vertical-align:top" | Do not regulate district nodes; ''default: '''false'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Processing===
 
===Processing===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 +
|-
 +
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
 +
! style="background:#ddffdd; vertical-align:top" | Description
 +
|-
 +
| style="vertical-align:top" | {{Option|--ignore-errors {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Continue on broken input; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--ignore-errors.connections {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Continue on invalid connections; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--show-errors.connections-first-try {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Show errors in connections at parsing; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--ignore-errors.edge-type {{DT_BOOL}}}}
 +
| style="vertical-align:top" | Continue on unknown edge types; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
 +
| style="vertical-align:top" | The factor for flow to no. lanes conversion; ''default: '''1800'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--speed-in-kmh {{DT_BOOL}}}}
 +
| style="vertical-align:top" | vmax is parsed as given in km/h (some); ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--plain.extend-edge-shape {{DT_BOOL}}}}
 +
| style="vertical-align:top" | If edge shapes do not end at the node positions, extend them; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--matsim.keep-length {{DT_BOOL}}}}
 +
| style="vertical-align:top" | The edge lengths given in the MATSIM-file will be kept; ''default: '''false'''''
 +
|-
 +
| style="vertical-align:top" | {{Option|--matsim.lanes-from-capacity {{DT_BOOL}}}}
 +
| style="vertical-align:top" | The lane number will be computed from the capacity; ''default: '''false'''''
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
| style="vertical-align:top" | {{Option|--shapefile.street-id {{DT_STR}}}}
! style="background:#ddffdd;" valign="top" | Description
+
| style="vertical-align:top" | Read edge ids from column STR
 
|-
 
|-
| valign="top" | {{Option|--ignore-errors {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.from-id {{DT_STR}}}}
| valign="top" | Continue on broken input; ''default: false''
+
| style="vertical-align:top" | Read from-node ids from column STR
 
|-
 
|-
| valign="top" | {{Option|--ignore-errors.connections {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.to-id {{DT_STR}}}}
| valign="top" | Continue on invalid connections; ''default: false''
+
| style="vertical-align:top" | Read to-node ids from column STR
 
|-
 
|-
| valign="top" | {{Option|--show-errors.connections-first-try {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.type-id {{DT_STR}}}}
| valign="top" | Show errors in connections at parsing; ''default: false''
+
| style="vertical-align:top" | Read type ids from column STR
 
|-
 
|-
| valign="top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.use-defaults-on-failure {{DT_BOOL}}}}
| valign="top" | The factor for flow to no. lanes conversion; ''default: 1800''
+
| style="vertical-align:top" | Uses edge type defaults on problems; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--speed-in-kmh {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.all-bidirectional {{DT_BOOL}}}}
| valign="top" | vmax is parsed as given in km/h (some); ''default: false''
+
| style="vertical-align:top" | Insert edges in both directions; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--plain.extend-edge-shape {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--shapefile.guess-projection {{DT_BOOL}}}}
| valign="top" | If edge shapes do not end at the node positions, extend them; ''default: false''
+
| style="vertical-align:top" | Guess the proper projection; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--matsim.keep-length {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--vissim.join-distance {{DT_FLOAT}}}}
| valign="top" | The edge lengths given in the MATSIM-file will be kept; ''default: false''
+
| style="vertical-align:top" | Structure join offset; ''default: '''5'''''
 
|-
 
|-
| valign="top" | {{Option|--matsim.lanes-from-capacity {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
| valign="top" | The lane number will be computed from the capacity; ''default: false''
+
| style="vertical-align:top" | Use FLOAT as default speed; ''default: '''50'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.street-id {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--vissim.speed-norm {{DT_FLOAT}}}}
| valign="top" | Read edge ids from column STR
+
| style="vertical-align:top" | Factor for edge velocity; ''default: '''1'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.from-id {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--vissim.report-unset-speeds {{DT_BOOL}}}}
| valign="top" | Read from-node ids from column STR
+
| style="vertical-align:top" | Writes lanes without an explicit speed set; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.to-id {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--visum.use-type-priority {{DT_BOOL}}}}
| valign="top" | Read to-node ids from column STR
+
| style="vertical-align:top" | Uses priorities from types; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.type-id {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--visum.use-type-laneno {{DT_BOOL}}}}
| valign="top" | Read type ids from column STR
+
| style="vertical-align:top" | Uses lane numbers from types; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.use-defaults-on-failure {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--visum.use-type-speed {{DT_BOOL}}}}
| valign="top" | Uses edge type defaults on problems; ''default: false''
+
| style="vertical-align:top" | Uses speeds from types; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.all-bidirectional {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--visum.connector-speeds {{DT_FLOAT}}}}
| valign="top" | Insert edges in both directions; ''default: false''
+
| style="vertical-align:top" | Sets connector speed; ''default: '''100'''''
 
|-
 
|-
| valign="top" | {{Option|--shapefile.guess-projection {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--visum.connectors-lane-number {{DT_INT}}}}
| valign="top" | Guess the proper projection; ''default: false''
+
| style="vertical-align:top" | Sets connector lane number; ''default: '''3'''''
 
|-
 
|-
| valign="top" | {{Option|--vissim.join-distance {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--visum.no-connectors {{DT_BOOL}}}}
| valign="top" | Structure join offset [m]; ''default: 5''
+
| style="vertical-align:top" | Excludes connectors; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--visum.recompute-lane-number {{DT_BOOL}}}}
| valign="top" | Use FLOAT as default speed; ''default: 50''
+
| style="vertical-align:top" | Computes the number of lanes from the edges' capacities; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--vissim.speed-norm {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--visum.verbose-warnings {{DT_BOOL}}}}
| valign="top" | Factor for edge velocity; ''default: 1''
+
| style="vertical-align:top" | Prints all warnings, some of which are due to VISUM misbehaviour; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--vissim.report-unset-speeds {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--osm.skip-duplicates-check {{DT_BOOL}}}}
| valign="top" | Writes lanes without an explicit speed set; ''default: false''
+
| style="vertical-align:top" | Skips the check for duplicate nodes and edges; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-priority {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--osm.railway.oneway-default {{DT_BOOL}}}}
| valign="top" | Uses priorities from types; ''default: false''
+
| style="vertical-align:top" | Imports railway edges as one-way by default; ''default: '''true'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-laneno {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--opendrive.import-all-lanes {{DT_BOOL}}}}
| valign="top" | Uses lane numbers from types; ''default: false''
+
| style="vertical-align:top" | Imports all lane types; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.use-type-speed {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--opendrive.import-widths {{DT_BOOL}}}}
| valign="top" | Uses speeds from types; ''default: false''
+
| style="vertical-align:top" | Whether lane widths shall be imported; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.connector-speeds {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--no-internal-links {{DT_BOOL}}}}
| valign="top" | Sets connector speed; ''default: 100''
+
| style="vertical-align:top" | Omits internal links; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.connectors-lane-number {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--dismiss-vclasses {{DT_BOOL}}}}
| valign="top" | Sets connector lane number; ''default: 3''
+
| style="vertical-align:top" | Removes vehicle class restrictions from imported edges; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.no-connectors {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-turnarounds {{DT_BOOL}}}}
| valign="top" | Excludes connectors; ''default: false''
+
| style="vertical-align:top" | Disables building turnarounds; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.recompute-lane-number {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-turnarounds.tls {{DT_BOOL}}}}
| valign="top" | Computes the number of lanes from the edges' capacities; ''default: false''
+
| style="vertical-align:top" | Disables building turnarounds at tls-controlled junctions; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--visum.verbose-warnings {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--no-left-connections {{DT_BOOL}}}}
| valign="top" | Prints all warnings, some of which are due to VISUM misbehaviour; ''default: false''
+
| style="vertical-align:top" | Disables building connections to left; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--osm.skip-duplicates-check {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.split {{DT_BOOL}}}}
| valign="top" | Skips the check for duplicate nodes and edges.; ''default: false''
+
| style="vertical-align:top" | Splits edges across geometry nodes; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--no-internal-links {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-R {{DT_BOOL}}}}<br/> {{Option|--geometry.remove {{DT_BOOL}}}}
| valign="top" | Omits internal links; ''default: false''
+
| style="vertical-align:top" | Replace nodes which only define edge geometry by geometry points (joins edges); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--dismiss-vclasses {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.max-segment-length {{DT_FLOAT}}}}
| valign="top" | Removes vehicle class restrictions from imported edges; ''default: false''
+
| style="vertical-align:top" | splits geometry to restrict segment length; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--no-turnarounds {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.min-dist {{DT_FLOAT}}}}
| valign="top" | Disables building turnarounds; ''default: false''
+
| style="vertical-align:top" | reduces too similar geometry points
 
|-
 
|-
| valign="top" | {{Option|--no-turnarounds.tls {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.max-angle {{DT_FLOAT}}}}
| valign="top" | Disables building turnarounds at tls-controlled junctions; ''default: false''
+
| style="vertical-align:top" | Warn about edge geometries with an angle above DEGREES in successive segments; ''default: '''99'''''
 
|-
 
|-
| valign="top" | {{Option|--no-left-connections {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.min-radius {{DT_FLOAT}}}}
| valign="top" | Disables building connections to left; ''default: false''
+
| style="vertical-align:top" | Warn about edge geometries with a turning radius less than METERS at the start or end; ''default: '''9'''''
 
|-
 
|-
| valign="top" | {{Option|--geometry.split {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--geometry.min-radius.fix {{DT_BOOL}}}}
| valign="top" | Splits edges across geometry nodes; ''default: false''
+
| style="vertical-align:top" | Straighten edge geometries to avoid turning radii less than geometry.min-radius; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-R {{DT_BOOL}}}}<br/> {{Option|--geometry.remove {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--offset.disable-normalization {{DT_BOOL}}}}
| valign="top" | Replace nodes which only define edge geometry by geometry points (joins edges); ''default: false''
+
| style="vertical-align:top" | Turn off normalizing node positions; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--geometry.max-segment-length {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--offset.x {{DT_FLOAT}}}}
| valign="top" | splits geometry to restrict segment length; ''default: 0''
+
| style="vertical-align:top" | Adds FLOAT to net x-positions; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--offset.disable-normalization {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--offset.y {{DT_FLOAT}}}}
| valign="top" | Turn off normalizing node positions; ''default: false''
+
| style="vertical-align:top" | Adds FLOAT to net y-positions; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--offset.x {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--flip-y-axis {{DT_BOOL}}}}
| valign="top" | Adds FLOAT to net x-positions; ''default: 0''
+
| style="vertical-align:top" | Flips the y-coordinate along zero; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--offset.y {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--roundabouts.guess {{DT_BOOL}}}}
| valign="top" | Adds FLOAT to net y-positions; ''default: 0''
+
| style="vertical-align:top" | Enable roundabout-guessing; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--flip-y-axis {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--lefthand {{DT_BOOL}}}}
| valign="top" | Flips the y-coordinate along zero; ''default: false''
+
| style="vertical-align:top" | Assumes left-hand traffic on the network; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--roundabouts.guess {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--junctions.join {{DT_BOOL}}}}
| valign="top" | Enable roundabout-guessing; ''default: false''
+
| style="vertical-align:top" | Joins junctions that are close to each other (recommended for OSM import); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--lefthand {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--junctions.join-dist {{DT_FLOAT}}}}
| valign="top" | Assumes left-hand traffic on the network; ''default: false''
+
| style="vertical-align:top" | Determines the maximal distance for joining junctions (defaults to 10); ''default: '''10'''''
 
|-
 
|-
| valign="top" | {{Option|--junctions.join {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--junctions.join-exclude {{DT_STR}}}}
| valign="top" | Joins junctions that are close to each other (recommended for OSM import); ''default: false''
+
| style="vertical-align:top" | Interprets STR as list of junctions to exclude from joining
 
|-
 
|-
| valign="top" | {{Option|--junctions.join-dist {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--speed.offset {{DT_FLOAT}}}}
| valign="top" | Determines the maximal distance for joining junctions (defaults to 10); ''default: 10''
+
| style="vertical-align:top" | Modifies all edge speeds by adding FLOAT; ''default: '''0'''''
 
|-
 
|-
| valign="top" | {{Option|--junctions.join-exclude {{DT_STR}}}}
+
| style="vertical-align:top" | {{Option|--speed.factor {{DT_FLOAT}}}}
| valign="top" | Interprets STR as list of junctions to exclude from joining
+
| style="vertical-align:top" | Modifies all edge speeds by multiplying FLOAT; ''default: '''1'''''
 
|-
 
|-
| valign="top" | {{Option|--speed.offset {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--check-lane-foes.roundabout {{DT_BOOL}}}}
| valign="top" | Modifies all edge speeds by adding FLOAT; ''default: 0''
+
| style="vertical-align:top" | Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts); ''default: '''true'''''
 
|-
 
|-
| valign="top" | {{Option|--speed.factor {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--check-lane-foes.all {{DT_BOOL}}}}
| valign="top" | Modifies all edge speeds by multiplying FLOAT; ''default: 1''
+
| style="vertical-align:top" | Allow driving onto a multi-lane road if there are foes on other lanes (everywhere); ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--tls.join-dist {{DT_FLOAT}}}}
+
| style="vertical-align:top" | {{Option|--tls.join-dist {{DT_FLOAT}}}}
| valign="top" | Determines the maximal distance for joining traffic lights (defaults to 20); ''default: 20''
+
| style="vertical-align:top" | Determines the maximal distance for joining traffic lights (defaults to 20); ''default: '''20'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Building Defaults===
 
===Building Defaults===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-L {{DT_INT}}}}<br/> {{Option|--default.lanenumber {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|-L {{DT_INT}}}}<br/> {{Option|--default.lanenumber {{DT_INT}}}}
| valign="top" | The default number of lanes in an edge; ''default: 1''
+
| style="vertical-align:top" | The default number of lanes in an edge; ''default: '''1'''''
 
|-
 
|-
| valign="top" | {{Option|-S {{DT_FLOAT}}}}<br/> {{Option|--default.speed {{DT_FLOAT}}}}
+
| style="vertical-align: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''
+
| style="vertical-align:top" | The default speed on an edge (in m/s); ''default: '''13.9'''''
 
|-
 
|-
| valign="top" | {{Option|-P {{DT_INT}}}}<br/> {{Option|--default.priority {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|-P {{DT_INT}}}}<br/> {{Option|--default.priority {{DT_INT}}}}
| valign="top" | The default priority of an edge; ''default: -1''
+
| style="vertical-align:top" | The default priority of an edge; ''default: '''-1'''''
 
|-
 
|-
 
|}
 
|}
  
 
===Report===
 
===Report===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|-v {{DT_BOOL}}}}<br/> {{Option|--verbose {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-v {{DT_BOOL}}}}<br/> {{Option|--verbose {{DT_BOOL}}}}
| valign="top" | Switches to verbose output; ''default: false''
+
| style="vertical-align:top" | Switches to verbose output; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-p {{DT_BOOL}}}}<br/> {{Option|--print-options {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-p {{DT_BOOL}}}}<br/> {{Option|--print-options {{DT_BOOL}}}}
| valign="top" | Prints option values before processing; ''default: false''
+
| style="vertical-align:top" | Prints option values before processing; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-? {{DT_BOOL}}}}<br/> {{Option|--help {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-? {{DT_BOOL}}}}<br/> {{Option|--help {{DT_BOOL}}}}
| valign="top" | Prints this screen; ''default: false''
+
| style="vertical-align:top" | Prints this screen; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-V {{DT_BOOL}}}}<br/> {{Option|--version {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-V {{DT_BOOL}}}}<br/> {{Option|--version {{DT_BOOL}}}}
| valign="top" | Prints the current version; ''default: false''
+
| style="vertical-align:top" | Prints the current version; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-X {{DT_BOOL}}}}<br/> {{Option|--xml-validation {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-X {{DT_BOOL}}}}<br/> {{Option|--xml-validation {{DT_BOOL}}}}
| valign="top" | Enable schema validation of XML inputs; ''default: false''
+
| style="vertical-align:top" | Enable schema validation of XML inputs; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-W {{DT_BOOL}}}}<br/> {{Option|--no-warnings {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|-W {{DT_BOOL}}}}<br/> {{Option|--no-warnings {{DT_BOOL}}}}
| valign="top" | Disables output of warnings; ''default: false''
+
| style="vertical-align:top" | Disables output of warnings; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/> {{Option|--log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|-l {{DT_FILE}}}}<br/> {{Option|--log {{DT_FILE}}}}
| valign="top" | Writes all messages to FILE (implies verbose)
+
| style="vertical-align:top" | Writes all messages to FILE (implies verbose)
 
|-
 
|-
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--message-log {{DT_FILE}}}}
| valign="top" | Writes all non-error messages to FILE (implies verbose)
+
| style="vertical-align:top" | Writes all non-error messages to FILE (implies verbose)
 
|-
 
|-
| valign="top" | {{Option|--error-log {{DT_FILE}}}}
+
| style="vertical-align:top" | {{Option|--error-log {{DT_FILE}}}}
| valign="top" | Writes all warnings and errors to FILE
+
| style="vertical-align:top" | Writes all warnings and errors to FILE
 
|-
 
|-
 
|}
 
|}
  
 
===Random Number===
 
===Random Number===
{| cellspacing="0" border="1" width="90%" align="center"
+
{| class="wikitable" style="width:90%"
 
|-
 
|-
! style="background:#ddffdd;" valign="top" | Option
+
! style="background:#ddffdd; vertical-align:top; width:350px" | Option
! style="background:#ddffdd;" valign="top" | Description
+
! style="background:#ddffdd; vertical-align:top" | Description
 
|-
 
|-
| valign="top" | {{Option|--random {{DT_BOOL}}}}
+
| style="vertical-align:top" | {{Option|--random {{DT_BOOL}}}}
| valign="top" | Initialises the random number generator with the current system time; ''default: false''
+
| style="vertical-align:top" | Initialises the random number generator with the current system time; ''default: '''false'''''
 
|-
 
|-
| valign="top" | {{Option|--seed {{DT_INT}}}}
+
| style="vertical-align:top" | {{Option|--seed {{DT_INT}}}}
| valign="top" | Initialises the random number generator with the given value; ''default: 23423''
+
| style="vertical-align:top" | Initialises the random number generator with the given value; ''default: '''23423'''''
 
|-
 
|-
 
|}
 
|}

Revision as of 11:26, 25 September 2013

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 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> Adds comments to saved template, configuration, or schema; default: false

Input

Option 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 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> Street names will be included in the output (if available); default: false
--output.original-names <BOOL> Writes original names, if given, as parameter; default: false
--street-sign-output <FILE> Writes street signs as POIs to FILE

Projection

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

Tls Building

Option Description
--tls.discard-loaded <BOOL> Does not instatiate traffic lights loaded from other formats than XML; default: false
--tls.discard-simple <BOOL> Does not instatiate traffic lights at geometry-like nodes loaded from other formats than XML; default: false
--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> Turns on TLS guessing; default: false
--tls.taz-nodes <BOOL> Sets district nodes as tls-controlled; default: false
--tls-guess.joining <BOOL> Includes node clusters into guess; default: false
--tls.join <BOOL> Tries to cluster tls-controlled nodes; default: false
--tls.green.time <INT> Use INT as green phase duration; default: 31
-D <FLOAT>
--tls.yellow.min-decel <FLOAT>
Defines smallest vehicle deceleration; default: 3
--tls.yellow.patch-small <BOOL> Given yellow times are patched even if being too short; default: false
--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
--tls.default-type <STRING> TLSs with unspecified type will use STR as their algorithm; default: static

Ramp Guessing

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

Edge Removal

Option 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> Remove edges after joining; default: false
--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.in-geo-boundary <STRING> Only keep edges which are located within the given boundary (given either as GEODETIC corner coordinates <lon-min,lat-min,lon-max,lat-max> or as polygon <lon0,lat0,lon1,lat1,...>)
--keep-edges.by-vclass <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> Removes isolated edges; default: false

Unregulated Nodes

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

Processing

Option Description
--ignore-errors <BOOL> Continue on broken input; default: false
--ignore-errors.connections <BOOL> Continue on invalid connections; default: false
--show-errors.connections-first-try <BOOL> Show errors in connections at parsing; default: false
--ignore-errors.edge-type <BOOL> Continue on unknown edge types; default: false
--lanes-from-capacity.norm <FLOAT> The factor for flow to no. lanes conversion; default: 1800
--speed-in-kmh <BOOL> vmax is parsed as given in km/h (some); default: false
--plain.extend-edge-shape <BOOL> If edge shapes do not end at the node positions, extend them; default: false
--matsim.keep-length <BOOL> The edge lengths given in the MATSIM-file will be kept; default: false
--matsim.lanes-from-capacity <BOOL> The lane number will be computed from the capacity; default: false
--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> Uses edge type defaults on problems; default: false
--shapefile.all-bidirectional <BOOL> Insert edges in both directions; default: false
--shapefile.guess-projection <BOOL> Guess the proper projection; default: false
--vissim.join-distance <FLOAT> Structure join offset; default: 5
--vissim.default-speed <FLOAT> Use FLOAT as default speed; default: 50
--vissim.speed-norm <FLOAT> Factor for edge velocity; default: 1
--vissim.report-unset-speeds <BOOL> Writes lanes without an explicit speed set; default: false
--visum.use-type-priority <BOOL> Uses priorities from types; default: false
--visum.use-type-laneno <BOOL> Uses lane numbers from types; default: false
--visum.use-type-speed <BOOL> Uses speeds from types; default: false
--visum.connector-speeds <FLOAT> Sets connector speed; default: 100
--visum.connectors-lane-number <INT> Sets connector lane number; default: 3
--visum.no-connectors <BOOL> Excludes connectors; default: false
--visum.recompute-lane-number <BOOL> Computes the number of lanes from the edges' capacities; default: false
--visum.verbose-warnings <BOOL> Prints all warnings, some of which are due to VISUM misbehaviour; default: false
--osm.skip-duplicates-check <BOOL> Skips the check for duplicate nodes and edges; default: false
--osm.railway.oneway-default <BOOL> Imports railway edges as one-way by default; default: true
--opendrive.import-all-lanes <BOOL> Imports all lane types; default: false
--opendrive.import-widths <BOOL> Whether lane widths shall be imported; default: false
--no-internal-links <BOOL> Omits internal links; default: false
--dismiss-vclasses <BOOL> Removes vehicle class restrictions from imported edges; default: false
--no-turnarounds <BOOL> Disables building turnarounds; default: false
--no-turnarounds.tls <BOOL> Disables building turnarounds at tls-controlled junctions; default: false
--no-left-connections <BOOL> Disables building connections to left; default: false
--geometry.split <BOOL> Splits edges across geometry nodes; default: false
-R <BOOL>
--geometry.remove <BOOL>
Replace nodes which only define edge geometry by geometry points (joins edges); default: false
--geometry.max-segment-length <FLOAT> splits geometry to restrict segment length; default: 0
--geometry.min-dist <FLOAT> reduces too similar geometry points
--geometry.max-angle <FLOAT> Warn about edge geometries with an angle above DEGREES in successive segments; default: 99
--geometry.min-radius <FLOAT> Warn about edge geometries with a turning radius less than METERS at the start or end; default: 9
--geometry.min-radius.fix <BOOL> Straighten edge geometries to avoid turning radii less than geometry.min-radius; default: false
--offset.disable-normalization <BOOL> Turn off normalizing node positions; default: false
--offset.x <FLOAT> Adds FLOAT to net x-positions; default: 0
--offset.y <FLOAT> Adds FLOAT to net y-positions; default: 0
--flip-y-axis <BOOL> Flips the y-coordinate along zero; default: false
--roundabouts.guess <BOOL> Enable roundabout-guessing; default: false
--lefthand <BOOL> Assumes left-hand traffic on the network; default: false
--junctions.join <BOOL> Joins junctions that are close to each other (recommended for OSM import); default: false
--junctions.join-dist <FLOAT> Determines the maximal distance for joining junctions (defaults to 10); default: 10
--junctions.join-exclude <STRING> Interprets STR as list of junctions to exclude from joining
--speed.offset <FLOAT> Modifies all edge speeds by adding FLOAT; default: 0
--speed.factor <FLOAT> Modifies all edge speeds by multiplying FLOAT; default: 1
--check-lane-foes.roundabout <BOOL> Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts); default: true
--check-lane-foes.all <BOOL> Allow driving onto a multi-lane road if there are foes on other lanes (everywhere); default: false
--tls.join-dist <FLOAT> Determines the maximal distance for joining traffic lights (defaults to 20); default: 20

Building Defaults

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

Report

Option Description
-v <BOOL>
--verbose <BOOL>
Switches to verbose output; default: false
-p <BOOL>
--print-options <BOOL>
Prints option values before processing; default: false
-? <BOOL>
--help <BOOL>
Prints this screen; default: false
-V <BOOL>
--version <BOOL>
Prints the current version; default: false
-X <BOOL>
--xml-validation <BOOL>
Enable schema validation of XML inputs; default: false
-W <BOOL>
--no-warnings <BOOL>
Disables output of warnings; default: false
-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 Description
--random <BOOL> Initialises the random number generator with the current system time; default: false
--seed <INT> Initialises the random number generator with the given value; default: 23423