.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1.
.TH SUMO "1" "June 2014" "SUMO sumo Version 0.21.0" "User Commands"
.SH NAME
SUMO \- A microscopic road traffic simulation
.SH SYNOPSIS
.B sumo
[\fI\,OPTION\/\fR]\fI\,*\/\fR
.SH DESCRIPTION
SUMO sumo Version 0.21.0
.IP
Copyright (C) 2001\-2014 DLR and contributors; http://sumo\-sim.org
.PP
A microscopic road traffic simulation.
.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
Sets the time offset for vehicle segment
exit times
.SS "Output Options:"
.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\-\-emission\-output\fR FILE
Save the emission values of each vehicle
.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\-\-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.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 bt visibilities into FILE
.TP
\fB\-\-save\-state\fR.times INT[]
Use INT[] as times at which a network
state written
.TP
\fB\-\-save\-state\fR.prefix FILE
Prefix for network states
.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;
The simulation starts at this time
.TP
\fB\-e\fR, \fB\-\-end\fR TIME
Defines the end time;
The simulation ends at this time
.TP
\fB\-\-step\-length\fR TIME
Defines the step duration
.SS "Processing Options:"
.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\-accidents\fR
Do not check whether accidents occure
more deeply
.TP
\fB\-\-ignore\-route\-errors\fR
Do not check whether routes are
connected
.TP
\fB\-\-max\-num\-vehicles\fR INT
Quit simulation if this number of
vehicles is exceeded
.TP
\fB\-\-scale\fR FLOAT
Scale demand by the given factor (0..1)
.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 teleport time on highways
.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.allow\-swap
Whether blocking vehicles trying to
change lanes may be swapped
.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\-\-routing\-algorithm\fR STR
Select among routing algorithms
['dijkstra', 'astar']
.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'
.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\-\-no\-duration\-log\fR
Disable performance reports for
individual simulation steps
.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.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 "Routing Options:"
.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
.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 end
points
.TP
\fB\-\-device\fR.rerouting.init\-with\-loaded\-weights
Use given weight files for
initializing edge weights
.SS "Example Device Options:"
.TP
\fB\-\-device\fR.example.explicit STR
Assign a device to named vehicles
.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 "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\-T\fR, \fB\-\-disable\-textures\fR
Do not load background pictures
.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 .
.br
Get in contact via .
.IP
.br
Copyright (C) 2001\-2014 DLR and contributors; http://sumo\-sim.org
.PP
.br
SUMO sumo Version 0.21.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