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
- --rand.min-distance 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