netconvert: Road network importer / builder for the road traffic simulation sumo

DESCRIPTION

SUMO netconvert Version 0.21.0

Road network importer / builder for the road traffic simulation SUMO.

Configuration Options:

-c, --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

Input Options:

-s, --sumo-net-file FILE: Read SUMO-net from FILE
-n, --node-files FILE: Read XML-node defs from FILE
-e, --edge-files FILE: Read XML-edge defs from FILE
-x, --connection-files FILE: Read XML-connection defs from FILE
-i, --tllogic-files FILE: Read XML-traffic light defs from FILE
-t, --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 Options:

-o, --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, --map-output FILE: Writes joined edges information to FILE
--amitran-output FILE: The generated net will be written to FILE using Amitran format
--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: Street names will be included in the output (if available)
--output.original-names: Writes original names, if given, as parameter
--street-sign-output FILE: Writes street signs as POIs to FILE

Projection Options:

--simple-projection: Uses a simple method for projection
--proj.scale INT: Number of places to shift decimal point to right in geo-coordinates
--proj.utm: Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)
--proj.dhdn: Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid, "Gauss-Krueger")
--proj STR: Uses STR as proj.4 definition for projection
--proj.inverse: Inverses projection
--proj.dhdnutm: Convert from Gauss-Krueger to UTM
--proj.plain-geo: Write geo coordinates in plain-xml

TLS Building Options:

--tls.discard-loaded: Does not instatiate traffic lights loaded from other formats than XML
--tls.discard-simple: Does not instatiate traffic lights at geometry-like nodes loaded from other formats than XML
--tls.set STR: Interprets STR as list of junctions to be controlled by TLS
--tls.unset STR: Interprets STR as list of junctions to be not controlled by TLS
--tls.guess: Turns on TLS guessing
--tls.taz-nodes: Sets district nodes as tls-controlled
--tls-guess.joining: Includes node clusters into guess
--tls.join: Tries to cluster tls-controlled nodes
--tls.green.time INT: Use INT as green phase duration
-D, --tls.yellow.min-decel FLOAT: Defines smallest vehicle deceleration
--tls.yellow.patch-small: Given yellow times are patched even if being too short
--tls.yellow.time INT: Set INT as fixed time for yellow phase durations
--tls.half-offset STR: TLSs in STR will be shifted by half-phase
--tls.quarter-offset STR: TLSs in STR will be shifted by quarter-phase
--tls.default-type STR: TLSs with unspecified type will use STR as their algorithm

Ramp Guessing Options:

--ramps.guess: Enable ramp-guessing
--ramps.max-ramp-speed FLOAT: Treat edges with speed > FLOAT as no ramps
--ramps.min-highway-speed FLOAT: Treat edges with speed < FLOAT as no highways
--ramps.ramp-length FLOAT: Use FLOAT as ramp-length
--ramps.set STR: Tries to handle the given edges as ramps
--ramps.no-split: Avoids edge splitting

Edge Removal Options:

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

Unregulated Nodes Options:

--keep-nodes-unregulated: All nodes will be unregulated
--keep-nodes-unregulated.explicit STR: Do not regulate nodes in STR
--keep-nodes-unregulated.district-nodes: Do not regulate district nodes

Processing Options:

--ignore-errors: Continue on broken input
--ignore-errors.connections: Continue on invalid connections
--show-errors.connections-first-try: Show errors in connections at parsing
--ignore-errors.edge-type: Continue on unknown edge types
--lanes-from-capacity.norm FLOAT: The factor for flow to no. lanes conversion
--speed-in-kmh: vmax is parsed as given in km/h (some)
--plain.extend-edge-shape: If edge shapes do not end at the node positions, extend them
--matsim.keep-length: The edge lengths given in the MATSIM-file will be kept
--matsim.lanes-from-capacity: The lane number will be computed from the capacity
--shapefile.street-id STR: Read edge ids from column STR
--shapefile.from-id STR: Read from-node ids from column STR
--shapefile.to-id STR: Read to-node ids from column STR
--shapefile.type-id STR: Read type ids from column STR
--shapefile.use-defaults-on-failure: Uses edge type defaults on problems
--shapefile.all-bidirectional: Insert edges in both directions
--shapefile.guess-projection: Guess the proper projection
--vissim.join-distance FLOAT: Structure join offset
--vissim.default-speed FLOAT: Use FLOAT as default speed
--vissim.speed-norm FLOAT: Factor for edge velocity
--vissim.report-unset-speeds: Writes lanes without an explicit speed set
--visum.use-type-priority: Uses priorities from types
--visum.use-type-laneno: Uses lane numbers from types
--visum.use-type-speed: Uses speeds from types
--visum.connector-speeds FLOAT: Sets connector speed
--visum.connectors-lane-number INT: Sets connector lane number
--visum.no-connectors: Excludes connectors
--visum.recompute-lane-number: Computes the number of lanes from the edges' capacities
--visum.verbose-warnings: Prints all warnings, some of which are due to VISUM misbehaviour
--osm.skip-duplicates-check: Skips the check for duplicate nodes and edges
--osm.railway.oneway-default: Imports railway edges as one-way by default
--osm.elevation: Imports elevation data
--opendrive.import-all-lanes: Imports all lane types
--opendrive.ignore-widths: Whether lane widths shall be ignored.
--no-internal-links: Omits internal links
--dismiss-vclasses: Removes vehicle class restrictions from imported edges
--no-turnarounds: Disables building turnarounds
--no-turnarounds.tls: Disables building turnarounds at tls-controlled junctions
--no-left-connections: Disables building connections to left
--geometry.split: Splits edges across geometry nodes
-R, --geometry.remove: Replace nodes which only define edge geometry by geometry points (joins edges)
--geometry.max-segment-length FLOAT: splits geometry to restrict segment length
--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
--geometry.min-radius FLOAT: Warn about edge geometries with a turning radius less than METERS at the start or end
--geometry.min-radius.fix: Straighten edge geometries to avoid turning radii less than geometry.min-radius
--geometry.junction-mismatch-threshold FLOAT: Warn if the junction shape is to far away from the original node position
--offset.disable-normalization: Turn off normalizing node positions
--offset.x FLOAT: Adds FLOAT to net x-positions
--offset.y FLOAT: Adds FLOAT to net y-positions
--flip-y-axis: Flips the y-coordinate along zero
--roundabouts.guess: Enable roundabout-guessing
--lefthand: Assumes left-hand traffic on the network
--junctions.join: Joins junctions that are close to each other (recommended for OSM import)
--junctions.join-dist FLOAT: Determines the maximal distance for joining junctions (defaults to 10)
--junctions.join-exclude STR: Interprets STR as 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
--check-lane-foes.roundabout: Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)
--check-lane-foes.all: Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)
--sidewalks.guess: Guess pedestrian sidewalks based on edge speed
--sidewalks.guess.max-speed FLOAT: Add sidewalks for edges with a speed equal or below the given limit
--sidewalks.guess.min-speed FLOAT: Add sidewalks for edges with a speed above the given limit
--crossings.guess: Guess pedestrian crossings based on the presence of sidewalks
--tls.join-dist FLOAT: Determines the maximal distance for joining traffic lights (defaults to 20)
--tls.guess-signals: Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks
--tls.guess-signals.dist FLOAT: Distance for interpreting nodes as signal locations

Building Defaults Options:

-L, --default.lanenumber INT: The default number of lanes in an edge
-S, --default.speed FLOAT: The default speed on an edge (in m/s)
-P, --default.priority INT: The default priority of an edge
--default.sidewalk-width FLOAT: The default width of added sidewalks

Report Options:

-v, --verbose: Switches to verbose output
--print-options: Prints option values before processing
-?, --help: Prints this screen
-V, --version: Prints the current version
-X, --xml-validation STR: Set schema validation scheme of XML inputs ("never", "auto" or "always")
--xml-validation.net STR: Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
-W, --no-warnings: Disables output of warnings
-l, --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 Options:

--random: Initialises the random number generator with the current system time
--seed INT: Initialises the random number generator with the given value

netconvert (1)

SYNOPSIS

DESCRIPTION

Configuration Options:

Input Options:

Output Options:

Projection Options:

TLS Building Options:

Ramp Guessing Options:

Edge Removal Options:

Unregulated Nodes Options:

Processing Options:

Building Defaults Options:

Report Options:

Random Number Options:

EXAMPLES

REPORTING BUGS