Configuration Options:¶

-c, --configuration-file FILE

Loads the named config on startup

-C, --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

Adds comments to saved template, configuration, or schema

Input Options:¶

--new

Start with a new network

-s, --sumo-net-file FILE

Read SUMO-net from FILE

-n, --node-files FILE

Read XML-node defs from FILE

-e, --edge-files FILE

Read XML-edge defs from FILE

-x, --connection-files FILE

Read XML-connection defs from FILE

-i, --tllogic-files FILE

Read XML-traffic light defs from FILE

-t, --type-files FILE

Read XML-type defs from FILE

--ptstop-files FILE

Reads public transport stops from FILE

--ptline-files FILE

Reads public transport lines from FILE

--shapefile-prefix FILE

Read shapefiles (ArcView, Tiger, ...) from files starting with 'FILE'

--dlr-navteq-prefix FILE

Read converted Navteq GDF data (unsplitted Elmar-network) from path 'FILE'

--osm-files FILE

Read OSM-network from path 'FILE(s)'

--opendrive-files FILE

Read OpenDRIVE-network from FILE

--visum-file FILE

Read VISUM-net from FILE

--vissim-file FILE

Read VISSIM-net from FILE

--robocup-dir FILE

Read RoboCup-net from DIR

--matsim-files FILE

Read MATsim-net from FILE

--itsumo-files FILE

Read ITSUMO-net from FILE

--heightmap.shapefiles FILE

Read heightmap from ArcGIS shapefile

--heightmap.geotiff FILE

Read heightmap from GeoTIFF

Output Options:¶

--write-license

Include license info into every output file

--output-prefix STR

Prefix which is applied to all output files. The special string 'TIME' is replaced by the current time.

--precision INT

Defines the number of digits after the comma for floating point output

--precision.geo INT

Defines the number of digits after the comma for lon,lat output

-H, --human-readable-time

Write time values as hour:minute:second or day:hour:minute:second rathern than seconds

-o, --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

--junctions.join-output FILE

Writes information about joined junctions to FILE (can be loaded as additional node-file to reproduce joins

--prefix STR

Defines a prefix for edge and junction names

--amitran-output FILE

The generated net will be written to FILE using Amitran format

--matsim-output FILE

The generated net will be written to FILE using MATsim format

--opendrive-output FILE

The generated net will be written to FILE using OpenDRIVE format

--dlr-navteq-output FILE

The generated net will be written to dlr-navteq files with the given PREFIX

--dlr-navteq.precision INT

The network coordinates are written with the specified level of output precision

--output.street-names

Street names will be included in the output (if available)

--output.original-names

Writes original names, if given, as parameter

--street-sign-output FILE

Writes street signs as POIs to FILE

--ptstop-output FILE

Writes public transport stops to FILE

--ptline-output FILE

Writes public transport lines to FILE

--ptline-clean-up

Clean-up pt stops that are not served by any line

--parking-output FILE

Writes parking areas to FILE

--railway.topology.output FILE

Analyse topology of the railway network

--opendrive-output.straight-threshold FLOAT

Builds parameterized curves whenever the angular change between straight segments exceeds FLOAT degrees

Projection Options:¶

--simple-projection

Uses a simple method for projection

--proj.scale FLOAT

Scaling factor for input coordinates

--proj.rotate FLOAT

Rotation (clockwise degrees) for input coordinates

--proj.utm

Determine the UTM zone (for a universal transversal mercator projection based on the WGS84 ellipsoid)

--proj.dhdn

Determine the DHDN zone (for a transversal mercator projection based on the bessel ellipsoid, "Gauss-Krueger")

--proj STR

Uses STR as proj.4 definition for projection

--proj.inverse

Inverses projection

--proj.dhdnutm

Convert from Gauss-Krueger to UTM

--proj.plain-geo

Write geo coordinates in plain-xml

Processing Options:¶

--speed-in-kmh

vmax is parsed as given in km/h (some)

--construction-date STR

Use YYYY-MM-DD date to determine the readiness of features under construction

--flatten

Remove all z-data

--plain.extend-edge-shape

If edge shapes do not end at the node positions, extend them

--numerical-ids

Remaps alphanumerical IDs of nodes and edges to ensure that all IDs are integers

--reserved-ids FILE

Ensures that generated ids do not included any of the typed IDs from FILE (SUMO-GUI selection file format)

--dismiss-vclasses

Removes vehicle class restrictions from imported edges

--geometry.split

Splits edges across geometry nodes

-R, --geometry.remove

Replace nodes which only define edge geometry by geometry points (joins edges)

--geometry.remove.keep-edges.explicit STR

Ensure that the given list of edges is not modified

--geometry.remove.keep-edges.input-file FILE

Ensure that the edges in FILE are not modified (Each id on a single line. Selection files from SUMO-GUI are also supported)

--geometry.max-segment-length FLOAT

splits geometry to restrict segment length

--geometry.min-dist FLOAT

reduces too similar geometry points

--geometry.max-angle FLOAT

Warn about edge geometries with an angle above DEGREES in successive segments

--geometry.min-radius FLOAT

Warn about edge geometries with a turning radius less than METERS at the start or end

--geometry.min-radius.fix

Straighten edge geometries to avoid turning radii less than geometry.min-radius

--geometry.junction-mismatch-threshold FLOAT

Warn if the junction shape is to far away from the original node position

--geometry.check-overlap FLOAT

Warn if edges overlap by more than the given threshold value

--geometry.check-overlap.vertical-threshold FLOAT

Ignore overlapping edges if they are separated vertically by the given threshold.

--geometry.avoid-overlap

Modify edge geometries to avoid overlap at junctions

--geometry.max-grade FLOAT

Warn about edge geometries with a grade in % above FLOAT.

--geometry.max-grade.fix

Smooth edge edge geometries with a grade in above the warning threshold.

--offset.disable-normalization

Turn off normalizing node positions

--offset.x FLOAT

Adds FLOAT to net x-positions

--offset.y FLOAT

Adds FLOAT to net y-positions

--flip-y-axis

Flips the y-coordinate along zero

--roundabouts.guess

Enable roundabout-guessing

--opposites.guess

Enable guessing of opposite direction lanes usable for overtaking

--opposites.guess.fix-lengths

Ensure that opposite edges have the same length

--lefthand

Assumes left-hand traffic on the network

--edges.join

Merges edges which connect the same nodes and are close to each other (recommended for VISSIM import)

--speed.offset FLOAT

Modifies all edge speeds by adding FLOAT

--speed.factor FLOAT

Modifies all edge speeds by multiplying by FLOAT

--speed.minimum FLOAT

Modifies all edge speeds to at least FLOAT

Building Defaults Options:¶

-L, --default.lanenumber INT

The default number of lanes in an edge

--default.lanewidth FLOAT

The default width of lanes

-S, --default.speed FLOAT

The default speed on an edge (in m/s)

-P, --default.priority INT

The default priority of an edge

--default.sidewalk-width FLOAT

The default width of added sidewalks

--default.crossing-width FLOAT

The default width of a pedestrian crossing

--default.disallow STR

The default for disallowed vehicle classes

--default.junctions.keep-clear

Whether junctions should be kept clear by default

--default.junctions.radius FLOAT

The default turning radius of intersections

--default.right-of-way STR

The default algorithm for computing right of way rules ('default', 'edgePriority')

TLS Building Options:¶

--tls.discard-loaded

Does not instatiate traffic lights loaded from other formats than plain-XML

--tls.discard-simple

Does not instatiate traffic lights at geometry-like nodes loaded from other formats than plain-XML

--tls.set STR

Interprets STR as list of junctions to be controlled by TLS

--tls.unset STR

Interprets STR as list of junctions to be not controlled by TLS

--tls.guess

Turns on TLS guessing

--tls.guess.threshold FLOAT

Sets minimum value for the sum of all incoming lane speeds when guessing TLS

--tls.taz-nodes

Sets district nodes as tls-controlled

--tls-guess.joining

Includes node clusters into guess

--tls.join

Tries to cluster tls-controlled nodes

--tls.join-dist FLOAT

Determines the maximal distance for joining traffic lights (defaults to 20)

--tls.uncontrolled-within

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

--tls.guess-signals

Interprets tls nodes surrounding an intersection as signal positions for a larger TLS. This is typical pattern for OSM-derived networks

--tls.guess-signals.dist FLOAT

Distance for interpreting nodes as signal locations

--tls.cycle.time INT

Use INT as cycle duration

--tls.green.time INT

Use INT as green phase duration

-D, --tls.yellow.min-decel FLOAT

Defines smallest vehicle deceleration

--tls.yellow.patch-small

Given yellow times are patched even if being too short

--tls.yellow.time INT

Set INT as fixed time for yellow phase durations

--tls.red.time INT

Set INT as fixed time for red phase duration at traffic lights that do not have a conflicting flow

--tls.allred.time INT

Set INT as fixed time for intermediate red phase after every switch

--tls.minor-left.max-speed FLOAT

Use FLOAT as threshold for allowing left-turning vehicles to move in the same phase as oncoming straight-going vehicles

--tls.left-green.time INT

Use INT as green phase duration for left turns (s). Setting this value to 0 disables additional left-turning phases

--tls.crossing-min.time INT

Use INT as minimum green duration for pedestrian crossings (s).

--tls.crossing-clearance.time INT

Use INT as clearance time for pedestrian crossings (s).

--tls.scramble.time INT

Use INT as green phase duration for pedestrian scramble phase (s).

--tls.half-offset STR

TLSs in STR will be shifted by half-phase

--tls.quarter-offset STR

TLSs in STR will be shifted by quarter-phase

--tls.default-type STR

TLSs with unspecified type will use STR as their algorithm

--tls.layout STR

Set phase layout four grouping opposite directions or grouping all movements for one incoming edge ['opposites', 'incoming']

--tls.min-dur INT

Default minimum phase duration for traffic lights with variable phase length

--tls.max-dur INT

Default maximum phase duration for traffic lights with variable phase length

Ramp Guessing Options:¶

--ramps.guess

Enable ramp-guessing

--ramps.guess-acceleration-lanes

Guess on-ramps and mark acceleration lanes if they exist but do not add new lanes

--ramps.max-ramp-speed FLOAT

Treat edges with speed > FLOAT as no ramps

--ramps.min-highway-speed FLOAT

Treat edges with speed < FLOAT as no highways

--ramps.ramp-length FLOAT

Use FLOAT as ramp-length

--ramps.set STR

Tries to handle the given edges as ramps

--ramps.unset STR

Do not consider the given edges as ramps

--ramps.no-split

Avoids edge splitting

Edge Removal Options:¶

--keep-edges.min-speed FLOAT

Only keep edges with speed in meters/second > FLOAT

--remove-edges.explicit STR

Remove edges in STR

--keep-edges.explicit STR

Only keep edges in STR or those which are kept due to other keep-edges or remove-edges options

--keep-edges.input-file FILE

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.input-file FILE

Remove edges in FILE. (Each id on a single line. Selection files from SUMO-GUI are also supported)

--keep-edges.postload

Remove edges after joining

--keep-edges.in-boundary STR

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,...>)

--keep-edges.in-geo-boundary STR

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,...>)

--keep-edges.by-vclass STR

Only keep edges which allow one of the vclasss in STR

--remove-edges.by-vclass STR

Remove edges which allow only vclasses from STR

--keep-edges.by-type STR

Only keep edges where type is in STR

--keep-edges.components INT

Only keep the INT largest weakly connected components

--remove-edges.by-type STR

Remove edges where type is in STR

--remove-edges.isolated

Removes isolated edges

Unregulated Nodes Options:¶

--keep-nodes-unregulated

All nodes will be unregulated

--keep-nodes-unregulated.explicit STR

Do not regulate nodes in STR

--keep-nodes-unregulated.district-nodes

Do not regulate district nodes

Junctions Options:¶

--no-internal-links

Omits internal links

--no-turnarounds

Disables building turnarounds

--no-turnarounds.tls

Disables building turnarounds at tls-controlled junctions

--no-turnarounds.except-deadend

Disables building turnarounds except at dead end junctions

--no-left-connections

Disables building connections to left

--junctions.join

Joins junctions that are close to each other (recommended for OSM import)

--junctions.join-dist FLOAT

Determines the maximal distance for joining junctions (defaults to 10)

--junctions.join-exclude STR

Interprets STR as list of junctions to exclude from joining

--junctions.corner-detail INT

Generate INT intermediate points to smooth out intersection corners

--junctions.internal-link-detail INT

Generate INT intermediate points to smooth out lanes within the intersection

--junctions.scurve-stretch FLOAT

Generate longer intersections to allow for smooth s-curves when the number of lanes changes

--junctions.join-turns

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

--junctions.limit-turn-speed FLOAT

Limits speed on junctions to an average lateral acceleration of at most FLOAT m/s^2)

--junctions.limit-turn-speed.min-angle FLOAT

Do not limit turn speed for angular changes below FLOAT (degrees). The value is subtracted from the geometric angle before computing the turning radius.

--junctions.limit-turn-speed.min-angle.railway FLOAT

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.

--junctions.limit-turn-speed.warn.straight FLOAT

Warn about turn speed limits that reduce the speed of straight connections by more than FLOAT

--junctions.limit-turn-speed.warn.turn FLOAT

Warn about turn speed limits that reduce the speed of turning connections (no u-turns) by more than FLOAT

--junctions.small-radius FLOAT

Default radius for junctions that do not require wide vehicle turns

--rectangular-lane-cut

Forces rectangular cuts between lanes and intersections

--check-lane-foes.roundabout

Allow driving onto a multi-lane road if there are foes on other lanes (at roundabouts)

--check-lane-foes.all

Allow driving onto a multi-lane road if there are foes on other lanes (everywhere)

Pedestrian Options:¶

--sidewalks.guess

Guess pedestrian sidewalks based on edge speed

--sidewalks.guess.max-speed FLOAT

Add sidewalks for edges with a speed equal or below the given limit

--sidewalks.guess.min-speed FLOAT

Add sidewalks for edges with a speed above the given limit

--sidewalks.guess.from-permissions

Add sidewalks for edges that allow pedestrians on any of their lanes regardless of speed

--sidewalks.guess.exclude STR

Do not guess sidewalks for the given list of edges

--crossings.guess

Guess pedestrian crossings based on the presence of sidewalks

--crossings.guess.speed-threshold FLOAT

At uncontrolled nodes, do not build crossings across edges with a speed above the threshold

--walkingareas

Always build walking areas even if there are no crossings

Railway Options:¶

--railway.signals.discard

Discard all railway signal information loaded from other formats than plain-xml

--railway.topology.repair

Repair topology of the railway network

--railway.topology.repair.connect-straight

Allow bidiretional rail use wherever rails with opposite directions meet at a straight angle

--railway.topology.all-bidi

Make all rails usable in both direction

--railway.access-distance FLOAT

The search radius for finding suitable road accesses for rail stops

--railway.max-accesses INT

The maximum roud accesses registered per rail stops

--railway.access-factor FLOAT

The walking length of the access is computed as air-line distance multiplied by FLOAT

Formats Options:¶

--osm.skip-duplicates-check

Skips the check for duplicate nodes and edges

--osm.elevation

Imports elevation data

--osm.layer-elevation FLOAT

Reconstruct (relative) elevation based on layer data. Each layer is raised by FLOAT m

--osm.layer-elevation.max-grade FLOAT

Maximum grade threshold in % at 50km/h when reconstrucing elevation based on layer data. The value is scaled according to road speed.

--osm.oneway-spread-right

Whether one-way roads should be spread to the side instead of centered

--osm.stop-output.length FLOAT

The default length of a public transport stop in FLOAT m

--osm.stop-output.length.bus FLOAT

The default length of a bus stop in FLOAT m

--osm.stop-output.length.tram FLOAT

The default length of a tram stop in FLOAT m

--osm.stop-output.length.train FLOAT

The default length of a train stop in FLOAT m

--osm.all-attributes

Whether additional attributes shall be imported

--matsim.keep-length

The edge lengths given in the MATSIM-file will be kept

--matsim.lanes-from-capacity

The lane number will be computed from the capacity

--shapefile.street-id STR

Read edge ids from column STR

--shapefile.from-id STR

Read from-node ids from column STR

--shapefile.to-id STR

Read to-node ids from column STR

--shapefile.type-id STR

Read type ids from column STR

--shapefile.laneNumber STR

Read lane number from column STR

--shapefile.speed STR

Read speed from column STR

--shapefile.name STR

Read (non-unique) name from column STR

--shapefile.node-join-dist FLOAT

Distance threshold for determining whether distinct shapes are connected (used when from-id and to-id are not available)

--shapefile.add-params STR

Add the list of field names as edge params

--shapefile.use-defaults-on-failure

Uses edge type defaults on problems

--shapefile.all-bidirectional

Insert edges in both directions

--shapefile.guess-projection

Guess the proper projection

--vissim.join-distance FLOAT

Structure join offset

--vissim.default-speed FLOAT

Use FLOAT as default speed

--vissim.speed-norm FLOAT

Factor for edge velocity

--vissim.report-unset-speeds

Writes lanes without an explicit speed set

--visum.use-type-priority

Uses priorities from types

--visum.use-type-laneno

Uses lane numbers from types

--visum.use-type-speed

Uses speeds from types

--visum.connector-speeds FLOAT

Sets connector speed

--visum.connectors-lane-number INT

Sets connector lane number

--visum.no-connectors

Excludes connectors

--visum.recompute-lane-number

Computes the number of lanes from the edges' capacities

--visum.verbose-warnings

Prints all warnings, some of which are due to VISUM misbehaviour

--visum.lanes-from-capacity.norm FLOAT

The factor for flow to no. lanes conversion

--opendrive.import-all-lanes

Imports all lane types

--opendrive.ignore-widths

Whether lane widths shall be ignored.

--opendrive.curve-resolution FLOAT

The geometry resolution in m when importing curved geometries as line segments.

--opendrive.advance-stopline FLOAT

Allow stop lines to be built beyond the start of the junction if the geometries allow so

--opendrive.min-width FLOAT

The minimum lane width for determining start or end of variable-width lanes

--opendrive.internal-shapes

Import internal lane shapes

Netedit Options:¶

-a, --sumo-additionals-file STR

file in which additionals are loaded

--additionals-output STR

file in which additionals must be saved

--sumo-shapes-file STR

file in which shapes are loaded

--shapes-output STR

file in which shapes must be saved

--TLSPrograms-output STR

file in which TLS Programs must be saved

Visualisation Options:¶

--disable-laneIcons

Disable icons of special lanes

-T, --disable-textures

-g, --gui-settings-file FILE

Load visualisation settings from FILE

--registry-viewport

Load current viewport from registry

--window-size STR

Create initial window with the given x,y size

--window-pos STR

Create initial window at the given x,y position

--gui-testing

Enable overlay for screen recognition

--gui-testing-debug

Enable output messages during GUI-Testing

--gui-testing-debug-gl

Enable output messages during GUI-Testing specific of gl functions

Report Options:¶

-v, --verbose

Switches to verbose output

--print-options

Prints option values before processing

-?, --help

Prints this screen

-V, --version

Prints the current version

-X, --xml-validation STR

Set schema validation scheme of XML inputs ("never", "auto" or "always")

--xml-validation.net STR

Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")

-W, --no-warnings

Disables output of warnings

-l, --log FILE

Writes all messages to FILE (implies verbose)

--message-log FILE

Writes all non-error messages to FILE (implies verbose)

--error-log FILE

Writes all warnings and errors to FILE

--ignore-errors

Continue on broken input

--ignore-errors.connections

Continue on invalid connections

--show-errors.connections-first-try

Show errors in connections at parsing

--ignore-errors.edge-type

Continue on unknown edge types

Random Number Options:¶

--random

Initialises the random number generator with the current system time

--seed INT

Initialises the random number generator with the given value