SUMO
Simulation of Urban MObility

- Home
- Download
- Documentation
- Wiki
- Trac
- Blog
- Contact
- SF-Project

# Networks/Abstract Network Generation

NETGENERATE allows to build three types of abstract networks: grid-networks, spider-networks and random networks.

You always have to supply the name of the network to generate using --output <FILENAME> or -o <FILENAME> for short and the type of network you want to create. So, exactly one of the following switches must be supported: --grid-net, --spider-net or --random-net.

## Grid-like Networks

You are able to describe how many junctions in x- and in y-direction you want to be build and how far from each other they should be. The parameter for the number of junctions are --grid-x-number and --grid-y-number, the ones for the distance between the junctions --grid-x-length and --grid-y-length. If you want to build networks which have the same values for both axes, use --grid-number and --grid-length. The lengths are given in meters. It is possible to give another option --attach-length, which adds streets of the given length at the boundary of the grid such that all crossings have four streets (It is not yet possible to have different attach lengths for x- and y-direction).

An example usage for building could be:

    netgenerate --grid-net --grid-number=10 --grid-length=400 --output-file=MySUMOFile.net.xml

Another one:

    netgenerate --grid-net --grid-x-number=20 --grid-y-number=5 \
     --grid-y-length=40 --grid-x-length=200 --output-file=MySUMOFile.net.xml

These calls will generate the following networks, respectively:

## Spider-like Networks

Spider-net networks are defined by the number of axes dividing them (parameter --spider-arm-number or --arms, default is 13), the number of the circles they are made of (--spider-circle-number or --circles, default is 20) and the distance between the circles (--spider-space-rad or --radius in meters, default is 100).

Caution:
As the number of edges within the middle of the spider net may be quite large, it is often not possible to build a traffic light junction here. Due to this, this junction is always unregulated.

Optionally you can omit the central junction of the network by specifying --spider-omit-center or --nocenter. This also gives an easy way of generating a circle network. Using for instance

    netgenerate --spider-net --spider-omit-center --output-file=MySUMOFile.net.xml

will create a circle consisting of 13 elements with a radius of 100m.

Two examples of usage:

    netgenerate --spider-net --spider-arm-number=10 --spider-circle-number=10 \
     --spider-space-rad=100 --output-file=MySUMOFile.net.xml

and:

    netgenerate --spider-net --spider-arm-number=4 --spider-circle-number=3 \
     --spider-space-rad=100 --output-file=MySUMOFile.net.xml

These calls will generate the following networks, respectively:

## Random Networks

The random network generator does just what its name says, it builds random networks. Several settings may be changed:

- --rand.iterations <INT>:
- --rand.bidi-probability <FLOAT>: the probability to build a reverse edge
- --rand.max-distance <FLOAT>: the maximum edge length
- --rand.min-distance <FLOAT>: the minimum edge length
- --rand.min-angle <FLOAT>: the minimum angle between two edges
- --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>:

An example:

    netgenerate --rand -o MySUMOFile.net.xml --rand.iterations=200

This call will generate the following network:

## Further Options

All abstract network types share some command line options. As all networks may possess junctions, you are able to set the default type of junctions to build using the --default-junction-type-option (or -j for short). The following junction types are allowed in accordance to the junction types currently known by the simulation: priority, traffic_light.

Further, you can specify the default street type by using the same options as in the NETCONVERT-application.

This page was last modified on 10 December 2012, at 22:53.