Scroll to navigation

ECLIPSE(1) User Commands ECLIPSE(1)

NAME

Eclipse - Road network generator for the microscopic traffic simulation SUMO

SYNOPSIS

netgenerate [OPTION]*

DESCRIPTION

Eclipse SUMO netgenerate Version 1.15.0

Copyright (C) 2001-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Synthetic network generator for the microscopic, multi-modal traffic simulation

SUMO.
Either "--grid", "--spider" or "--rand" must be supplied.
In dependance to these switches other options are used.

Configuration Options:

Loads the named config on startup
Saves current configuration into FILE
Enforce relative paths when saving the configuration
Saves a configuration template (empty) into FILE
Saves the configuration schema into FILE
Adds comments to saved template, configuration, or schema

Grid Network Options:

Forces NETGEN to build a grid-like network
The number of junctions in both dirs
The length of streets in both dirs
The number of junctions in x-dir; Overrides --grid-number
The number of junctions in y-dir; Overrides --grid-number
The length of horizontal streets; Overrides --grid-length
The length of vertical streets; Overrides --grid-length
The length of streets attached at the boundary; 0 means no streets are attached
The length of streets attached at the boundary in x direction; 0 means no streets are attached
The length of streets attached at the boundary in y direction; 0 means no streets are attached

Spider Network Options:

Forces NETGEN to build a spider-net-like network
The number of axes within the net
The number of circles of the net
The distances between the circles
Omit the central node of the network

Random Network Options:

Forces NETGEN to build a random network
Describes how many times an edge shall be added to the net
Defines the probability to build a reverse edge
The maximum distance for each edge
The minimum distance for each edge
The minimum angle for each pair of (bidirectional) roads in DEGREES
The number of tries for creating each node
Probability for roads to continue at each node
Probability for a node having exactly 1 neighbor
Probability for a node having exactly 2 neighbors
Probability for a node having exactly 3 neighbors
Probability for a node having exactly 4 neighbors
Probability for a node having exactly 5 neighbors
Probability for a node having exactly 6 neighbors
Draw lane numbers randomly from [1,default.lanenumber]
Draw edge priority randomly from [1,default.priority]
Draw edge type randomly from all loaded types
Place nodes on a regular grid with spacing rand.min-distance

Input Options:

Read edge-type defs from FILE

Output Options:

Include license info into every output file
Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.
Defines the number of digits after the comma for floating point output
Defines the number of digits after the comma for lon,lat output
Write time values as hour:minute:second or day:hour:minute:second rather than seconds
The Ids of generated nodes use an alphanumerical code for easier readability when possible
The generated net will be written to FILE
Prefix of files to write plain xml nodes, edges and connections to
Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins
Defines a prefix for edge and junction names
The generated net will be written to FILE using Amitran format
The generated net will be written to FILE using MATsim format
The generated net will be written to FILE using OpenDRIVE format
The generated net will be written to dlr-navteq files with the given PREFIX
The network coordinates are written with the specified level of output precision
Street names will be included in the output (if available)
Writes original names, if given, as parameter
Writes street signs as POIs to FILE
Builds parameterized curves whenever the angular change between straight segments exceeds FLOAT degrees

Processing Options:

Generate INT left-turn lanes
Set the length of generated turning lanes to FLOAT
Apply random spatial perturbation in x direction according the the given distribution
Apply random spatial perturbation in y direction according the the given distribution
Apply random spatial perturbation in z direction according the the given distribution
Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers
Remaps IDs of nodes to integers starting at INT
Remaps IDs of edges to integers starting at INT
Ensures that generated ids do not included any of the typed IDs from FILE (sumo-gui selection file format)
Splits edges across geometry nodes
Replace nodes which only define edge geometry by geometry points (joins edges)
Ensure that the given list of edges is not modified
Ensure that the edges in FILE are not modified (Each id on a single line. Selection files from sumo-gui are also supported)
Allow merging edges with differing attributes when their length is below min-length
Allow merging edges with differing lane widths if the difference is below FLOAT
splits geometry to restrict segment length
Warn about edge geometries with a grade in % above FLOAT.
Smooth edge edge geometries with a grade in above the warning threshold.
Turn off normalizing node positions
Adds FLOAT to net x-positions
Adds FLOAT to net y-positions
Adds FLOAT to net z-positions
Flips the y-coordinate along zero
Enable roundabout-guessing
Default visibility when approaching a roundabout
Enable guessing of opposite direction lanes usable for overtaking
Ensure that opposite edges have the same length
Enable guessing of network fringe nodes
Guess disconnected edges above the given speed as outer fringe
Assumes left-hand traffic on the network
Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import)

Building Defaults Options:

The default number of lanes in an edge
The default width of lanes
The default method for computing lane shapes from edge shapes
The default speed on an edge (in m/s)
The default friction on an edge
The default priority of an edge
The default edge type
The default width of added sidewalks
The default width of added bike lanes
The default width of a pedestrian crossing
The default for allowed vehicle classes
The default for disallowed vehicle classes
Whether junctions should be kept clear by default
The default turning radius of intersections
The default length when overriding connection lengths
The default algorithm for computing right of way rules ('default', 'edgePriority')
[traffic_light|priority|right_before_left|left_before_right|traffic_light_right_on_red|priority_stop|allway_stop|...] Determines junction type (see wiki/Networks/PlainXML#Node_types)

TLS Building Options:

Interprets STR[] as list of junctions to be controlled by TLS
Interprets STR[] as list of junctions to be not controlled by TLS
Turns on TLS guessing
Sets minimum value for the sum of all incoming lane speeds when guessing TLS
Includes node clusters into guess
Tries to cluster tls-controlled nodes
Determines the maximal distance for joining traffic lights (defaults to 20)
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
Do not build mutually conflicting response matrix, potentially ignoring vehicles that are stuck at an internal junction when their phase has ended
Use INT as cycle duration
Use INT as green phase duration
Defines smallest vehicle deceleration
Given yellow times are patched even if being too short
Set INT as fixed time for yellow phase durations
Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow
Set INT as fixed time for intermediate red phase after every switch
Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles
Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases
Set INT as fixed time for intermediate vehext phase after every switch
Set INT as fixed time for intermediate NEMA yelow phase after every switch
Set INT as fixed time for intermediate NEMA red phase after every switch
Use INT as minimum green duration for pedestrian crossings (s).
Use INT as clearance time for pedestrian crossings (s).
Use INT as green phase duration for pedestrian scramble phase (s).
TLSs in STR[] will be shifted by half-phase
TLSs in STR[] will be shifted by quarter-phase
TLSs with unspecified type will use STR as their algorithm
Set phase layout four grouping opposite directions or grouping all movements for one incoming edge ['opposites', 'incoming']
Avoid phases with green and red signals for different connections from the same lane
Default minimum phase duration for traffic lights with variable phase length
Default maximum phase duration for traffic lights with variable phase length
Assign the same tls link index to connections that share the same states
Assign a distinct tls link index to every connection
Does not instatiate traffic lights at geometry-like nodes

Edge Removal Options:

Only keep edges with speed in meters/second > FLOAT
Remove edges in STR[]
Only keep edges in STR[] or those which are kept due to other keep-edges or remove-edges options
Only keep edges in FILE (Each id on a single line. Selection files from sumo-gui are also supported) or those which are kept due to other keep-edges or remove-edges options
Remove edges in FILE. (Each id on a single line. Selection files from sumo-gui are also supported)
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,...>)
Only keep edges which are located within the given boundary (given either as GEODETIC corner coordinates <lon-min,lat-min,lon-max,lat-max> or as polygon <lon0,lat0,lon1,lat1,...>)

Unregulated Nodes Options:

All nodes will be unregulated
Do not regulate nodes in STR[]
Do not regulate district nodes

Junctions Options:

Allow building right-before-left junctions when the incoming edge speeds are below FLOAT (m/s)
Build left-before-right junctions instead of right-before-left junctions
Omits internal links
Disables building turnarounds
Disables building turnarounds at tls-controlled junctions
Disables building turnarounds at geometry-like junctions
Disables building turnarounds except at dead end junctions
Disables building turnarounds except at at junctions with a dedicated turning lane
Disables building turnarounds at fringe junctions
Disables building connections to left
Joins junctions that are close to each other (recommended for OSM import)
Determines the maximal distance for joining junctions (defaults to 10)
Joins junctions that have the same coordinates even if not connected
Abbreviate junction or TLS id if it joins more than INT junctions
Generate INT intermediate points to smooth out intersection corners
Generate INT intermediate points to smooth out lanes within the intersection
Generate longer intersections to allow for smooth s-curves when the number of lanes changes
Builds common edges for turning connections with common from- and to-edge. This causes discrepancies between geometrical length and assigned length due to averaging but enables lane-changing while turning
Limits speed on junctions to an average lateral acceleration of at most FLOAT m/s^2)
Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius.
Do not limit turn speed for angular changes below FLOAT (degrees) on railway edges. The value is subtracted from the geometric angle before computing the turning radius.
Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT
Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT
Default radius for junctions that do not require wide vehicle turns
Use maximum value of incoming and outgoing edge speed on junction instead of average
Assumed vehicle width for computing internal junction positions
Forces rectangular cuts between lanes and intersections
Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)
Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)

Pedestrian Options:

Guess pedestrian sidewalks based on edge speed
Add sidewalks for edges with a speed equal or below the given limit
Add sidewalks for edges with a speed above the given limit
Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed
Do not guess sidewalks for the given list of edges
Guess pedestrian crossings based on the presence of sidewalks
At uncontrolled nodes, do not build crossings across edges with a speed above the threshold
Always build walking areas even if there are no crossings
Do not create a walkingarea between sidewalks that are connected by a pedestrian junction within FLOAT

Bicycle Options:

Guess bike lanes based on edge speed
Add bike lanes for edges with a speed equal or below the given limit
Add bike lanes for edges with a speed above the given limit
Add bike lanes for edges that allow bicycles on any of their lanes regardless of speed
Do not guess bikelanes for the given list of edges

Report Options:

Switches to verbose output
Prints option values before processing
-?, --help
Prints this screen or selected topics
Prints the current version
Set schema validation scheme of XML inputs ("never", "local", "auto" or "always")
Disables output of warnings
Aggregate warnings of the same type whenever more than INT occur
Writes all messages to FILE (implies verbose)
Writes all non-error messages to FILE (implies verbose)
Writes all warnings and errors to FILE

Random Number Options:

Initialises the random number generator with the current system time
Initialises the random number generator with the given value

EXAMPLES

netgenerate -c <CONFIGURATION>
create net from given configuration
netgenerate --grid [grid-network options] -o <OUTPUTFILE>
create grid net
netgenerate --spider [spider-network options] -o <OUTPUTFILE>
create spider net
netgenerate --rand [random-network options] -o <OUTPUTFILE>
create random net

REPORTING BUGS

Report bugs at <https://github.com/eclipse/sumo/issues>.
Get in contact via <sumo@dlr.de>.


Build features: Linux-5.10.0-20-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
Copyright (C) 2001-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de

Eclipse SUMO netgenerate Version 1.15.0 is part of SUMO.
This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v20.html
This program may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse
Public License 2.0 are satisfied: GNU General Public License, version 2 or later which is available at https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later

January 2023 Eclipse SUMO netgenerate Version 1.15.0