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