.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1. .TH SUMO "1" "June 2014" "SUMO netgenerate Version 0.21.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.21.0 .IP Copyright (C) 2001\-2014 DLR and contributors; http://sumo\-sim.org .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 .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 .HP \fB\-\-rand\fR.max\-distance FLOAT .HP \fB\-\-rand\fR.min\-distance FLOAT .HP \fB\-\-rand\fR.min\-angle FLOAT .HP \fB\-\-rand\fR.num\-tries INT .HP \fB\-\-rand\fR.connectivity FLOAT .HP \fB\-\-rand\fR.neighbor\-dist1 FLOAT .HP \fB\-\-rand\fR.neighbor\-dist2 FLOAT .HP \fB\-\-rand\fR.neighbor\-dist3 FLOAT .HP \fB\-\-rand\fR.neighbor\-dist4 FLOAT .HP \fB\-\-rand\fR.neighbor\-dist5 FLOAT .HP \fB\-\-rand\fR.neighbor\-dist6 FLOAT .SS "Output Options:" .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\-M\fR, \fB\-\-map\-output\fR FILE Writes joined edges information to FILE .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.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.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 .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\-\-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\-\-lefthand\fR Assumes left\-hand traffic on the network .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\-\-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\-\-crossings\fR.guess Guess pedestrian crossings based on the presence of sidewalks .TP \fB\-\-tls\fR.join\-dist FLOAT Determines the maximal distance for joining traffic lights (defaults to 20) .SS "Building Defaults Options:" .TP \fB\-L\fR, \fB\-\-default\fR.lanenumber INT The default number of lanes in an edge .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\-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 Copyright (C) 2001\-2014 DLR and contributors; http://sumo\-sim.org .PP .br SUMO netgenerate Version 0.21.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