Networks/Further Outputs

generated on 2018-10-19 00:15:55.452519 from the wiki page for Networks/Further_Outputs for SUMO git

NETCONVERT, NETGENERATE, and NETEDIT allow to generate additional output files besides writing a SUMO network file. They will be presented in the following.

Writing/Exporting Networks

If no other output option is given, NETCONVERT and NETGENERATE will write the result of network import/generation as a SUMO network file into "net.net.xml". Otherwise the specified output will be generated.

Currently, the applications allow to write networks in the following formats:

SUMO Road Networks

This is the default output format, see above. The name of the file to write the network into can be given using the option --output-file <FILE>. --sumo-output <FILE> and --output <FILE> are synonymes.

Plain XML Output

Parsed node and edge definitions may be saved into a XML-files which have the same formats as the ones used for importing XML-networks (as described in Node Descriptions and Edge Descriptions). This shall ease processing of networks read from other formats than XML. The option --plain-output <FILE> forces NETCONVERT and NETGENERATE to generate a file named "<FILE>.nod.xml" which contains the previously imported nodes, a file named "<FILE>.edg.xml" which contains the previously imported edges, and a file named "<FILE>.con.xml" which contains the previously imported connections. The edge file will contain the list of previously read edges and each edge will have the information about the edge's id, the allowed velocity, the number of lanes, and the from/to - nodes stored. Geometry information is stored only if the imported edge has a shape, meaning that it is not only a straight connection between the from/to-nodes. The lane spread type and the basic edge type are only saved if differing from defaults ("right" and "normal", respectively). Additionally, if one of the lanes prohibits/allows vehicle classes, this information is saved, too (see also "Defining allowed Vehicle Types").

MATsim Road Networks

To write the imported/generated network as a MATsim file, use the option --matsim-output <FILE>. The extension for MATsim networks is usually ".xml".

Please note that the capacity is computed by multiplying an edge's lane number with the capacity norm:

MAXIMUM_FLOW = LANE_NUMBER * CAPACITY_NORM

The value of CAPACITY_NORM is controlled via the option --capacity-norm <FLOAT> (default: 1800).


OpenDRIVE Road Networks

To write the imported/generated network as a OpenDRIVE file (version 1.4), use the option --opendrive-output <FILE>. The extension for OpenDRIVE networks is usually ".xodr".

Some notes:

  • The feature is currently under implementation
  • road - the normal ones
    • the road type is always set to "town" for the complete street
    • the lane type is set to either biking, sidewalk, tram, none or driving according to the edge permissions.
    • link
      • The road is always connected to the nodes it is outgoing (predecessor) / incoming (successor) from/to
    • planView
      • the geometry is given as lines and paramPoly3
    • no road widenings are modeled - if the number of lanes changes, the road changes
    • elevationProfile is written if the network contains 3D geometries
    • lateralProfile does not contain relevant information
    • the roads are always unidirectional, this means only the center lane and the right lanes are given
    • objects and signals do not contain relevant information

Recommended options

  • --junctions.scurve-stretch 1.0. This elongates junction shapes to allow for smooth transitions (values around 1.0 can be used to reduced or increase stretching)
  • --output.original-names. This records the edge IDs from the corresponding .net.xml within <userData sumoID="..."/> elements as children of the <road>

Further Outputs

Public Transport Stops

The option --ptstop-output <FILE> causes an additional-file to be written that contains <busStop/> elements for the imported network. These can be loaded directlyl into SUMO or further modified with NETEDIT.

Information on Joined Junctions

The option --junctions.join-output <FILE> causes a file to be written that specifies the junctions which were joined (usualy due to option --junctions.join). The resulting output file is suitable for loading with the --node-files option.

Street Signs

The option --street-sign-output <FILE> causes a file with POIs to be written. These POIs encode the type of street signs that are encountered on each edge and can be loaded as additional-file in SUMO-GUI. Currently used sign types are:

  • priority
  • yield
  • stop
  • allway_stop
  • right_before_left

Additional Information within the output file

The option --output.street-names <BOOL> ensures that street names from suitable input networks such as OSM or OpenDrive are included in the generated .net.xml file.

When reading or writing OpenDrive networks, the option --output.original-names <BOOL> writtes additional data for mapping between sumo-ids and OpenDrive-ids into the generated networks.


This page was last modified on 9 May 2017, at 08:45.