NAME¶
SUMO - Road network importer / builder for the road traffic simulation SUMO
SYNOPSIS¶
netconvert [
OPTION]
*
DESCRIPTION¶
SUMO netconvert Version 0.15.0
- Copyright (C) 2001-2012 DLR and contributors;
http://sumo.sourceforge.net
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
- -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
- --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.
- --output.street-names
- Street names will be included in the output (if
available).
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)
- --proj STR
- Uses STR as proj.4 definition for projection
- --proj.inverse
- Inverses projection
- --proj.plain-geo
- Write geo coordinates in plain-xml
TLS Building Options:¶
- --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
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
Edge Removal Options:¶
- --keep-edges.min-speed FLOAT
- Only keep edges with speed > 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.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
- --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.keep-edge-shape
- No node positions are added to the edge shape
- --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.discard-tls
- Discards all traffic lights.
- --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
- --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 15)
- --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
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
Report Options:¶
- -v, --verbose
- Switches to verbose output
- -p, --print-options
- Prints option values before processing
- -?, --help
- Prints this screen
- -V, --version
- Prints the current version
- -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://sourceforge.net/apps/trac/sumo/>.
Get in contact via <sumo-user@lists.sourceforge.net>.
-
Copyright (C) 2001-2012 DLR and contributors;
http://sumo.sourceforge.net
SUMO netconvert Version 0.15.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
