SUMO(1) Road network generator for the microscopic road traffic simulation SUMO

SYNOPSIS

netgensumo [OPTION]*

DESCRIPTION

SUMO netgensumo Version 0.15.0
Copyright (C) 2001-2012 DLR and contributors; http://sumo.sourceforge.net

Road network generator for the microscopic road traffic simulation SUMO.

Either "--grid", "--spider" or "--rand" must be supplied.
In dependance to these switches other options are used.

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

Grid Network Options:

-g, --grid
Forces NETGENSUMO to build a grid-like network
--grid.number INT
The number of junctions in both dirs
--grid.length FLOAT
The length of streets in both dirs
--grid.x-number INT
The number of junctions in x-dir; Overrides --grid-number
--grid.y-number INT
The number of junctions in y-dir; Overrides --grid-number
--grid.x-length FLOAT
The length of horizontal streets; Overrides --grid-length
--grid.y-length FLOAT
The length of vertical streets; Overrides --grid-length
--grid.attach-length FLOAT
The length of streets attached at the boundary; 0 means no streets are attached

Spider Network Options:

-s, --spider
Forces NETGENSUMO to build a spider-net-like network
--spider.arm-number INT
The number of axes within the net
--spider.circle-number INT
The number of circles of the net
--spider.space-radius FLOAT
The distances between the circles
--spider.omit-center
Omit the central node of the network

Random Network Options:

-r, --rand
Forces NETGENSUMO to build a random network
--rand.iterations INT
Describes how many times an edge shall be added to the net
--rand.bidi-probability FLOAT
Defines the probability to build a reverse edge
--rand.max-distance FLOAT
--rand.min-distance FLOAT
--rand.min-angle FLOAT
--rand.num-tries INT
--rand.connectivity FLOAT
--rand.neighbor-dist1 FLOAT
--rand.neighbor-dist2 FLOAT
--rand.neighbor-dist3 FLOAT
--rand.neighbor-dist4 FLOAT
--rand.neighbor-dist5 FLOAT
--rand.neighbor-dist6 FLOAT

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).

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

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.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,...>)

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:

--no-internal-links
Omits internal links
--no-turnarounds
Disables building turnarounds
--no-turnarounds.tls
Disables building turnarounds at tls-controlled junctions
--no-left-connections
Disables building connections to left
--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)

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
-j, --default-junction-type STR
[traffic_light|priority|right_before_left] Determines the type of the build junctions

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

netgensumo -c <CONFIGURATION>
create net from given configuration
netgensumo --grid [grid-network options] -o <OUTPUTFILE>
create grid net
netgensumo --spider [spider-network options] -o <OUTPUTFILE>
create spider net
netgensumo --rand [random-network options] -o <OUTPUTFILE>
create random net

REPORTING BUGS

Report bugs at <http://sourceforge.net/apps/trac/sumo/>.
Get in contact via <[email protected]>.

Copyright (C) 2001-2012 DLR and contributors; http://sumo.sourceforge.net


SUMO netgensumo 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