.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.46.4.
.TH SUMO "1" "March 2017" "SUMO gui Version 0.28.0" "User Commands"
.SH NAME
SUMO \- GUI version of the simulation SUMO
.SH SYNOPSIS
.B sumo-gui.exe
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
SUMO gui Version 0.28.0
.IP
Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de
.PP
GUI version of the simulation SUMO.
.SS "Configuration Options:"
.TP
\fB\-c\fR, \fB\-\-configuration\-file\fR FILE
Loads the named config on startup
.TP
\fB\-\-save\-configuration\fR FILE
Saves current configuration into FILE
.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
.SS "Output Options:"
.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\-\-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\-\-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\-\-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\-\-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\-\-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\-\-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\-\-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.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\-\-link\-output\fR FILE
Save links states 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\-\-save\-state\fR.times INT[]
Use INT[] 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.prefix FILE
Prefix for network states
.TP
\fB\-\-save\-state\fR.suffix FILE
Suffix for network states (.sbx or .xml)
.TP
\fB\-\-save\-state\fR.files FILE
Files for network states
.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\-\-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.check\-junctions
Enables collisions checks on junctions
.TP
\fB\-\-max\-num\-vehicles\fR INT
Delay vehicle insertion to stay within
the given maximum number
.TP
\fB\-\-scale\fR FLOAT
Scale demand by the given factor (by
discarding or duplicating 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 > 69m/s) are
teleported if they are on a
non\-continuing lane
.TP
\fB\-\-waiting\-time\-memory\fR TIME
Length of time interval, over which
accumulated waiting time is taken into
account
.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\-\-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\-\-pedestrian\fR.model STR
Select among pedestrian models
['nonInteracting', 'striping']
.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.jamtime TIME
Time in seconds after which pedestrians
start squeezing through a jam when
using model 'striping' (non\-positive
values disable squeezing)
.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\-\-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.shortest\-path\-file FILE
Initialize lookup table for astar
from the given distance matrix
.TP
\fB\-\-device\fR.rerouting.threads INT
The number of parallel execution threads
used for rerouting
.TP
\fB\-\-device\fR.rerouting.output FILE
Save adapting weights to FILE
.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
.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", "auto" or "always")
.TP
\fB\-\-xml\-validation\fR.net STR
Set schema validation scheme of SUMO
network inputs ("never", "auto" or
"always")
.TP
\fB\-W\fR, \fB\-\-no\-warnings\fR
Disables output of warnings
.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\-\-duration\-log\fR.statistics
Enable statistics on vehicle trips
.TP
\fB\-\-no\-step\-log\fR
Disable console output of current
simulation step
.SS "Emissions Options:"
.TP
\fB\-\-phemlight\-path\fR FILE
Determines where to load PHEMlight
definitions from.
.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
.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
.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
.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 "TraCI Server Options:"
.TP
\fB\-\-remote\-port\fR INT
Enables TraCI Server if set
.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\-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 time penalties when driving
across tls controlled junctions based
on green split instead of checking
actual phases
.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
.SS "GUI Only Options:"
.TP
\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\-S\fR, \fB\-\-start\fR
Start the simulation after loading
.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\-\-window\-size\fR STR
Create initial window with the given x,y
size
.SH EXAMPLES
.IP
sumo\-gui.exe \-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\-gui.exe \-c munich_config.cfg
.IP
start with a configuration file
.IP
sumo\-gui.exe \-\-help
.IP
print help
.SH "REPORTING BUGS"
Report bugs at <http://sumo.dlr.de/trac/>.
.br
Get in contact via <sumo@dlr.de>.
.IP
.br
Build features: x86_64\-pc\-linux\-gnu InternalLanes DoublePrecision TRACI PROJ GDAL GUI
.br
Copyright (C) 2001\-2016 DLR and contributors; http://sumo.dlr.de
.PP
.br
SUMO gui Version 0.28.0 is part of SUMO.
.br
SUMO is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
.PP
.br
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
.br
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.br
GNU General Public License for more details.
.PP
.br
You should have received a copy of the GNU General Public License
along with this program. If not, see http://www.gnu.org/licenses/gpl.html