SUMO(1) 							   User Commands							   SUMO(1)

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 <sumo-user@lists.sourceforge.net>.

	      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

SUMO netgensumo Version 0.15.0					     May 2012								   SUMO(1)