Difference between revisions of "NETCONVERT"

From Sumo
Jump to navigation Jump to search
(Processing)
Line 37: Line 37:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}
| valign="top" | false
+
| valign="top" | Adds comments to saved template, configuration, or schema; ''default: '''false'''''
| valign="top" | Adds comments to saved template, configuration, or schema
 
 
|-
 
|-
 
|}
 
|}
Line 66: Line 60:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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" |
 
 
| valign="top" | Read [[Networks/SUMO_Road_Networks|SUMO network]] from FILE
 
| valign="top" | Read [[Networks/SUMO_Road_Networks|SUMO network]] 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" |
 
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Node_Descriptions|XML node definitions]] from FILE
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Node_Descriptions|XML node definitions]] 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" |
 
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Edge_Descriptions|XML edge definitions]] from FILE
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Edge_Descriptions|XML edge definitions]] 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" |
 
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Connection_Descriptions|XML connection definitions]] from FILE
 
| valign="top" | Read [[Networks/Building_Networks_from_own_XML-descriptions#Connection_Descriptions|XML connection definitions]] from FILE
 
|-
 
|-
 
| valign="top" | {{Option|-t {{DT_FILE}}}}<br/>{{Option|--type-files {{DT_FILE}}}}
 
| valign="top" | {{Option|-t {{DT_FILE}}}}<br/>{{Option|--type-files {{DT_FILE}}}}
| valign="top" |
 
 
| valign="top" | Read [[SUMO edge type file|XML type definitions]] from FILE
 
| valign="top" | Read [[SUMO edge type file|XML type definitions]] 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" |
 
 
| valign="top" | Read [[OpenStreetMap_file|OpenStreetMap network]] from path 'FILE(s)'
 
| valign="top" | Read [[OpenStreetMap_file|OpenStreetMap 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" |
 
 
| valign="top" | Read MATSim-net from FILE
 
| valign="top" | Read MATSim-net from FILE
 
|-
 
|-
Line 127: Line 107:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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|-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" |
 
 
| valign="top" | The generated net will be written to FILE using MATSIM format.
 
| valign="top" | The generated net will be written to FILE using MATSIM format.
 
|-
 
|-
 
| valign="top" | {{Option|--output.street-names}}
 
| valign="top" | {{Option|--output.street-names}}
| valign="top" | false
+
| valign="top" | Street names will be included in the output (if available); ''default: '''false'''''
| valign="top" | Street names will be included in the output (if available).
 
 
|-
 
|-
 
|}
 
|}
Line 157: Line 131:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}
| valign="top" | false
+
| valign="top" | Uses a simple method for projection; ''default: '''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" | 0
+
| valign="top" | Number of places to shift decimal point to right in geo-coordinates; ''default: '''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}}
| valign="top" | false
+
| valign="top" | Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid); ''default: '''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}}
| valign="top" | false
+
| valign="top" | Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid); ''default: '''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" | !
+
| valign="top" | Uses STR as proj.4 definition for projection; ''default: '''!'''''
| valign="top" | Uses STR as proj.4 definition for projection
 
 
|-
 
|-
 
| valign="top" | {{Option|--proj.inverse}}
 
| valign="top" | {{Option|--proj.inverse}}
| valign="top" | false
+
| valign="top" | Inverses projection; ''default: '''false'''''
| valign="top" | Inverses projection
 
 
|-
 
|-
 
|}
 
|}
Line 193: Line 160:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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.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}}
| valign="top" | false
+
| valign="top" | Turns on TLS guessing; ''default: '''false'''''
| valign="top" | Turns on TLS guessing
 
 
|-
 
|-
 
| valign="top" | {{Option|--tls.taz-nodes}}
 
| valign="top" | {{Option|--tls.taz-nodes}}
| valign="top" | false
+
| valign="top" | Sets district nodes as tls-controlled; ''default: '''false'''''
| valign="top" | Sets district nodes as tls-controlled
 
 
|-
 
|-
 
| valign="top" | {{Option|--tls-guess.joining}}
 
| valign="top" | {{Option|--tls-guess.joining}}
| valign="top" | false
+
| valign="top" | Includes node clusters into guess; ''default: '''false'''''
| valign="top" | Includes node clusters into guess
 
 
|-
 
|-
 
| valign="top" | {{Option|--tls.join}}
 
| valign="top" | {{Option|--tls.join}}
| valign="top" | false
+
| valign="top" | Tries to cluster tls-controlled nodes; ''default: '''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" | 31
+
| valign="top" | Use INT as green phase duration; ''default: '''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" | 3
+
| valign="top" | Defines smallest vehicle deceleration; ''default: '''3'''''
| valign="top" | Defines smallest vehicle deceleration
 
 
|-
 
|-
 
| valign="top" | {{Option|--tls.yellow.patch-small}}
 
| valign="top" | {{Option|--tls.yellow.patch-small}}
| valign="top" | false
+
| valign="top" | Given yellow times are patched even if being too short; ''default: '''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 250: Line 204:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}
| valign="top" | false
+
| valign="top" | Enable ramp-guessing; ''default: '''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" | -1
+
| valign="top" | Treat edges with speed > FLOAT as no ramps; ''default: '''-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" | 21.9444
+
| valign="top" | Treat edges with speed < FLOAT as no highways; ''default: '''21.94'''''
| 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" | 100
+
| valign="top" | Use FLOAT as ramp-length; ''default: '''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
 
|-
 
|-
Line 279: Line 227:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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" |
 
 
| valign="top" | Remove edges with speed < FLOAT
 
| valign="top" | Remove edges with speed < 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" |
 
 
| valign="top" | Remove edges not in STR
 
| valign="top" | Remove edges not in STR
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
 
| valign="top" | {{Option|--keep-edges.input-file {{DT_FILE}}}}
| valign="top" |
 
 
| valign="top" | Removed edges not in FILE
 
| valign="top" | Removed edges not in FILE
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.postload}}
 
| valign="top" | {{Option|--keep-edges.postload}}
| valign="top" | false
+
| valign="top" | Remove edges after joining; ''default: '''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" |
 
 
| valign="top" | Keeps edges which are located within the given boundary
 
| valign="top" | Keeps edges which are located within the given boundary
 
|-
 
|-
 
| valign="top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
 
| valign="top" | {{Option|--keep-edges.by-vclass {{DT_STR}}}}
| valign="top" |
 
 
| valign="top" | Keep edges that allow any of the vclasss in STR
 
| valign="top" | Keep edges that allow any 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" |
 
 
| valign="top" | Remove edges where vclass def is not in STR
 
| valign="top" | Remove edges where vclass def is not in STR
 
|-
 
|-
 
| valign="top" | {{Option|--remove-edges.isolated}}
 
| valign="top" | {{Option|--remove-edges.isolated}}
| valign="top" | false
+
| valign="top" | Removes isolated edges; ''default: '''false'''''
| valign="top" | Removes isolated edges
 
 
|-
 
|-
 
|}
 
|}
Line 328: Line 266:
 
|-
 
|-
 
| valign="top" | {{Option|--keep-nodes-unregulated}}
 
| valign="top" | {{Option|--keep-nodes-unregulated}}
| valign="top" | false
+
| valign="top" | All nodes will be not regulated; ''default: '''false'''''
| valign="top" | All nodes will be not regulated
 
 
|-
 
|-
 
| 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}}
| valign="top" | false
+
| valign="top" | Do not regulate district nodes; ''default: '''false'''''
| valign="top" | Do not regulate district nodes
 
 
|-
 
|-
 
|}
 
|}
Line 347: Line 282:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}
| valign="top" | false
+
| valign="top" | Continue on broken input; ''default: '''false'''''
| valign="top" | Continue on broken input
 
 
|-
 
|-
 
| valign="top" | {{Option|--ignore-errors.connections}}
 
| valign="top" | {{Option|--ignore-errors.connections}}
| valign="top" | false
+
| valign="top" | Continue on invalid connections; ''default: '''false'''''
| valign="top" | Continue on invalid connections
 
 
|-
 
|-
 
| valign="top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--lanes-from-capacity.norm {{DT_FLOAT}}}}
| valign="top" | 1800
+
| valign="top" | The factor for flow to no. lanes conversion; ''default: '''1800'''''
| valign="top" | The factor for flow to no. lanes conversion.
 
 
|-
 
|-
 
| valign="top" | {{Option|--speed-in-kmh}}
 
| valign="top" | {{Option|--speed-in-kmh}}
| valign="top" | false
+
| valign="top" | vmax is parsed as given in km/h (some); ''default: '''false'''''
| valign="top" | vmax is parsed as given in km/h (some)
 
 
|-
 
|-
 
| valign="top" | {{Option|--plain.keep-edge-shape}}
 
| valign="top" | {{Option|--plain.keep-edge-shape}}
| valign="top" | false
+
| valign="top" | No node positions are added to the edge shape; ''default: '''false'''''
| valign="top" | No node positions are added to the edge shape
 
 
|-
 
|-
 
| valign="top" | {{Option|--matsim.keep-length}}
 
| valign="top" | {{Option|--matsim.keep-length}}
| valign="top" | false
+
| valign="top" | The edge lengths given in the MATSIM-file will be kept; ''default: '''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}}
| valign="top" | false
+
| valign="top" | The lane number will be computed from the capacity; ''default: '''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}}
| valign="top" | false
+
| valign="top" | Uses edge type defaults on problems; ''default: '''false'''''
| valign="top" | Uses edge type defaults on problems
 
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.all-bidirectional}}
 
| valign="top" | {{Option|--shapefile.all-bidirectional}}
| valign="top" | false
+
| valign="top" | Insert edges in both directions; ''default: '''false'''''
| valign="top" | Insert edges in both directions
 
 
|-
 
|-
 
| valign="top" | {{Option|--shapefile.guess-projection}}
 
| valign="top" | {{Option|--shapefile.guess-projection}}
| valign="top" | false
+
| valign="top" | Guess the proper projection; ''default: '''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" | 5
+
| valign="top" | Structure join offset; ''default: '''5'''''
| valign="top" | Structure join offset
 
 
|-
 
|-
 
| valign="top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--vissim.default-speed {{DT_FLOAT}}}}
| valign="top" | 50
+
| valign="top" | Use FLOAT as default speed; ''default: '''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" | 1
+
| valign="top" | Factor for edge velocity; ''default: '''1'''''
| valign="top" | Factor for edge velocity
 
 
|-
 
|-
 
| valign="top" | {{Option|--vissim.report-unset-speeds}}
 
| valign="top" | {{Option|--vissim.report-unset-speeds}}
| valign="top" | false
+
| valign="top" | Writes lanes without an explicit speed set; ''default: '''false'''''
| valign="top" | Writes lanes without an explicit speed set.
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.use-type-priority}}
 
| valign="top" | {{Option|--visum.use-type-priority}}
| valign="top" | false
+
| valign="top" | Uses priorities from types; ''default: '''false'''''
| valign="top" | Uses priorities from types
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.use-type-laneno}}
 
| valign="top" | {{Option|--visum.use-type-laneno}}
| valign="top" | false
+
| valign="top" | Uses lane numbers from types; ''default: '''false'''''
| valign="top" | Uses lane numbers from types
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.use-type-speed}}
 
| valign="top" | {{Option|--visum.use-type-speed}}
| valign="top" | false
+
| valign="top" | Uses speeds from types; ''default: '''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" | 100
+
| valign="top" | Sets connector speed; ''default: '''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" | 3
+
| valign="top" | Sets connector lane number; ''default: '''3'''''
| valign="top" | Sets connector lane number
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.no-connectors}}
 
| valign="top" | {{Option|--visum.no-connectors}}
| valign="top" | false
+
| valign="top" | Excludes connectors; ''default: '''false'''''
| valign="top" | Excludes connectors
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.recompute-lane-number}}
 
| valign="top" | {{Option|--visum.recompute-lane-number}}
| valign="top" | false
+
| valign="top" | Computes the number of lanes from the edges' capacities; ''default: '''false'''''
| valign="top" | Computes the number of lanes from the edges' capacities
 
 
|-
 
|-
 
| valign="top" | {{Option|--visum.verbose-warnings}}
 
| valign="top" | {{Option|--visum.verbose-warnings}}
| valign="top" | false
+
| valign="top" | Prints all warnings, some of which are due to VISUM misbehaviour; ''default: '''false'''''
| valign="top" | Prints all warnings, some of which are due to VISUM misbehaviour
 
 
|-
 
|-
 
| valign="top" | {{Option|--osm.skip-duplicates-check}}
 
| valign="top" | {{Option|--osm.skip-duplicates-check}}
| valign="top" | false
+
| valign="top" | Skips the check for duplicate nodes and edges; ''default: '''false'''''
| valign="top" | Skips the check for duplicate nodes and edges.
 
 
|-
 
|-
 
| valign="top" | {{Option|--osm.discard-tls}}
 
| valign="top" | {{Option|--osm.discard-tls}}
| valign="top" | false
+
| valign="top" | Discards all traffic lights from OSM file(s); ''default: '''false'''''
| valign="top" | Discards all traffic lights from OSM file(s).
 
 
|-
 
|-
 
| valign="top" | {{Option|--no-internal-links}}
 
| valign="top" | {{Option|--no-internal-links}}
| valign="top" | false
+
| valign="top" | Omits internal links; ''default: '''false'''''
| valign="top" | Omits internal links
 
 
|-
 
|-
 
| valign="top" | {{Option|--dismiss-vclasses}}
 
| valign="top" | {{Option|--dismiss-vclasses}}
| valign="top" | false
+
| valign="top" | Removes vehicle class restrictions from imported edges; ''default: '''false'''''
| valign="top" | Removes vehicle class restrictions from imported edges.
 
 
|-
 
|-
 
| valign="top" | {{Option|--no-turnarounds}}
 
| valign="top" | {{Option|--no-turnarounds}}
| valign="top" | false
+
| valign="top" | Disables building turnarounds; ''default: '''false'''''
| valign="top" | Disables building turnarounds
 
 
|-
 
|-
 
| valign="top" | {{Option|--no-turnarounds.tls}}
 
| valign="top" | {{Option|--no-turnarounds.tls}}
| valign="top" | false
+
| valign="top" | Disables building turnarounds at tls-controlled junctions; ''default: '''false'''''
| valign="top" | Disables building turnarounds at tls-controlled junctions
 
 
|-
 
|-
 
| valign="top" | {{Option|--no-left-connections}}
 
| valign="top" | {{Option|--no-left-connections}}
| valign="top" | false
+
| valign="top" | Disables building connections to left; ''default: '''false'''''
| valign="top" | Disables building connections to left
 
 
|-
 
|-
 
| valign="top" | {{Option|--geometry.split}}
 
| valign="top" | {{Option|--geometry.split}}
| valign="top" | false
+
| valign="top" | Splits edges across geometry nodes; ''default: '''false'''''
| valign="top" | Splits edges across geometry nodes
 
 
|-
 
|-
 
| valign="top" | {{Option|-R}}<br/>{{Option|--geometry.remove}}
 
| valign="top" | {{Option|-R}}<br/>{{Option|--geometry.remove}}
| valign="top" | false
+
| valign="top" | Removes geometry information from edges; ''default: '''false'''''
| valign="top" | Removes geometry information from edges
 
 
|-
 
|-
 
| valign="top" | {{Option|--offset.disable-normalization}}
 
| valign="top" | {{Option|--offset.disable-normalization}}
| valign="top" | false
+
| valign="top" | Turn off normalizing node positions; ''default: '''false'''''
| valign="top" | Turn off normalizing node positions
 
 
|-
 
|-
 
| valign="top" | {{Option|--offset.x {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--offset.x {{DT_FLOAT}}}}
| valign="top" | 0
+
| valign="top" | Adds FLOAT to net x-positions; ''default: '''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" | 0
+
| valign="top" | Adds FLOAT to net y-positions; ''default: '''0'''''
| valign="top" | Adds FLOAT to net y-positions
 
 
|-
 
|-
 
| valign="top" | {{Option|--flip-y-axis}}
 
| valign="top" | {{Option|--flip-y-axis}}
| valign="top" | false
+
| valign="top" | Flips the y-coordinate along zero; ''default: '''false'''''
| valign="top" | Flips the y-coordinate along zero
 
 
|-
 
|-
 
| valign="top" | {{Option|--roundabouts.guess}}
 
| valign="top" | {{Option|--roundabouts.guess}}
| valign="top" | false
+
| valign="top" | Enable roundabout-guessing; ''default: '''false'''''
| valign="top" | Enable roundabout-guessing
 
 
|-
 
|-
 
| valign="top" | {{Option|--lefthand}}
 
| valign="top" | {{Option|--lefthand}}
| valign="top" | false
+
| valign="top" | Assumes left-hand traffic on the network; ''default: '''false'''''
| valign="top" | Assumes left-hand traffic on the network
 
 
|-
 
|-
 
| valign="top" | {{Option|--junctions.join}}
 
| valign="top" | {{Option|--junctions.join}}
| valign="top" | false
+
| valign="top" | Joins junctions that are close to each other (recommended for OSM import); ''default: '''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" | 15
+
| valign="top" | Determines the maximal distance for joining junctions; ''default: '''15'''''
| valign="top" | Determines the maximal distance for joining junctions (defaults to 15)
 
 
|-
 
|-
 
| valign="top" | {{Option|--junctions.join-exclude {{DT_StringList}}}}
 
| valign="top" | {{Option|--junctions.join-exclude {{DT_StringList}}}}
| valign="top" |
 
 
| valign="top" | Interprets argument as a list of junctions to exclude from joining
 
| valign="top" | Interprets argument as a list of junctions to exclude from joining
 
|-
 
|-
 
| valign="top" | {{Option|--speed.offset {{DT_FLOAT}}}}
 
| valign="top" | {{Option|--speed.offset {{DT_FLOAT}}}}
| valign="top" |
 
 
| 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" |
 
 
| valign="top" | Modifies all edge speeds by multiplying FLOAT
 
| valign="top" | Modifies all edge speeds by multiplying FLOAT
 
|-
 
|-
Line 540: Line 428:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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" | 1
+
| valign="top" | The default number of lanes in an edge; ''default: '''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" | 13.9
+
| valign="top" | The default speed on an edge (in m/s); ''default: '''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" | -1
+
| valign="top" | The default priority of an edge; ''default: '''-1'''''
| valign="top" | The default priority of an edge
 
 
|-
 
|-
 
|}
 
|}
Line 561: Line 445:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}<br/>{{Option|--verbose}}
| valign="top" | false
+
| valign="top" | Switches to verbose output; ''default: '''false'''''
| valign="top" | Switches to verbose output
 
 
|-
 
|-
 
| valign="top" | {{Option|-p}}<br/>{{Option|--print-options}}
 
| valign="top" | {{Option|-p}}<br/>{{Option|--print-options}}
| valign="top" | false
+
| valign="top" | Prints option values before processing; ''default: '''false'''''
| valign="top" | Prints option values before processing
 
 
|-
 
|-
 
| valign="top" | {{Option|-?}}<br/>{{Option|--help}}
 
| valign="top" | {{Option|-?}}<br/>{{Option|--help}}
| valign="top" | true
+
| valign="top" | Prints this screen; ''default: '''false'''''
| valign="top" | Prints this screen
 
 
|-
 
|-
 
| valign="top" | {{Option|-V}}<br/>{{Option|--version}}
 
| valign="top" | {{Option|-V}}<br/>{{Option|--version}}
| valign="top" | false
+
| valign="top" | Prints the current version; ''default: '''false'''''
| valign="top" | Prints the current version
 
 
|-
 
|-
 
| valign="top" | {{Option|-W}}<br/>{{Option|--no-warnings}}
 
| valign="top" | {{Option|-W}}<br/>{{Option|--no-warnings}}
| valign="top" | false
+
| valign="top" | Disables output of warnings; ''default: '''false'''''
| valign="top" | Disables output of warnings
 
 
|-
 
|-
 
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/>{{Option|--log {{DT_FILE}}}}
 
| valign="top" | {{Option|-l {{DT_FILE}}}}<br/>{{Option|--log {{DT_FILE}}}}
| valign="top" |
 
 
| valign="top" | Writes all messages to FILE
 
| valign="top" | Writes all messages to FILE
 
|-
 
|-
 
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
 
| valign="top" | {{Option|--message-log {{DT_FILE}}}}
| valign="top" |
 
 
| valign="top" | Writes all non-error messages to FILE
 
| valign="top" | Writes all non-error messages to FILE
 
|-
 
|-
 
| 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 602: Line 477:
 
|-
 
|-
 
! style="background:#ddffdd;" valign="top" | 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}}
| valign="top" | false
+
| valign="top" | Initialises the random number generator with the current system time; ''default: '''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" | 23423
+
| valign="top" | Initialises the random number generator with the given value; ''default: '''23423'''''
| valign="top" | Initialises the random number generator with the given value
 
 
|-
 
|-
 
|}
 
|}

Revision as of 13:09, 2 March 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

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

Input

Option Description
-s <FILE>
--sumo-net-file <FILE>
Read SUMO network from FILE
-n <FILE>
--node-files <FILE>
Read XML node definitions from FILE
-e <FILE>
--edge-files <FILE>
Read XML edge definitions from FILE
-x <FILE>
--connection-files <FILE>
Read XML connection definitions from FILE
-t <FILE>
--type-files <FILE>
Read XML type definitions 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 OpenStreetMap 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

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
-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.
--output.street-names Street names will be included in the output (if available); default: false

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 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:

Option Description
--simple-projection 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 Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid); default: false
--proj.dhdn 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 Inverses projection; default: false

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 --proj. Sometimes also the EPSG number of a projection is known, which together with 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 UTM. In order to support this often used projection NETCONVERT provides another option --proj.utm which determines the correct UTM zone to use from the longitude of the first point in the network. --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 --proj.inverse. If you don't have proj available but desperately need a projection of some kind, you can try --proj.simple. This should be a last resort only, if you have proj, you should always prefer --proj.utm.

TLS Building

Option Description
--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 Turns on TLS guessing; default: false
--tls.taz-nodes Sets district nodes as tls-controlled; default: false
--tls-guess.joining Includes node clusters into guess; default: false
--tls.join 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 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

Ramp Guessing

Option Description
--ramps.guess 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.94
--ramps.ramp-length <FLOAT> Use FLOAT as ramp-length; default: 100
--ramps.set <STRING> Tries to handle the given edges as ramps

Edge Removal

Option Description
--keep-edges.min-speed <FLOAT> Remove edges with speed < FLOAT
--remove-edges.explicit <STRING> Remove edges in STR
--keep-edges.explicit <STRING> Remove edges not in STR
--keep-edges.input-file <FILE> Removed edges not in FILE
--keep-edges.postload Remove edges after joining; default: false
--keep-edges.in-boundary <STRING> Keeps edges which are located within the given boundary
--keep-edges.by-vclass <STRING> Keep edges that allow any of the vclasss in STR
--remove-edges.by-vclass <STRING> Remove edges where vclass def is not in STR
--remove-edges.isolated Removes isolated edges; default: false

Unregulated Nodes

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

Processing

Normally, both NETCONVERT and NETGEN 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).

Option Description
--ignore-errors Continue on broken input; default: false
--ignore-errors.connections Continue on invalid connections; default: false
--lanes-from-capacity.norm <FLOAT> The factor for flow to no. lanes conversion; default: 1800
--speed-in-kmh vmax is parsed as given in km/h (some); default: false
--plain.keep-edge-shape No node positions are added to the edge shape; default: false
--matsim.keep-length The edge lengths given in the MATSIM-file will be kept; default: false
--matsim.lanes-from-capacity 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 Uses edge type defaults on problems; default: false
--shapefile.all-bidirectional Insert edges in both directions; default: false
--shapefile.guess-projection 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 Writes lanes without an explicit speed set; default: false
--visum.use-type-priority Uses priorities from types; default: false
--visum.use-type-laneno Uses lane numbers from types; default: false
--visum.use-type-speed 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 Excludes connectors; default: false
--visum.recompute-lane-number Computes the number of lanes from the edges' capacities; default: false
--visum.verbose-warnings Prints all warnings, some of which are due to VISUM misbehaviour; default: false
--osm.skip-duplicates-check Skips the check for duplicate nodes and edges; default: false
--osm.discard-tls Discards all traffic lights from OSM file(s); default: false
--no-internal-links Omits internal links; default: false
--dismiss-vclasses Removes vehicle class restrictions from imported edges; default: false
--no-turnarounds Disables building turnarounds; default: false
--no-turnarounds.tls Disables building turnarounds at tls-controlled junctions; default: false
--no-left-connections Disables building connections to left; default: false
--geometry.split Splits edges across geometry nodes; default: false
-R
--geometry.remove
Removes geometry information from edges; default: false
--offset.disable-normalization 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 Flips the y-coordinate along zero; default: false
--roundabouts.guess Enable roundabout-guessing; default: false
--lefthand Assumes left-hand traffic on the network; default: false
--junctions.join 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; default: 15
--junctions.join-exclude <STRING>[,<STRING>]* Interprets argument as a list of junctions to exclude from joining
--speed.offset <FLOAT> Modifies all edge speeds by adding FLOAT
--speed.factor <FLOAT> Modifies all edge speeds by multiplying FLOAT

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
--verbose
Switches to verbose output; default: false
-p
--print-options
Prints option values before processing; default: false
-?
--help
Prints this screen; default: false
-V
--version
Prints the current version; default: false
-W
--no-warnings
Disables output of warnings; default: false
-l <FILE>
--log <FILE>
Writes all messages to FILE
--message-log <FILE> Writes all non-error messages to FILE
--error-log <FILE> Writes all warnings and errors to FILE

Random Number

Option Description
--random 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