SUMO(1) User Commands SUMO(1)
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
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
--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
SUMO netconvert Version 0.15.0 May 2012 SUMO(1)