NAME¶

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

SYNOPSIS¶

netconvert [ OPTION]*

DESCRIPTION¶

SUMO netconvert Version 0.21.0

Copyright (C) 2001-2014 DLR and contributors; http://sumo-sim.org

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

EXAMPLES¶

netconvert -c <CONFIGURATION>

generate net with options read from file

netconvert -n ./nodes.xml -e ./edges.xml -v -t ./owntypes.xml

generate net with given nodes, edges, and edge types doing verbose output

REPORTING BUGS¶

Report bugs at <http://sumo-sim.org/trac/>. Get in contact via <sumo-user@lists.sourceforge.net>.

 

Copyright (C) 2001-2014 DLR and contributors; http://sumo-sim.org

SUMO netconvert Version 0.21.0 is part of SUMO. SUMO is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/gpl.html