.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.4. .TH SUMO "1" "March 2017" "SUMO netgenerate Version 0.28.0" "User Commands" .SH NAME SUMO \- Road network generator for the microscopic road traffic simulation SUMO .SH SYNOPSIS .B netgenerate [\fI\,OPTION\/\fR]\fI\,*\/\fR .SH DESCRIPTION SUMO netgenerate Version 0.28.0 .IP Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de .PP Road network generator for the microscopic road traffic simulation SUMO. .IP Either "\-\-grid", "\-\-spider" or "\-\-rand" must be supplied. .IP In dependance to these switches other options are used. .SS "Configuration Options:" .TP \fB\-c\fR, \fB\-\-configuration\-file\fR FILE Loads the named config on startup .TP \fB\-\-save\-configuration\fR FILE Saves current configuration into FILE .TP \fB\-\-save\-template\fR FILE Saves a configuration template (empty) into FILE .TP \fB\-\-save\-schema\fR FILE Saves the configuration schema into FILE .TP \fB\-\-save\-commented\fR Adds comments to saved template, configuration, or schema .SS "Grid Network Options:" .TP \fB\-g\fR, \fB\-\-grid\fR Forces NETGEN to build a grid\-like network .TP \fB\-\-grid\fR.number INT The number of junctions in both dirs .TP \fB\-\-grid\fR.length FLOAT The length of streets in both dirs .TP \fB\-\-grid\fR.x\-number INT The number of junctions in x\-dir; Overrides \fB\-\-grid\-number\fR .TP \fB\-\-grid\fR.y\-number INT The number of junctions in y\-dir; Overrides \fB\-\-grid\-number\fR .TP \fB\-\-grid\fR.x\-length FLOAT The length of horizontal streets; Overrides \fB\-\-grid\-length\fR .TP \fB\-\-grid\fR.y\-length FLOAT The length of vertical streets; Overrides \fB\-\-grid\-length\fR .TP \fB\-\-grid\fR.attach\-length FLOAT The length of streets attached at the boundary; 0 means no streets are attached .TP \fB\-\-grid\fR.alphanumerical\-ids The Ids of generated nodes use letters for the X axis .SS "Spider Network Options:" .TP \fB\-s\fR, \fB\-\-spider\fR Forces NETGEN to build a spider\-net\-like network .TP \fB\-\-spider\fR.arm\-number INT The number of axes within the net .TP \fB\-\-spider\fR.circle\-number INT The number of circles of the net .TP \fB\-\-spider\fR.space\-radius FLOAT The distances between the circles .TP \fB\-\-spider\fR.omit\-center Omit the central node of the network .SS "Random Network Options:" .TP \fB\-r\fR, \fB\-\-rand\fR Forces NETGEN to build a random network .TP \fB\-\-rand\fR.iterations INT Describes how many times an edge shall be added to the net .TP \fB\-\-rand\fR.bidi\-probability FLOAT Defines the probability to build a reverse edge .TP \fB\-\-rand\fR.max\-distance FLOAT The maximum distance for each edge .TP \fB\-\-rand\fR.min\-distance FLOAT The minimum distance for each edge .TP \fB\-\-rand\fR.min\-angle FLOAT The minimum angle for each pair of (bidirectional) roads .TP \fB\-\-rand\fR.num\-tries INT The number of tries for creating each node .TP \fB\-\-rand\fR.connectivity FLOAT Probability for roads to continue at each node .TP \fB\-\-rand\fR.neighbor\-dist1 FLOAT Probability for a node having exactly 1 neighbor .TP \fB\-\-rand\fR.neighbor\-dist2 FLOAT Probability for a node having exactly 2 neighbors .TP \fB\-\-rand\fR.neighbor\-dist3 FLOAT Probability for a node having exactly 3 neighbors .TP \fB\-\-rand\fR.neighbor\-dist4 FLOAT Probability for a node having exactly 4 neighbors .TP \fB\-\-rand\fR.neighbor\-dist5 FLOAT Probability for a node having exactly 5 neighbors .TP \fB\-\-rand\fR.neighbor\-dist6 FLOAT Probability for a node having exactly 6 neighbors .SS "Output Options:" .TP \fB\-\-output\-prefix\fR STR Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time. .TP \fB\-o\fR, \fB\-\-output\-file\fR FILE The generated net will be written to FILE .TP \fB\-\-plain\-output\-prefix\fR FILE Prefix of files to write plain xml nodes, edges and connections to .TP \fB\-\-junctions\fR.join\-output FILE Writes information about joined junctions to FILE (can be loaded as additional node\-file to reproduce joins .TP \fB\-\-amitran\-output\fR FILE The generated net will be written to FILE using Amitran format .TP \fB\-\-matsim\-output\fR FILE The generated net will be written to FILE using MATsim format .TP \fB\-\-opendrive\-output\fR FILE The generated net will be written to FILE using OpenDRIVE format .TP \fB\-\-dlr\-navteq\-output\fR FILE The generated net will be written to dlr\-navteq files with the given PREFIX .TP \fB\-\-output\fR.street\-names Street names will be included in the output (if available) .TP \fB\-\-output\fR.original\-names Writes original names, if given, as parameter .TP \fB\-\-street\-sign\-output\fR FILE Writes street signs as POIs to FILE .SS "TLS Building Options:" .TP \fB\-\-tls\fR.set STR Interprets STR as list of junctions to be controlled by TLS .TP \fB\-\-tls\fR.unset STR Interprets STR as list of junctions to be not controlled by TLS .TP \fB\-\-tls\fR.guess Turns on TLS guessing .TP \fB\-\-tls\-guess\fR.joining Includes node clusters into guess .TP \fB\-\-tls\fR.join Tries to cluster tls\-controlled nodes .TP \fB\-\-tls\fR.join\-dist FLOAT Determines the maximal distance for joining traffic lights (defaults to 20) .TP \fB\-\-tls\fR.uncontrolled\-within Do not control edges that lie fully within a joined traffic light. This may cause collisions but allows old traffic light plans to be used .TP \fB\-\-tls\fR.cycle.time INT Use INT as cycle duration .TP \fB\-\-tls\fR.green.time INT Use INT as green phase duration .TP \fB\-D\fR, \fB\-\-tls\fR.yellow.min\-decel FLOAT Defines smallest vehicle deceleration .TP \fB\-\-tls\fR.yellow.patch\-small Given yellow times are patched even if being too short .TP \fB\-\-tls\fR.yellow.time INT Set INT as fixed time for yellow phase durations .TP \fB\-\-tls\fR.left\-green.time INT Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left\-turning phases .TP \fB\-\-tls\fR.half\-offset STR TLSs in STR will be shifted by half\-phase .TP \fB\-\-tls\fR.quarter\-offset STR TLSs in STR will be shifted by quarter\-phase .TP \fB\-\-tls\fR.default\-type STR TLSs with unspecified type will use STR as their algorithm .SS "Edge Removal Options:" .TP \fB\-\-keep\-edges\fR.min\-speed FLOAT Only keep edges with speed in meters/second > FLOAT .TP \fB\-\-remove\-edges\fR.explicit STR Remove edges in STR .TP \fB\-\-keep\-edges\fR.explicit STR Only keep edges in STR .TP \fB\-\-keep\-edges\fR.input\-file FILE Only keep edges in FILE (Each id on a single line. Selection files from SUMO\-GUI are also supported) .TP \fB\-\-remove\-edges\fR.input\-file FILE Remove edges in FILE. (Each id on a single line. Selection files from SUMO\-GUI are also supported) .TP \fB\-\-keep\-edges\fR.in\-boundary STR Only keep edges which are located within the given boundary (given either as CARTESIAN corner coordinates or as polygon ) .TP \fB\-\-keep\-edges\fR.in\-geo\-boundary STR Only keep edges which are located within the given boundary (given either as GEODETIC corner coordinates or as polygon ) .SS "Unregulated Nodes Options:" .TP \fB\-\-keep\-nodes\-unregulated\fR All nodes will be unregulated .TP \fB\-\-keep\-nodes\-unregulated\fR.explicit STR Do not regulate nodes in STR .TP \fB\-\-keep\-nodes\-unregulated\fR.district\-nodes Do not regulate district nodes .SS "Processing Options:" .TP \fB\-\-no\-internal\-links\fR Omits internal links .TP \fB\-\-numerical\-ids\fR Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers .TP \fB\-\-no\-turnarounds\fR Disables building turnarounds .TP \fB\-\-no\-turnarounds\fR.tls Disables building turnarounds at tls\-controlled junctions .TP \fB\-\-no\-left\-connections\fR Disables building connections to left .TP \fB\-\-offset\fR.disable\-normalization Turn off normalizing node positions .TP \fB\-\-offset\fR.x FLOAT Adds FLOAT to net x\-positions .TP \fB\-\-offset\fR.y FLOAT Adds FLOAT to net y\-positions .TP \fB\-\-flip\-y\-axis\fR Flips the y\-coordinate along zero .TP \fB\-\-roundabouts\fR.guess Enable roundabout\-guessing .TP \fB\-\-opposites\fR.guess Enable guessing of opposite direction lanes usable for overtaking .TP \fB\-\-lefthand\fR Assumes left\-hand traffic on the network .TP \fB\-\-edges\fR.join Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import) .TP \fB\-\-junctions\fR.join Joins junctions that are close to each other (recommended for OSM import) .TP \fB\-\-junctions\fR.join\-dist FLOAT Determines the maximal distance for joining junctions (defaults to 10) .TP \fB\-\-junctions\fR.corner\-detail INT Generate INT intermediate points to smooth out intersection corners .TP \fB\-\-junctions\fR.internal\-link\-detail INT Generate INT intermediate points to smooth out lanes within the intersection .TP \fB\-\-junctions\fR.scurve\-stretch FLOAT Generate longer intersections to allow for smooth s\-curves when the number of lanes changes .TP \fB\-\-rectangular\-lane\-cut\fR Forces rectangular cuts between lanes and intersections .TP \fB\-\-check\-lane\-foes\fR.roundabout Allow driving onto a multi\-lane road if there are foes on other lanes (at roundabouts) .TP \fB\-\-check\-lane\-foes\fR.all Allow driving onto a multi\-lane road if there are foes on other lanes (everywhere) .TP \fB\-\-sidewalks\fR.guess Guess pedestrian sidewalks based on edge speed .TP \fB\-\-sidewalks\fR.guess.max\-speed FLOAT Add sidewalks for edges with a speed equal or below the given limit .TP \fB\-\-sidewalks\fR.guess.min\-speed FLOAT Add sidewalks for edges with a speed above the given limit .TP \fB\-\-sidewalks\fR.guess.from\-permissions Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed .TP \fB\-\-sidewalks\fR.guess.exclude STR Do not guess sidewalks for the given list of edges .TP \fB\-\-crossings\fR.guess Guess pedestrian crossings based on the presence of sidewalks .TP \fB\-\-crossings\fR.guess.speed\-threshold FLOAT At uncontrolled nodes, do not build crossings across edges with a speed above the threshold .SS "Building Defaults Options:" .TP \fB\-L\fR, \fB\-\-default\fR.lanenumber INT The default number of lanes in an edge .TP \fB\-\-default\fR.lanewidth FLOAT The default width of lanes .TP \fB\-S\fR, \fB\-\-default\fR.speed FLOAT The default speed on an edge (in m/s) .TP \fB\-P\fR, \fB\-\-default\fR.priority INT The default priority of an edge .TP \fB\-\-default\fR.sidewalk\-width FLOAT The default width of added sidewalks .TP \fB\-\-default\fR.disallow STR The default for disallowed vehicle classes .TP \fB\-\-default\fR.junctions.keep\-clear Whether junctions should be kept clear by default .TP \fB\-\-default\fR.junctions.radius FLOAT The default turning radius of intersections .TP \fB\-j\fR, \fB\-\-default\-junction\-type\fR STR [traffic_light|priority|right_before_left] Determines the type of the build junctions .SS "Report Options:" .TP \fB\-v\fR, \fB\-\-verbose\fR Switches to verbose output .TP \fB\-\-print\-options\fR Prints option values before processing .TP \-?, \fB\-\-help\fR Prints this screen .TP \fB\-V\fR, \fB\-\-version\fR Prints the current version .TP \fB\-X\fR, \fB\-\-xml\-validation\fR STR Set schema validation scheme of XML inputs ("never", "auto" or "always") .TP \fB\-\-xml\-validation\fR.net STR Set schema validation scheme of SUMO network inputs ("never", "auto" or "always") .TP \fB\-W\fR, \fB\-\-no\-warnings\fR Disables output of warnings .TP \fB\-l\fR, \fB\-\-log\fR FILE Writes all messages to FILE (implies verbose) .TP \fB\-\-message\-log\fR FILE Writes all non\-error messages to FILE (implies verbose) .TP \fB\-\-error\-log\fR FILE Writes all warnings and errors to FILE .SS "Random Number Options:" .TP \fB\-\-random\fR Initialises the random number generator with the current system time .TP \fB\-\-seed\fR INT Initialises the random number generator with the given value .SH EXAMPLES .IP netgenerate \-c .IP create net from given configuration .IP netgenerate \-\-grid [grid\-network options] \-o .IP create grid net .IP netgenerate \-\-spider [spider\-network options] \-o .IP create spider net .IP netgenerate \-\-rand [random\-network options] \-o .IP create random net .SH "REPORTING BUGS" Report bugs at . .br Get in contact via . .IP .br Build features: x86_64\-pc\-linux\-gnu InternalLanes DoublePrecision TRACI PROJ GDAL GUI .br Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de .PP .br SUMO netgenerate Version 0.28.0 is part of SUMO. .br 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. .PP .br This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of .br MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .br GNU General Public License for more details. .PP .br 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