Reference

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 <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-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