Scroll to navigation

SUMO(1) User Commands SUMO(1)

NAME

SUMO - A microscopic road traffic simulation

SYNOPSIS

sumo [ OPTION]*

DESCRIPTION

SUMO sumo Version 0.21.0
Copyright (C) 2001-2014 DLR and contributors; http://sumo-sim.org
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
Sets the time offset for vehicle segment exit times

Output Options:

--netstate-dump FILE
Save complete network states into FILE
--netstate-dump.empty-edges
Write also empty edges completely when dumping
--emission-output FILE
Save the emission values of each vehicle
--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
--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.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 bt visibilities into FILE
--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 occure more deeply
--ignore-route-errors
Do not check whether routes are connected
--max-num-vehicles INT
Quit simulation if this number of vehicles is exceeded
--scale FLOAT
Scale demand by the given factor (0..1)
--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 teleport time on highways
--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
--routing-algorithm STR
Select among routing algorithms ['dijkstra', 'astar']
--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'

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
--no-duration-log
Disable performance reports for individual simulation steps
--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.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

Routing Options:

--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 end points
--device.rerouting.init-with-loaded-weights
Use given weight files for initializing edge weights

Example Device Options:

--device.example.explicit STR
Assign a device to named vehicles
--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-sim.org/trac/>.
 
Get in contact via <sumo-user@lists.sourceforge.net>.
 
Copyright (C) 2001-2014 DLR and contributors; http://sumo-sim.org
SUMO sumo Version 0.21.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
June 2014 SUMO sumo Version 0.21.0