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
- plain XML definitions, as described in Networks/Building Networks from own XML-descriptions
- MATsim networks
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#
- The feature is currently under implementation
road- the normal ones
- the road
typeis always set to "
town" for the complete street
- the lane
typeis set to either biking, sidewalk, tram, none or driving according to the edge permissions.
- The road is always connected to the nodes it is outgoing
predecessor) / incoming (
- The road is always connected to the nodes it is outgoing (
- the geometry is given as lines and paramPoly3
- no road widenings are modeled - if the number of lanes changes, the road changes
elevationProfileis written if the network contains 3D geometries
lateralProfiledoes not contain relevant information
- the roads are always unidirectional, this means only the center lane and the right lanes are given
signalsdo not contain relevant information
- the road
- --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
Embedding Road Objects#
To include road ojects in the generated xodr-output, the following conditions must be met:
- a polygon file is loaded with
<poly>elements that encode a rectangular shape (4 points) by setting the option --polygon-files <FILE>
- edges include the generic
<param key="roadObjects" value="POLY_D1 POLY_ID2 ... POLY_IDK"/>
Such edges will receive the polygon objects with the indicated IDs as road objects
NETCONVERT does not directly support an output that can be read by QGIS but on Linux the following conversion script can be used to convert a net.xml file into a loadable layer. The layer can be loaded with function Add Delimited Text Layer (Delimiter must be set to 'semicolon', Geometry to WKT).
#!/bin/bash grep "<lane\|<net\|</net" $1 > $1.lanes.xml python $SUMO_HOME/tools/xml/xml2csv.py $1.lanes.xml sed -i 's/ /|/g' $1.lanes.csv sed -i 's/,/ /g' $1.lanes.csv sed -i 's/|/,/g' $1.lanes.csv awk '$5="LINESTRING("$5")"' FS=';' OFS=';' $1.lanes.csv > $1.lanes.qgis.csv
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 directly into
SUMO or further modified with
Public Transport Lines#
The option --ptline-output <FILE> causes a data file to be written that contains information on public transport lines. These can be processed further to generate public transport schedules for simulating public transport and intermodal traffic. This is done automatically when using the osmWebWizard tool
The ptline data format is described below:
<ptLines> <ptLine id="0" name="M2: Alexanderplatz to Heinersdorf" line="M2" type="tram" period="1200" completeness="0.11"> <busStop id="-1615531689" name="S+U Alexanderplatz/Dircksenstraße"/> <busStop id="30732068" name="Memhardstraße"/> </ptLine> ... </ptLines>
The above describes a public transport line which serves two stops with a period of 1200 seconds. The line name as well as the stop names are optional and only serve to enhance human reader comprehension. The tram type is one of the recognized public transport types from OSM (other allowed types are train,subway,light_rail,monorail,trolleybus,aerialway,ferry). The line attribute will be used in the simulation when distinguishing public transport lines. The optinal completeness attribute serves to inform the human reader that the stops only descibe 11% of the complete line. Incomplete lines are typical when importing only a part of the complete public transport network.
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.
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:
OpenDRIVE road objects#
When loading an OpenDRIVE file, embedded road objects can be imported as well.
The option --railway.topology.output causes a file for analyzing the topology of railway networks to be written. This is useful when analyzing network problems in regard to bi-directional track usage and to evaluate the effect of option --railway.topology.repair.
Additional Information within the output 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.