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