Provided by: sumo_0.25.0+dfsg1-2_amd64 
NAME
SUMO - A microscopic road traffic simulation
SYNOPSIS
sumo [OPTION]*
DESCRIPTION
SUMO Version 0.25.0
Copyright (C) 2001-2015 DLR and contributors; http://sumo.dlr.de
A microscopic road traffic simulation.
Configuration Options:
-c, --configuration-file FILE
Loads the named config on startup
--save-configuration FILE
Saves current configuration into FILE
--save-template FILE
Saves a configuration template (empty) into FILE
--save-schema FILE
Saves the configuration schema into FILE
--save-commented
Adds comments to saved template, configuration, or schema
Input Options:
-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
Output Options:
--output-prefix STR
Prefix which is applied to all output files. The special string 'TIME' is replaced
by the current time.
--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
--battery-output FILE
Save the battery values of each vehicle
--battery-output.precision INT
Write battery 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.)
--full-output FILE
Save a lot of information for each timestep (very redundant)
--queue-output FILE
Save the vehicle queues at the junctions (experimental)
--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
--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
--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.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
--link-output FILE
Save links states into FILE
--bt-output FILE
Save bluetooth visibilities into FILE (in conjunction with device.btreceiver and
device.btsender)
--save-state.times INT[]
Use INT[] as times at which a network state written
--save-state.prefix FILE
Prefix for network states
--save-state.files FILE
Files for network states
Time Options:
-b, --begin TIME
Defines the begin time; The simulation starts at this time
-e, --end TIME
Defines the end time; The simulation ends at this time
--step-length TIME
Defines the step duration
Processing Options:
-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-accidents
Do not check whether accidents occur
--ignore-route-errors
Do not check whether routes are connected
--max-num-vehicles INT
Delay vehicle insertion to stay within the given maximum number
--scale FLOAT
Scale demand by the given factor (by discarding or duplicating 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 > 69m/s) are teleported
if they are on a non-continuing lane
--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
--random-depart-offset TIME
Each vehicle receives a random offset to its depart value drawn uniformly from [0,
TIME]
--lanechange.allow-swap
Whether blocking vehicles trying to change lanes may be swapped
--lanechange.duration TIME
Duration of a lane change maneuver (default 0)
--lanechange.overtake-right
Whether overtaking on the right on motorways is permitted
--pedestrian.model STR
Select among pedestrian models ['nonInteracting', 'striping']
--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.jamtime TIME
Time in seconds after which pedestrians start squeezing through a jam when using
model 'striping' (non-positive values disable squeezing)
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)
--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
--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 given weight files for initializing edge weights
--device.rerouting.shortest-path-file FILE
Initialize lookup table for astar from the given distance matrix
--device.rerouting.threads INT
The number of parallel execution threads used for rerouting
--device.rerouting.output FILE
Save adapting weights to FILE
Report Options:
-v, --verbose
Switches to verbose output
--print-options
Prints option values before processing
-?, --help
Prints this screen
-V, --version
Prints the current version
-X, --xml-validation STR
Set schema validation scheme of XML inputs ("never", "auto" or "always")
--xml-validation.net STR
Set schema validation scheme of SUMO network inputs ("never", "auto" or "always")
-W, --no-warnings
Disables output of warnings
-l, --log FILE
Writes all messages to FILE (implies verbose)
--message-log FILE
Writes all non-error messages to FILE (implies verbose)
--error-log FILE
Writes all warnings and errors to FILE
--duration-log.disable
Disable performance reports for individual simulation steps
--duration-log.statistics
Enable statistics on vehicle trips
--no-step-log
Disable console output of current simulation step
Emissions Options:
--phemlight-path FILE
Determines where to load PHEMlight definitions from.
--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
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
Battery Options:
--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
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
TraCI Server Options:
--remote-port INT
Enables TraCI Server if set
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
GUI Only Options:
--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
-S, --start
Start the simulation after loading
-T, --disable-textures
Do not load background pictures
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 <http://sumo.dlr.de/trac/>.
Get in contact via <sumo@dlr.de>.
Copyright (C) 2001-2015 DLR and contributors; http://sumo.dlr.de
SUMO Version 0.25.0 is part of SUMO.
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.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
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