--- name: "netgensumo" section: "1" platform: "linux" package: "sumo" version: "0.15.0~dfsg-2" release: "Debian 7 (Wheezy)" platforms: ["linux"] url: "https://new.carta.tech/netgensumo" --- # netgensumo(1) Road network generator for the microscopic road traffic simulation SUMO ## 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 \ or as polygon \) ### 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** \ - create net from given configuration - netgensumo **--grid** \[grid-network options\] **-o** \ - create grid net - netgensumo **--spider** \[spider-network options\] **-o** \ - create spider net - netgensumo **--rand** \[random-network options\] **-o** \ - create random net ## REPORTING BUGS Report bugs at \.\ Get in contact via \. - 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