NETGEN
Contents |
From 30.000 feet
NETGEN generates abstract road networks that may be used by other SUMO-applications.
- Purpose: Abstract road network generation
- System: portable (Linux/Windows is tested); runs on command line
- Input (mandatory): Command line parameter
- Output: A generated SUMO-road network; optionally also other outputs
- Programming Language: c++
Usage Description
Options
You may use a XML schema definition file for setting up a NETGEN configuration: netgenConfiguration.xsd.
Configuration
| Option | Default Value | Description |
|---|---|---|
| -c <FILE> --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 | false | Adds comments to saved template, configuration, or schema |
Grid Network
| Option | Default Value | Description |
|---|---|---|
| -g --grid | false | Forces NETGEN to build a grid-like network |
| --grid.number <INT> | 5 | The number of junctions in both dirs |
| --grid.length <FLOAT> | 100 | The length of streets in both dirs |
| --grid.x-number <INT> | 5 | The number of junctions in x-dir; Overrides --grid-number |
| --grid.y-number <INT> | 5 | The number of junctions in y-dir; Overrides --grid-number |
| --grid.x-length <FLOAT> | 100 | The length of horizontal streets; Overrides --grid-length |
| --grid.y-length <FLOAT> | 100 | The length of vertical streets; Overrides --grid-length |
| --grid.attach-length <FLOAT> | 0 | The length of streets attached at the boundary; 0 means no streets are attached |
Spider Network
| Option | Default Value | Description |
|---|---|---|
| -s --spider | false | Forces NETGEN to build a spider-net-like network |
| --spider.arm-number <INT> | 13 | The number of axes within the net |
| --spider.circle-number <INT> | 20 | The number of circles of the net |
| --spider.space-radius <FLOAT> | 100 | The distances between the circles |
| --spider.omit-center | false | Omit the central node of the network |
Random Network
| Option | Default Value | Description |
|---|---|---|
| -r --rand | false | Forces NETGEN to build a random network |
| --rand.iterations <INT> | 2000 | Describes how many times an edge shall be added to the net |
| --rand.bidi-probability <FLOAT> | 1 | Defines the probability to build a reverse edge |
| --rand.max-distance <FLOAT> | 250 | |
| --rand.min-distance <FLOAT> | 100 | |
| --rand.min-angle <FLOAT> | 0.785398 | |
| --rand.num-tries <INT> | 50 | |
| --rand.connectivity <FLOAT> | 0.95 | |
| --rand.neighbor-dist1 <FLOAT> | 0 | |
| --rand.neighbor-dist2 <FLOAT> | 0 | |
| --rand.neighbor-dist3 <FLOAT> | 10 | |
| --rand.neighbor-dist4 <FLOAT> | 10 | |
| --rand.neighbor-dist5 <FLOAT> | 2 | |
| --rand.neighbor-dist6 <FLOAT> | 1 |
Output
| Option | Default Value | Description |
|---|---|---|
| -o <FILE> --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 | |
| -M <FILE> --map-output <FILE> | Writes joined edges information to FILE | |
| --matsim-output <FILE> | The generated net will be written to FILE using MATSIM format. | |
| --output.street-names | false | Street names will be included in the output (if available). |
TLS Building
| Option | Default Value | Description |
|---|---|---|
| --tls.set <STRING> | Interprets STR as list of junctions to be controlled by TLS | |
| --tls.unset <STRING> | Interprets STR as list of junctions to be not controlled by TLS | |
| --tls.guess | false | Turns on TLS guessing |
| --tls-guess.joining | false | Includes node clusters into guess |
| --tls.join | false | Tries to cluster tls-controlled nodes |
| --tls.green.time <INT> | 31 | Use INT as green phase duration |
| -D <FLOAT> --tls.yellow.min-decel <FLOAT> | 3 | Defines smallest vehicle deceleration |
| --tls.yellow.patch-small | false | 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 <STRING> | TLSs in STR will be shifted by half-phase | |
| --tls.quarter-offset <STRING> | TLSs in STR will be shifted by quarter-phase |
Edge Removal
| Option | Default Value | Description |
|---|---|---|
| --keep-edges.min-speed <FLOAT> | Remove edges with speed < FLOAT | |
| --remove-edges.explicit <STRING> | Remove edges in STR | |
| --keep-edges.explicit <STRING> | Remove edges not in STR | |
| --keep-edges.input-file <FILE> | Removed edges not in FILE | |
| --keep-edges.in-boundary <STRING> | Keeps edges which are located within the given boundary |
Unregulated Nodes
| Option | Default Value | Description |
|---|---|---|
| --keep-nodes-unregulated | false | All nodes will be not regulated |
| --keep-nodes-unregulated.explicit <STRING> | Do not regulate nodes in STR | |
| --keep-nodes-unregulated.district-nodes | false | Do not regulate district nodes |
Processing
Normally, both NETCONVERT and NETGEN translate the read network so that the left- and down-most node are at coordinate (0,0). The following options allow to disable this and to apply different offsets for both the x- and the y-axis. If there are explicit offsets given, the normalization is disabled automatically (thus there is no need to give --disable-normalize-node-positions if there is at least one of the offsets given).
| Option | Default Value | Description |
|---|---|---|
| --no-internal-links | false | Omits internal links |
| --no-turnarounds | false | Disables building turnarounds |
| --no-turnarounds.tls | false | Disables building turnarounds at tls-controlled junctions |
| --offset.disable-normalization | false | Turn off normalizing node positions |
| --offset.x <FLOAT> | 0 | Adds FLOAT to net x-positions |
| --offset.y <FLOAT> | 0 | Adds FLOAT to net y-positions |
| --flip-y-axis | false | Flips the y-coordinate along zero |
| --roundabouts.guess | false | Enable roundabout-guessing |
| --lefthand | false | Assumes left-hand traffic on the network |
| --junctions.join | false | Joins junctions that are close to each other (recommended for OSM import) |
| --junctions.join-dist <FLOAT> | 15 | Determines the maximal distance for joining junctions (defaults to 15) |
Building Defaults
| Option | Default Value | Description |
|---|---|---|
| -L <INT> --default.lanenumber <INT> | 1 | The default number of lanes in an edge |
| -S <FLOAT> --default.speed <FLOAT> | 13.9 | The default speed on an edge (in m/s) |
| -P <INT> --default.priority <INT> | -1 | The default priority of an edge |
| -j <STRING> --default-junction-type <STRING> | [traffic_light|priority|right_before_left] Determines the type of the build junctions |
Report
| Option | Default Value | Description |
|---|---|---|
| -v --verbose | false | Switches to verbose output |
| -p --print-options | false | Prints option values before processing |
| -? --help | true | Prints this screen |
| -V --version | false | Prints the current version |
| -W --no-warnings | false | Disables output of warnings |
| -l <FILE> --log <FILE> | Writes all messages to FILE | |
| --message-log <FILE> | Writes all non-error messages to FILE | |
| --error-log <FILE> | Writes all warnings and errors to FILE |
Random Number
| Option | Default Value | Description |
|---|---|---|
| --random | false | Initialises the random number generator with the current system time |
| --seed <INT> | 23423 | Initialises the random number generator with the given value |
This page was last modified on 25 November 2011, at 12:37.