.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH ECLIPSE "1" "December 2022" "Eclipse SUMO sumo Version 1.15.0" "User Commands"
.SH NAME
Eclipse \- A microscopic, multi-modal traffic simulation
.SH SYNOPSIS
.B sumo
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
Eclipse SUMO sumo Version 1.15.0
.IP
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
A microscopic, multi\-modal traffic simulation.
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\fB\-C\fR, \fB\-\-save\-configuration\fR FILE
Saves current configuration into FILE
.TP
\fB\-\-save\-configuration\fR.relative
Enforce relative paths when saving the
configuration
.TP
\fB\-\-save\-template\fR FILE
Saves a configuration template (empty)
into FILE
.TP
\fB\-\-save\-schema\fR FILE
Saves the configuration schema into FILE
.TP
\fB\-\-save\-commented\fR
Adds comments to saved template,
configuration, or schema
.SS "Input Options:"
.TP
\fB\-n\fR, \fB\-\-net\-file\fR FILE
Load road network description from FILE
.TP
\fB\-r\fR, \fB\-\-route\-files\fR FILE
Load routes descriptions from FILE(s)
.TP
\fB\-a\fR, \fB\-\-additional\-files\fR FILE
Load further descriptions from FILE(s)
.TP
\fB\-w\fR, \fB\-\-weight\-files\fR FILE
Load edge/lane weights for online
rerouting from FILE
.TP
\fB\-x\fR, \fB\-\-weight\-attribute\fR STR
Name of the xml attribute which gives
the edge weight
.TP
\fB\-\-load\-state\fR FILE
Loads a network state from FILE
.TP
\fB\-\-load\-state\fR.offset TIME
Shifts all times loaded from a saved
state by the given offset
.TP
\fB\-\-load\-state\fR.remove\-vehicles STR[]
Removes vehicles with the given IDs from
the loaded state
.TP
\fB\-\-junction\-taz\fR
Initialize a TAZ for every junction to
use attributes toJunction and
fromJunction
.SS "Output Options:"
.TP
\fB\-\-write\-license\fR
Include license info into every output
file
.TP
\fB\-\-output\-prefix\fR STR
Prefix which is applied to all output
files. The special string 'TIME' is
replaced by the current time.
.TP
\fB\-\-precision\fR INT
Defines the number of digits after the
comma for floating point output
.TP
\fB\-\-precision\fR.geo INT
Defines the number of digits after the
comma for lon,lat output
.TP
\fB\-H\fR, \fB\-\-human\-readable\-time\fR
Write time values as hour:minute:second
or day:hour:minute:second rather than
seconds
.TP
\fB\-\-netstate\-dump\fR FILE
Save complete network states into FILE
.TP
\fB\-\-netstate\-dump\fR.empty\-edges
Write also empty edges completely when
dumping
.TP
\fB\-\-netstate\-dump\fR.precision INT
Write positions and speeds with the
given precision (default 2)
.TP
\fB\-\-emission\-output\fR FILE
Save the emission values of each vehicle
.TP
\fB\-\-emission\-output\fR.precision INT
Write emission values with the given
precision (default 2)
.TP
\fB\-\-emission\-output\fR.geo
Save the positions in emission output
using geo\-coordinates (lon/lat)
.TP
\fB\-\-emission\-output\fR.step\-scaled
Write emission values scaled to the step
length rather than as per\-second values
.TP
\fB\-\-battery\-output\fR FILE
Save the battery values of each vehicle
.TP
\fB\-\-battery\-output\fR.precision INT
Write battery values with the given
precision (default 2)
.TP
\fB\-\-elechybrid\-output\fR FILE
Save the elecHybrid values of each
vehicle
.TP
\fB\-\-elechybrid\-output\fR.precision INT
Write elecHybrid values with the given
precision (default 2)
.TP
\fB\-\-elechybrid\-output\fR.aggregated
Write elecHybrid values into one
aggregated file
.TP
\fB\-\-chargingstations\-output\fR FILE
Write data of charging stations
.TP
\fB\-\-overheadwiresegments\-output\fR FILE
Write data of overhead wire segments
.TP
\fB\-\-substations\-output\fR FILE
Write data of electrical substation
stations
.TP
\fB\-\-substations\-output\fR.precision INT
Write substation values with the given
precision (default 2)
.TP
\fB\-\-fcd\-output\fR FILE
Save the Floating Car Data
.TP
\fB\-\-fcd\-output\fR.geo
Save the Floating Car Data using
geo\-coordinates (lon/lat)
.TP
\fB\-\-fcd\-output\fR.signals
Add the vehicle signal state to the FCD
output (brake lights etc.)
.TP
\fB\-\-fcd\-output\fR.distance
Add kilometrage to the FCD output
(linear referencing)
.TP
\fB\-\-fcd\-output\fR.acceleration
Add acceleration to the FCD output
.TP
\fB\-\-fcd\-output\fR.max\-leader\-distance FLOAT
Add leader vehicle information to the
FCD output (within the given distance)
.TP
\fB\-\-fcd\-output\fR.params STR[]
Add generic parameter values to the FCD
output
.TP
\fB\-\-fcd\-output\fR.filter\-edges.input\-file FILE
Restrict fcd output to the edge
selection from the given input file
.TP
\fB\-\-fcd\-output\fR.attributes STR[]
List attributes that should be included
in the FCD output
.TP
\fB\-\-fcd\-output\fR.filter\-shapes STR[]
List shape names that should be used to
filter the FCD output
.TP
\fB\-\-device\fR.ssm.filter\-edges.input\-file FILE
Restrict SSM device output to the
edge selection from the given input file
.TP
\fB\-\-full\-output\fR FILE
Save a lot of information for each
timestep (very redundant)
.TP
\fB\-\-queue\-output\fR FILE
Save the vehicle queues at the junctions
(experimental)
.TP
\fB\-\-queue\-output\fR.period TIME
Save vehicle queues with the given
period
.TP
\fB\-\-vtk\-output\fR FILE
Save complete vehicle positions
inclusive speed values in the VTK Format
(usage: \fI\,/path/out\/\fP will produce
/path/out_$TIMESTEP$.vtp files)
.TP
\fB\-\-amitran\-output\fR FILE
Save the vehicle trajectories in the
Amitran format
.TP
\fB\-\-summary\-output\fR FILE
Save aggregated vehicle departure info
into FILE
.TP
\fB\-\-summary\-output\fR.period TIME
Save summary\-output with the given
period
.TP
\fB\-\-person\-summary\-output\fR FILE
Save aggregated person counts into FILE
.TP
\fB\-\-tripinfo\-output\fR FILE
Save single vehicle trip info into FILE
.TP
\fB\-\-tripinfo\-output\fR.write\-unfinished
Write tripinfo output for vehicles which
have not arrived at simulation end
.TP
\fB\-\-tripinfo\-output\fR.write\-undeparted
Write tripinfo output for vehicles which
have not departed at simulation end
because of depart delay
.TP
\fB\-\-vehroute\-output\fR FILE
Save single vehicle route info into FILE
.TP
\fB\-\-vehroute\-output\fR.exit\-times
Write the exit times for all edges
.TP
\fB\-\-vehroute\-output\fR.last\-route
Write the last route only
.TP
\fB\-\-vehroute\-output\fR.sorted
Sorts the output by departure time
.TP
\fB\-\-vehroute\-output\fR.dua
Write the output in the duarouter
alternatives style
.TP
\fB\-\-vehroute\-output\fR.cost
Write costs for all routes
.TP
\fB\-\-vehroute\-output\fR.intended\-depart
Write the output with the intended
instead of the real departure time
.TP
\fB\-\-vehroute\-output\fR.route\-length
Include total route length in the output
.TP
\fB\-\-vehroute\-output\fR.write\-unfinished
Write vehroute output for vehicles which
have not arrived at simulation end
.TP
\fB\-\-vehroute\-output\fR.skip\-ptlines
Skip vehroute output for public
transport vehicles
.TP
\fB\-\-vehroute\-output\fR.incomplete
Include invalid routes and route stubs
in vehroute output
.TP
\fB\-\-vehroute\-output\fR.stop\-edges
Include information about edges between
stops
.TP
\fB\-\-vehroute\-output\fR.speedfactor
Write the vehicle speedFactor (defaults
to 'true' if departSpeed is written)
.TP
\fB\-\-vehroute\-output\fR.internal
Include internal edges in the output
.TP
\fB\-\-personroute\-output\fR FILE
Save person and container routes to
separate FILE
.TP
\fB\-\-link\-output\fR FILE
Save links states into FILE
.TP
\fB\-\-railsignal\-block\-output\fR FILE
Save railsignal\-blocks into FILE
.TP
\fB\-\-bt\-output\fR FILE
Save bluetooth visibilities into FILE
(in conjunction with device.btreceiver
and device.btsender)
.TP
\fB\-\-lanechange\-output\fR FILE
Record lane changes and their
motivations for all vehicles into FILE
.TP
\fB\-\-lanechange\-output\fR.started
Record start of lane change manoeuvres
.TP
\fB\-\-lanechange\-output\fR.ended
Record end of lane change manoeuvres
.TP
\fB\-\-lanechange\-output\fR.xy
Record coordinates of lane change
manoeuvres
.TP
\fB\-\-stop\-output\fR FILE
Record stops and loading/unloading of
passenger and containers for all
vehicles into FILE
.TP
\fB\-\-stop\-output\fR.write\-unfinished
Write stop output for stops which have
not ended at simulation end
.TP
\fB\-\-collision\-output\fR FILE
Write collision information into FILE
.TP
\fB\-\-edgedata\-output\fR FILE
Write aggregated traffic statistics for
all edges into FILE
.TP
\fB\-\-lanedata\-output\fR FILE
Write aggregated traffic statistics for
all lanes into FILE
.TP
\fB\-\-statistic\-output\fR FILE
Write overall statistics into FILE
.TP
\fB\-\-save\-state\fR.times STR[]
Use TIME[] as times at which a network
state written
.TP
\fB\-\-save\-state\fR.period TIME
save state repeatedly after TIME period
.TP
\fB\-\-save\-state\fR.period.keep INT
Keep only the last INT periodic state
files
.TP
\fB\-\-save\-state\fR.prefix FILE
Prefix for network states
.TP
\fB\-\-save\-state\fR.suffix STR
Suffix for network states (.xml.gz or
\&.xml)
.TP
\fB\-\-save\-state\fR.files FILE
Files for network states
.TP
\fB\-\-save\-state\fR.rng
Save random number generator states
.TP
\fB\-\-save\-state\fR.transportables
Save person and container states
(experimental)
.TP
\fB\-\-save\-state\fR.constraints
Save rail signal constraints
.TP
\fB\-\-save\-state\fR.precision INT
Write internal state values with the
given precision (default 2)
.SS "Time Options:"
.TP
\fB\-b\fR, \fB\-\-begin\fR TIME
Defines the begin time in seconds;
The simulation starts at this time
.TP
\fB\-e\fR, \fB\-\-end\fR TIME
Defines the end time in seconds;
The simulation ends at this time
.TP
\fB\-\-step\-length\fR TIME
Defines the step duration in seconds
.SS "Processing Options:"
.TP
\fB\-\-step\-method\fR.ballistic
Whether to use ballistic method for the
positional update of vehicles (default
is a semi\-implicit Euler method).
.TP
\fB\-\-extrapolate\-departpos\fR
Whether vehicles that depart between
simulation steps should extrapolate the
depart position
.TP
\fB\-\-threads\fR INT
Defines the number of threads for
parallel simulation
.TP
\fB\-\-lateral\-resolution\fR FLOAT
Defines the resolution in m when
handling lateral positioning within a
lane (with \fB\-1\fR all vehicles drive at the
center of their lane
.TP
\fB\-s\fR, \fB\-\-route\-steps\fR TIME
Load routes for the next number of
seconds ahead
.TP
\fB\-\-no\-internal\-links\fR
Disable (junction) internal links
.TP
\fB\-\-ignore\-junction\-blocker\fR TIME
Ignore vehicles which block the junction
after they have been standing for
SECONDS (\fB\-1\fR means never ignore)
.TP
\fB\-\-ignore\-route\-errors\fR
Do not check whether routes are
connected
.TP
\fB\-\-ignore\-accidents\fR
Do not check whether accidents occur
.TP
\fB\-\-collision\fR.action STR
How to deal with collisions:
[none,warn,teleport,remove]
.TP
\fB\-\-collision\fR.stoptime TIME
Let vehicle stop for TIME before
performing collision.action (except for
action 'none')
.TP
\fB\-\-collision\fR.check\-junctions
Enables collisions checks on junctions
.TP
\fB\-\-collision\fR.check\-junctions.mingap FLOAT
Increase or decrease sensitivity
for junction collision check
.TP
\fB\-\-collision\fR.mingap\-factor FLOAT
Sets the fraction of minGap that must be
maintained to avoid collision detection.
If a negative value is given, the
carFollowModel parameter is used
.TP
\fB\-\-max\-num\-vehicles\fR INT
Delay vehicle insertion to stay within
the given maximum number
.TP
\fB\-\-max\-num\-teleports\fR INT
Abort the simulation if the given
maximum number of teleports is exceeded
.TP
\fB\-\-scale\fR FLOAT
Scale demand by the given factor (by
discarding or duplicating vehicles)
.TP
\fB\-\-scale\-suffix\fR STR
Suffix to be added when creating ids for
cloned vehicles
.TP
\fB\-\-time\-to\-teleport\fR TIME
Specify how long a vehicle may wait
until being teleported, defaults to 300,
non\-positive values disable teleporting
.TP
\fB\-\-time\-to\-teleport\fR.highways TIME
The waiting time after which vehicles on
a fast road (speed > 69km/h) are
teleported if they are on a
non\-continuing lane
.TP
\fB\-\-time\-to\-teleport\fR.highways.min\-speed FLOAT
The waiting time after which
vehicles on a fast road (default: speed
> 69km/h) are teleported if they are on
a non\-continuing lane
.TP
\fB\-\-time\-to\-teleport\fR.disconnected TIME
The waiting time after which vehicles
with a disconnected route are
teleported. Negative values disable
teleporting
.TP
\fB\-\-time\-to\-teleport\fR.remove
Whether vehicles shall be removed after
waiting too long instead of being
teleported
.TP
\fB\-\-time\-to\-teleport\fR.ride TIME
The waiting time after which persons /
containers waiting for a pickup are
teleported. Negative values disable
teleporting
.TP
\fB\-\-time\-to\-teleport\fR.bidi TIME
The waiting time after which vehicles on
bidirectional edges are teleported
.TP
\fB\-\-waiting\-time\-memory\fR TIME
Length of time interval, over which
accumulated waiting time is taken into
account (default is 100s.)
.TP
\fB\-\-startup\-wait\-threshold\fR TIME
Minimum consecutive waiting time before
applying startupDelay
.TP
\fB\-\-max\-depart\-delay\fR TIME
How long vehicles wait for departure
before being skipped, defaults to \fB\-1\fR
which means vehicles are never skipped
.TP
\fB\-\-sloppy\-insert\fR
Whether insertion on an edge shall not
be repeated in same step once failed
.TP
\fB\-\-eager\-insert\fR
Whether each vehicle is checked
separately for insertion on an edge
.TP
\fB\-\-emergency\-insert\fR
Allow inserting a vehicle in a situation
which requires emergency braking
.TP
\fB\-\-random\-depart\-offset\fR TIME
Each vehicle receives a random offset to
its depart value drawn uniformly from
[0, TIME]
.TP
\fB\-\-lanechange\fR.duration TIME
Duration of a lane change maneuver
(default 0)
.TP
\fB\-\-lanechange\fR.overtake\-right
Whether overtaking on the right on
motorways is permitted
.TP
\fB\-\-tls\fR.all\-off
Switches off all traffic lights.
.TP
\fB\-\-tls\fR.actuated.show\-detectors
Sets default visibility for actuation
detectors
.TP
\fB\-\-tls\fR.actuated.jam\-threshold FLOAT
Sets default jam\-treshold parameter for
all actuation detectors
.TP
\fB\-\-tls\fR.actuated.detector\-length FLOAT
Sets default detector length parameter
for all actuation detectors
.TP
\fB\-\-tls\fR.delay_based.detector\-range FLOAT
Sets default range for detecting
delayed vehicles
.TP
\fB\-\-tls\fR.yellow.min\-decel FLOAT
Minimum deceleration when braking at
yellow
.TP
\fB\-\-railsignal\-moving\-block\fR
Let railsignals operate in moving\-block
mode by default
.TP
\fB\-\-time\-to\-impatience\fR TIME
Specify how long a vehicle may wait
until impatience grows from 0 to 1,
defaults to 300, non\-positive values
disable impatience growth
.TP
\fB\-\-default\fR.action\-step\-length FLOAT
Length of the default interval length
between action points for the
car\-following and lane\-change models (in
seconds). If not specified, the
simulation step\-length is used per
default. Vehicle\- or VType\-specific
settings override the default. Must be a
multiple of the simulation step\-length.
.TP
\fB\-\-default\fR.carfollowmodel STR
Select default car following model
(Krauss, IDM, ...)
.TP
\fB\-\-default\fR.speeddev FLOAT
Select default speed deviation. A
negative value implies vClass specific
defaults (0.1 for the default passenger
class
.TP
\fB\-\-default\fR.emergencydecel STR
Select default emergencyDecel value
among ('decel', 'default', FLOAT) which
sets the value either to the same as the
deceleration value, a vClass\-class
specific default or the given FLOAT in
m/s^2
.TP
\fB\-\-overhead\-wire\fR.solver
Use Kirchhoff's laws for solving
overhead wire circuit
.TP
\fB\-\-overhead\-wire\fR.recuperation
Enable recuperation from the vehicle
equipped with elecHybrid device into the
ovrehead wire.
.TP
\fB\-\-overhead\-wire\fR.substation\-current\-limits
Enable current limits of traction
substation during solving the overhead
wire electrical circuit.
.TP
\fB\-\-emergencydecel\fR.warning\-threshold FLOAT
Sets the fraction of emergency
decel capability that must be used to
trigger a warning.
.TP
\fB\-\-parking\fR.maneuver
Whether parking simulation includes
manoeuvering time and associated lane
blocking
.TP
\fB\-\-use\-stop\-ended\fR
Override stop until times with stop
ended times when given
.TP
\fB\-\-pedestrian\fR.model STR
Select among pedestrian models
['nonInteracting', 'striping', 'remote']
.TP
\fB\-\-pedestrian\fR.striping.stripe\-width FLOAT
Width of parallel stripes for
segmenting a sidewalk (meters) for use
with model 'striping'
.TP
\fB\-\-pedestrian\fR.striping.dawdling FLOAT
Factor for random slow\-downs [0,1] for
use with model 'striping'
.TP
\fB\-\-pedestrian\fR.striping.mingap\-to\-vehicle FLOAT
Minimal gap / safety buffer
(in meters) from a pedestrian to another
vehicle for use with model 'striping'
.TP
\fB\-\-pedestrian\fR.striping.jamtime TIME
Time in seconds after which pedestrians
start squeezing through a jam when using
model 'striping' (non\-positive values
disable squeezing)
.TP
\fB\-\-pedestrian\fR.striping.jamtime.crossing TIME
Time in seconds after which
pedestrians start squeezing through a
jam while on a pedestrian crossing when
using model 'striping' (non\-positive
values disable squeezing)
.TP
\fB\-\-pedestrian\fR.striping.jamtime.narrow TIME
Time in seconds after which
pedestrians start squeezing through a
jam while on a narrow lane when using
model 'striping'
.TP
\fB\-\-pedestrian\fR.striping.reserve\-oncoming FLOAT
Fraction of stripes to reserve
for oncoming pedestrians
.TP
\fB\-\-pedestrian\fR.striping.reserve\-oncoming.junctions FLOAT
Fraction of stripes
to reserve for oncoming pedestrians on
crossings and walkingareas
.TP
\fB\-\-pedestrian\fR.striping.legacy\-departposlat
Interpret departPosLat for walks
in legacy style
.TP
\fB\-\-pedestrian\fR.striping.walkingarea\-detail INT
Generate INT intermediate
points to smooth out lanes within the
walkingarea
.TP
\fB\-\-pedestrian\fR.remote.address STR
The address (host:port) of the external
simulation
.TP
\fB\-\-ride\fR.stop\-tolerance FLOAT
Tolerance to apply when matching
pedestrian and vehicle positions on
boarding at individual stops
.TP
\fB\-\-persontrip\fR.walk\-opposite\-factor FLOAT
Use FLOAT as a factor on walking
speed against vehicle traffic direction
.SS "Routing Options:"
.TP
\fB\-\-routing\-algorithm\fR STR
Select among routing algorithms
['dijkstra', 'astar', 'CH', 'CHWrapper']
.TP
\fB\-\-weights\fR.random\-factor FLOAT
Edge weights for routing are dynamically
disturbed by a random factor drawn
uniformly from [1,FLOAT)
.TP
\fB\-\-weights\fR.minor\-penalty FLOAT
Apply the given time penalty when
computing minimum routing costs for
minor\-link internal lanes
.TP
\fB\-\-weights\fR.tls\-penalty FLOAT
Apply scaled travel time penalties based
on green split when computing minimum
routing costs for internal lanes at
traffic lights
.TP
\fB\-\-weights\fR.priority\-factor FLOAT
Consider edge priorities in addition to
travel times, weighted by factor
.TP
\fB\-\-weights\fR.separate\-turns FLOAT
Distinguish travel time by turn
direction and shift a fraction of the
estimated time loss ahead of the
intersection onto the internal edges
.TP
\fB\-\-astar\fR.all\-distances FILE
Initialize lookup table for astar from
the given file (generated by marouter
\fB\-\-all\-pairs\-output\fR)
.TP
\fB\-\-astar\fR.landmark\-distances FILE
Initialize lookup table for astar
ALT\-variant from the given file
.TP
\fB\-\-persontrip\fR.walkfactor FLOAT
Use FLOAT as a factor on pedestrian
maximum speed during intermodal routing
.TP
\fB\-\-persontrip\fR.transfer.car\-walk STR[]
Where are mode changes from car to
walking allowed (possible values:
\&'parkingAreas', 'ptStops',
\&'allJunctions' and combinations)
.TP
\fB\-\-persontrip\fR.transfer.taxi\-walk STR[]
Where taxis can drop off customers
('allJunctions, 'ptStops')
.TP
\fB\-\-persontrip\fR.transfer.walk\-taxi STR[]
Where taxis can pick up customers
('allJunctions, 'ptStops')
.TP
\fB\-\-persontrip\fR.default.group STR
When set, trips between the same origin
and destination will share a taxi by
default
.TP
\fB\-\-persontrip\fR.taxi.waiting\-time TIME
Estimated time for taxi pickup
.TP
\fB\-\-railway\fR.max\-train\-length FLOAT
Use FLOAT as a maximum train length when
initializing the railway router
.TP
\fB\-\-replay\-rerouting\fR
Replay exact rerouting sequence from
vehroute\-output
.TP
\fB\-\-device\fR.rerouting.probability FLOAT
The probability for a vehicle to have a
\&'rerouting' device
.TP
\fB\-\-device\fR.rerouting.explicit STR[]
Assign a 'rerouting' device to named
vehicles
.TP
\fB\-\-device\fR.rerouting.deterministic
The 'rerouting' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.rerouting.period TIME
The period with which the vehicle shall
be rerouted
.TP
\fB\-\-device\fR.rerouting.pre\-period TIME
The rerouting period before depart
.TP
\fB\-\-device\fR.rerouting.adaptation\-weight FLOAT
The weight of prior edge weights
for exponential moving average
.TP
\fB\-\-device\fR.rerouting.adaptation\-steps INT
The number of steps for moving
average weight of prior edge weights
.TP
\fB\-\-device\fR.rerouting.adaptation\-interval TIME
The interval for updating the
edge weights
.TP
\fB\-\-device\fR.rerouting.with\-taz
Use zones (districts) as routing startand endpoints
.TP
\fB\-\-device\fR.rerouting.init\-with\-loaded\-weights
Use weight files given with
option \fB\-\-weight\-files\fR for initializing
edge weights
.TP
\fB\-\-device\fR.rerouting.threads INT
The number of parallel execution threads
used for rerouting
.TP
\fB\-\-device\fR.rerouting.synchronize
Let rerouting happen at the same time
for all vehicles
.TP
\fB\-\-device\fR.rerouting.railsignal
Allow rerouting triggered by rail
signals.
.TP
\fB\-\-device\fR.rerouting.bike\-speeds
Compute separate average speeds for
bicycles
.TP
\fB\-\-device\fR.rerouting.output FILE
Save adapting weights to FILE
.TP
\fB\-\-person\-device\fR.rerouting.probability FLOAT
The probability for a person to
have a 'rerouting' device
.TP
\fB\-\-person\-device\fR.rerouting.explicit STR[]
Assign a 'rerouting' device to
named persons
.TP
\fB\-\-person\-device\fR.rerouting.deterministic
The 'rerouting' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-person\-device\fR.rerouting.period TIME
The period with which the person shall
be rerouted
.SS "Report Options:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Switches to verbose output
.TP
\fB\-\-print\-options\fR
Prints option values before processing
.TP
\-?, \fB\-\-help\fR
Prints this screen or selected topics
.TP
\fB\-V\fR, \fB\-\-version\fR
Prints the current version
.TP
\fB\-X\fR, \fB\-\-xml\-validation\fR STR
Set schema validation scheme of XML
inputs ("never", "local", "auto" or
"always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "local", "auto"
or "always")
.TP
\fB\-\-xml\-validation\fR.routes STR
Set schema validation scheme of SUMO
route inputs ("never", "local", "auto"
or "always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.TP
\fB\-\-aggregate\-warnings\fR INT
Aggregate warnings of the same type
whenever more than INT occur
.TP
\fB\-l\fR, \fB\-\-log\fR FILE
Writes all messages to FILE (implies
verbose)
.TP
\fB\-\-message\-log\fR FILE
Writes all non\-error messages to FILE
(implies verbose)
.TP
\fB\-\-error\-log\fR FILE
Writes all warnings and errors to FILE
.TP
\fB\-\-duration\-log\fR.disable
Disable performance reports for
individual simulation steps
.TP
\fB\-t\fR, \fB\-\-duration\-log\fR.statistics
Enable statistics on vehicle trips
.TP
\fB\-\-no\-step\-log\fR
Disable console output of current
simulation step
.TP
\fB\-\-step\-log\fR.period INT
Number of simulation steps between
step\-log outputs
.SS "Emissions Options:"
.TP
\fB\-\-emissions\fR.volumetric\-fuel
Return fuel consumption values in
(legacy) unit l instead of mg
.TP
\fB\-\-phemlight\-path\fR FILE
Determines where to load PHEMlight
definitions from
.TP
\fB\-\-phemlight\-year\fR INT
Enable fleet age modelling with the
given reference year in PHEMlight5
.TP
\fB\-\-phemlight\-temperature\fR FLOAT
Set ambient temperature to correct NOx
emissions in PHEMlight5
.TP
\fB\-\-device\fR.emissions.probability FLOAT
The probability for a vehicle to have a
\&'emissions' device
.TP
\fB\-\-device\fR.emissions.explicit STR[]
Assign a 'emissions' device to named
vehicles
.TP
\fB\-\-device\fR.emissions.deterministic
The 'emissions' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.emissions.begin STR
Recording begin time for emission\-data
.TP
\fB\-\-device\fR.emissions.period STR
Recording period for emission\-output
.SS "Communication Options:"
.TP
\fB\-\-device\fR.btreceiver.probability FLOAT
The probability for a vehicle to have
a 'btreceiver' device
.TP
\fB\-\-device\fR.btreceiver.explicit STR[]
Assign a 'btreceiver' device to named
vehicles
.TP
\fB\-\-device\fR.btreceiver.deterministic
The 'btreceiver' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.btreceiver.range FLOAT
The range of the bt receiver
.TP
\fB\-\-device\fR.btreceiver.all\-recognitions
Whether all recognition point shall be
written
.TP
\fB\-\-device\fR.btreceiver.offtime FLOAT
The offtime used for calculating
detection probability (in seconds)
.TP
\fB\-\-device\fR.btsender.probability FLOAT
The probability for a vehicle to have a
\&'btsender' device
.TP
\fB\-\-device\fR.btsender.explicit STR[]
Assign a 'btsender' device to named
vehicles
.TP
\fB\-\-device\fR.btsender.deterministic
The 'btsender' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-person\-device\fR.btsender.probability FLOAT
The probability for a person to
have a 'btsender' device
.TP
\fB\-\-person\-device\fR.btsender.explicit STR[]
Assign a 'btsender' device to named
persons
.TP
\fB\-\-person\-device\fR.btsender.deterministic
The 'btsender' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-person\-device\fR.btreceiver.probability FLOAT
The probability for a person to
have a 'btreceiver' device
.TP
\fB\-\-person\-device\fR.btreceiver.explicit STR[]
Assign a 'btreceiver' device to
named persons
.TP
\fB\-\-person\-device\fR.btreceiver.deterministic
The 'btreceiver' devices are set
deterministic using a fraction of 1000
.SS "Battery Options:"
.TP
\fB\-\-device\fR.battery.probability FLOAT
The probability for a vehicle to have a
\&'battery' device
.TP
\fB\-\-device\fR.battery.explicit STR[]
Assign a 'battery' device to named
vehicles
.TP
\fB\-\-device\fR.battery.deterministic
The 'battery' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.battery.track\-fuel
Track fuel consumption for non\-electric
vehicles
.SS "Example Device Options:"
.TP
\fB\-\-device\fR.example.probability FLOAT
The probability for a vehicle to have a
\&'example' device
.TP
\fB\-\-device\fR.example.explicit STR[]
Assign a 'example' device to named
vehicles
.TP
\fB\-\-device\fR.example.deterministic
The 'example' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.example.parameter FLOAT
An exemplary parameter which can be used
by all instances of the example device
.SS "SSM Device Options:"
.TP
\fB\-\-device\fR.ssm.probability FLOAT
The probability for a vehicle to have a
\&'ssm' device
.TP
\fB\-\-device\fR.ssm.explicit STR[]
Assign a 'ssm' device to named vehicles
.TP
\fB\-\-device\fR.ssm.deterministic
The 'ssm' devices are set deterministic
using a fraction of 1000
.TP
\fB\-\-device\fR.ssm.measures STR
Specifies which measures will be logged
(as a space or comma\-separated sequence
of IDs in ('TTC', 'DRAC', 'PET'))
.TP
\fB\-\-device\fR.ssm.thresholds STR
Specifies space or comma\-separated
thresholds corresponding to the
specified measures (see documentation
and watch the order!). Only events
exceeding the thresholds will be logged.
.TP
\fB\-\-device\fR.ssm.trajectories
Specifies whether trajectories will be
logged (if false, only the extremal
values and times are reported).
.TP
\fB\-\-device\fR.ssm.range FLOAT
Specifies the detection range in meters.
For vehicles below this distance from
the equipped vehicle, SSM values are
traced.
.TP
\fB\-\-device\fR.ssm.extratime FLOAT
Specifies the time in seconds to be
logged after a conflict is over.
Required >0 if PET is to be calculated
for crossing conflicts.
.TP
\fB\-\-device\fR.ssm.file STR
Give a global default filename for the
SSM output
.TP
\fB\-\-device\fR.ssm.geo
Whether to use coordinates of the
original reference system in output
.TP
\fB\-\-device\fR.ssm.write\-positions
Whether to write positions (coordinates)
for each timestep
.TP
\fB\-\-device\fR.ssm.write\-lane\-positions
Whether to write lanes and their
positions for each timestep
.SS "ToC Device Options:"
.TP
\fB\-\-device\fR.toc.probability FLOAT
The probability for a vehicle to have a
\&'toc' device
.TP
\fB\-\-device\fR.toc.explicit STR[]
Assign a 'toc' device to named vehicles
.TP
\fB\-\-device\fR.toc.deterministic
The 'toc' devices are set deterministic
using a fraction of 1000
.TP
\fB\-\-device\fR.toc.manualType STR
Vehicle type for manual driving regime.
.TP
\fB\-\-device\fR.toc.automatedType STR
Vehicle type for automated driving
regime.
.TP
\fB\-\-device\fR.toc.responseTime FLOAT
Average response time needed by a driver
to take back control.
.TP
\fB\-\-device\fR.toc.recoveryRate FLOAT
Recovery rate for the driver's awareness
after a ToC.
.TP
\fB\-\-device\fR.toc.lcAbstinence FLOAT
Attention level below which a driver
restrains from performing lane changes
(value in [0,1]).
.TP
\fB\-\-device\fR.toc.initialAwareness FLOAT
Average awareness a driver has initially
after a ToC (value in [0,1]).
.TP
\fB\-\-device\fR.toc.mrmDecel FLOAT
Deceleration rate applied during a
\&'minimum risk maneuver'.
.TP
\fB\-\-device\fR.toc.dynamicToCThreshold FLOAT
Time, which the vehicle requires to
have ahead to continue in automated
mode. The default value of 0 indicates
no dynamic triggering of ToCs.
.TP
\fB\-\-device\fR.toc.dynamicMRMProbability FLOAT
Probability that a dynamically
triggered TOR is not answered in time.
.TP
\fB\-\-device\fR.toc.mrmKeepRight
If true, the vehicle tries to change to
the right during an MRM.
.TP
\fB\-\-device\fR.toc.mrmSafeSpot STR
If set, the vehicle tries to reach the
given named stopping place during an
MRM.
.TP
\fB\-\-device\fR.toc.mrmSafeSpotDuration FLOAT
Duration the vehicle stays at the
safe spot after an MRM.
.TP
\fB\-\-device\fR.toc.maxPreparationAccel FLOAT
Maximal acceleration that may be
applied during the ToC preparation
phase.
.TP
\fB\-\-device\fR.toc.ogNewTimeHeadway FLOAT
Timegap for ToC preparation phase.
.TP
\fB\-\-device\fR.toc.ogNewSpaceHeadway FLOAT
Additional spacing for ToC preparation
phase.
.TP
\fB\-\-device\fR.toc.ogMaxDecel FLOAT
Maximal deceleration applied for
establishing increased gap in ToC
preparation phase.
.TP
\fB\-\-device\fR.toc.ogChangeRate FLOAT
Rate of adaptation towards the increased
headway during ToC preparation.
.TP
\fB\-\-device\fR.toc.useColorScheme
Whether a coloring scheme shall by
applied to indicate the different ToC
stages.
.TP
\fB\-\-device\fR.toc.file STR
Switches on output by specifying an
output filename.
.SS "Driver State Device Options:"
.TP
\fB\-\-device\fR.driverstate.probability FLOAT
The probability for a vehicle to have
a 'driverstate' device
.TP
\fB\-\-device\fR.driverstate.explicit STR[]
Assign a 'driverstate' device to named
vehicles
.TP
\fB\-\-device\fR.driverstate.deterministic
The 'driverstate' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.driverstate.initialAwareness FLOAT
Initial value assigned to the
driver's awareness.
.TP
\fB\-\-device\fR.driverstate.errorTimeScaleCoefficient FLOAT
Time scale for the
error process.
.TP
\fB\-\-device\fR.driverstate.errorNoiseIntensityCoefficient FLOAT
Noise intensity
driving the error process.
.TP
\fB\-\-device\fR.driverstate.speedDifferenceErrorCoefficient FLOAT
General scaling
coefficient for applying the error to
the perceived speed difference (error
also scales with distance).
.TP
\fB\-\-device\fR.driverstate.headwayErrorCoefficient FLOAT
General scaling
coefficient for applying the error to
the perceived distance (error also
scales with distance).
.TP
\fB\-\-device\fR.driverstate.speedDifferenceChangePerceptionThreshold FLOAT
Base
threshold for recognizing changes in the
speed difference (threshold also scales
with distance).
.TP
\fB\-\-device\fR.driverstate.headwayChangePerceptionThreshold FLOAT
Base threshold
for recognizing changes in the headway
(threshold also scales with distance).
.TP
\fB\-\-device\fR.driverstate.minAwareness FLOAT
Minimal admissible value for the
driver's awareness.
.TP
\fB\-\-device\fR.driverstate.maximalReactionTime FLOAT
Maximal reaction time
(~action step length) induced by
decreased awareness level (reached for
awareness=minAwareness).
.SS "Bluelight Device Options:"
.TP
\fB\-\-device\fR.bluelight.probability FLOAT
The probability for a vehicle to have a
\&'bluelight' device
.TP
\fB\-\-device\fR.bluelight.explicit STR[]
Assign a 'bluelight' device to named
vehicles
.TP
\fB\-\-device\fR.bluelight.deterministic
The 'bluelight' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.bluelight.reactiondist FLOAT
Set the distance at which other
drivers react to the blue light and
siren sound
.SS "FCD Device Options:"
.TP
\fB\-\-device\fR.fcd.probability FLOAT
The probability for a vehicle to have a
\&'fcd' device
.TP
\fB\-\-device\fR.fcd.explicit STR[]
Assign a 'fcd' device to named vehicles
.TP
\fB\-\-device\fR.fcd.deterministic
The 'fcd' devices are set deterministic
using a fraction of 1000
.TP
\fB\-\-device\fR.fcd.begin STR
Recording begin time for FCD\-data
.TP
\fB\-\-device\fR.fcd.period STR
Recording period for FCD\-data
.TP
\fB\-\-device\fR.fcd.radius FLOAT
Record objects in a radius around
equipped vehicles
.TP
\fB\-\-person\-device\fR.fcd.probability FLOAT
The probability for a person to have a
\&'fcd' device
.TP
\fB\-\-person\-device\fR.fcd.explicit STR[]
Assign a 'fcd' device to named persons
.TP
\fB\-\-person\-device\fR.fcd.deterministic
The 'fcd' devices are set deterministic
using a fraction of 1000
.TP
\fB\-\-person\-device\fR.fcd.period STR
Recording period for FCD\-data
.SS "ElecHybrid Device Options:"
.TP
\fB\-\-device\fR.elechybrid.probability FLOAT
The probability for a vehicle to have
a 'elechybrid' device
.TP
\fB\-\-device\fR.elechybrid.explicit STR[]
Assign a 'elechybrid' device to named
vehicles
.TP
\fB\-\-device\fR.elechybrid.deterministic
The 'elechybrid' devices are set
deterministic using a fraction of 1000
.SS "Taxi Device Options:"
.TP
\fB\-\-device\fR.taxi.probability FLOAT
The probability for a vehicle to have a
\&'taxi' device
.TP
\fB\-\-device\fR.taxi.explicit STR[]
Assign a 'taxi' device to named vehicles
.TP
\fB\-\-device\fR.taxi.deterministic
The 'taxi' devices are set deterministic
using a fraction of 1000
.TP
\fB\-\-device\fR.taxi.dispatch\-algorithm STR
The dispatch algorithm
[greedy|greedyClosest|greedyShared|routeExtension|traci]
.TP
\fB\-\-device\fR.taxi.dispatch\-algorithm.output FILE
Write information from the
dispatch algorithm to FILE
.TP
\fB\-\-device\fR.taxi.dispatch\-algorithm.params STR
Load dispatch algorithm
parameters in format
KEY1:VALUE1[,KEY2:VALUE]
.TP
\fB\-\-device\fR.taxi.dispatch\-period TIME
The period between successive calls to
the dispatcher
.TP
\fB\-\-device\fR.taxi.idle\-algorithm STR
The behavior of idle taxis
[stop|randomCircling]
.TP
\fB\-\-device\fR.taxi.idle\-algorithm.output FILE
Write information from the idling
algorithm to FILE
.SS "GLOSA Device Options:"
.TP
\fB\-\-device\fR.glosa.probability FLOAT
The probability for a vehicle to have a
\&'glosa' device
.TP
\fB\-\-device\fR.glosa.explicit STR[]
Assign a 'glosa' device to named
vehicles
.TP
\fB\-\-device\fR.glosa.deterministic
The 'glosa' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.glosa.range FLOAT
The communication range to the traffic
light
.TP
\fB\-\-device\fR.glosa.max\-speedfactor FLOAT
The maximum speed factor when
approaching a green light
.TP
\fB\-\-device\fR.glosa.min\-speed FLOAT
Minimum speed when coasting towards a
red light
.SS "Tripinfo Device Options:"
.TP
\fB\-\-device\fR.tripinfo.probability FLOAT
The probability for a vehicle to have a
\&'tripinfo' device
.TP
\fB\-\-device\fR.tripinfo.explicit STR[]
Assign a 'tripinfo' device to named
vehicles
.TP
\fB\-\-device\fR.tripinfo.deterministic
The 'tripinfo' devices are set
deterministic using a fraction of 1000
.SS "Vehroutes Device Options:"
.TP
\fB\-\-device\fR.vehroute.probability FLOAT
The probability for a vehicle to have a
\&'vehroute' device
.TP
\fB\-\-device\fR.vehroute.explicit STR[]
Assign a 'vehroute' device to named
vehicles
.TP
\fB\-\-device\fR.vehroute.deterministic
The 'vehroute' devices are set
deterministic using a fraction of 1000
.SS "Friction Device Options:"
.TP
\fB\-\-device\fR.friction.probability FLOAT
The probability for a vehicle to have a
\&'friction' device
.TP
\fB\-\-device\fR.friction.explicit STR[]
Assign a 'friction' device to named
vehicles
.TP
\fB\-\-device\fR.friction.deterministic
The 'friction' devices are set
deterministic using a fraction of 1000
.TP
\fB\-\-device\fR.friction.stdDev FLOAT
The measurement noise parameter which
can be applied to the friction device
.TP
\fB\-\-device\fR.friction.offset FLOAT
The measurement offset parameter which
can be applied to the friction device \->
e.g. to force false measurements
.SS "TraCI Server Options:"
.TP
\fB\-\-remote\-port\fR INT
Enables TraCI Server if set
.TP
\fB\-\-num\-clients\fR INT
Expected number of connecting clients
.SS "Mesoscopic Options:"
.TP
\fB\-\-mesosim\fR
Enables mesoscopic simulation
.TP
\fB\-\-meso\-edgelength\fR FLOAT
Length of an edge segment in mesoscopic
simulation
.TP
\fB\-\-meso\-tauff\fR TIME
Factor for calculating the net free\-free
headway time
.TP
\fB\-\-meso\-taufj\fR TIME
Factor for calculating the net free\-jam
headway time
.TP
\fB\-\-meso\-taujf\fR TIME
Factor for calculating the jam\-free
headway time
.TP
\fB\-\-meso\-taujj\fR TIME
Factor for calculating the jam\-jam
headway time
.TP
\fB\-\-meso\-jam\-threshold\fR FLOAT
Minimum percentage of occupied space to
consider a segment jammed. A negative
argument causes thresholds to be
computed based on edge speed and tauff
(default)
.TP
\fB\-\-meso\-multi\-queue\fR
Enable multiple queues at edge ends
.TP
\fB\-\-meso\-lane\-queue\fR
Enable separate queues for every lane
.TP
\fB\-\-meso\-ignore\-lanes\-by\-vclass\fR STR[]
Do not build queues (or reduce capacity)
for lanes allowing only the given
vclasses
.TP
\fB\-\-meso\-junction\-control\fR
Enable mesoscopic traffic light and
priority junction handling
.TP
\fB\-\-meso\-junction\-control\fR.limited
Enable mesoscopic traffic light and
priority junction handling for saturated
links. This prevents faulty traffic
lights from hindering flow in
low\-traffic situations
.TP
\fB\-\-meso\-tls\-penalty\fR FLOAT
Apply scaled travel time penalties when
driving across tls controlled junctions
based on green split instead of checking
actual phases
.TP
\fB\-\-meso\-tls\-flow\-penalty\fR FLOAT
Apply scaled headway penalties when
driving across tls controlled junctions
based on green split instead of checking
actual phases
.TP
\fB\-\-meso\-minor\-penalty\fR TIME
Apply fixed time penalty when driving
across a minor link. When using
\fB\-\-meso\-junction\-control\fR.limited, the
penalty is not applied whenever limited
control is active.
.TP
\fB\-\-meso\-overtaking\fR
Enable mesoscopic overtaking
.TP
\fB\-\-meso\-recheck\fR TIME
Time interval for rechecking insertion
into the next segment after failure
.SS "Random Number Options:"
.TP
\fB\-\-random\fR
Initialises the random number generator
with the current system time
.TP
\fB\-\-seed\fR INT
Initialises the random number generator
with the given value
.TP
\fB\-\-thread\-rngs\fR INT
Number of pre\-allocated random number
generators to ensure repeatable
multi\-threaded simulations (should be at
least the number of threads for
repeatable simulations).
.SS "GUI Only Options:"
.TP
\fB\-g\fR, \fB\-\-gui\-settings\-file\fR FILE
Load visualisation settings from FILE
.TP
\fB\-Q\fR, \fB\-\-quit\-on\-end\fR
Quits the GUI when the simulation stops
.TP
\fB\-G\fR, \fB\-\-game\fR
Start the GUI in gaming mode
.TP
\fB\-\-game\fR.mode STR
Select the game type ('tls', 'drt')
.TP
\fB\-S\fR, \fB\-\-start\fR
Start the simulation after loading
.TP
\fB\-d\fR, \fB\-\-delay\fR FLOAT
Use FLOAT in ms as delay between
simulation steps
.TP
\fB\-B\fR, \fB\-\-breakpoints\fR STR[]
Use TIME[] as times when the simulation
should halt
.TP
\fB\-\-edgedata\-files\fR FILE
Load edge/lane weights for visualization
from FILE
.TP
\fB\-D\fR, \fB\-\-demo\fR
Restart the simulation after ending
(demo mode)
.TP
\fB\-T\fR, \fB\-\-disable\-textures\fR
Do not load background pictures
.TP
\fB\-\-registry\-viewport\fR
Load current viewport from registry
.TP
\fB\-\-window\-size\fR STR[]
Create initial window with the given x,y
size
.TP
\fB\-\-window\-pos\fR STR[]
Create initial window at the given x,y
position
.TP
\fB\-\-tracker\-interval\fR TIME
The aggregation period for value tracker
windows
.TP
\fB\-\-osg\-view\fR
Start with an OpenSceneGraph view
instead of the regular 2D view
.TP
\fB\-\-gui\-testing\fR
Enable overlay for screen recognition
.TP
\fB\-\-gui\-testing\-debug\fR
Enable output messages during
GUI\-Testing
.TP
\fB\-\-gui\-testing\fR.setting\-output FILE
Save gui settings in the given settings
output file
.SH EXAMPLES
.IP
sumo \-b 0 \-e 1000 \-n net.xml \-r routes.xml
.IP
start a simulation from time 0 to 1000 with given net and routes
.IP
sumo \-c munich_config.cfg
.IP
start with a configuration file
.IP
sumo \-\-help
.IP
print help
.SH "REPORTING BUGS"
Report bugs at <https://github.com/eclipse/sumo/issues>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: Linux\-5.10.0\-19\-amd64 x86_64 GNU 12.2.0 None FMI Proj GUI Intl SWIG GDAL FFmpeg OSG GL2PS Eigen
.br
Copyright (C) 2001\-2022 German Aerospace Center (DLR) and others; https://sumo.dlr.de
.PP
.br
Eclipse SUMO sumo Version 1.15.0 is part of SUMO.
.br
This program and the accompanying materials
are made available under the terms of the Eclipse Public License v2.0
which accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl\-v20.html
.br
This program may also be made available under the following Secondary
.br
Licenses when the conditions for such availability set forth in the Eclipse
.br
Public License 2.0 are satisfied: GNU General Public License, version 2
or later which is available at
https://www.gnu.org/licenses/old\-licenses/gpl\-2.0\-standalone.html
.br
SPDX\-License\-Identifier: EPL\-2.0 OR GPL\-2.0\-or\-later