table of contents
SUMO(1) | User Commands | SUMO(1) |
NAME¶
SUMO - GUI version of the simulation SUMOSYNOPSIS¶
sumo-gui.exe [OPTION]*DESCRIPTION¶
SUMO gui Version 0.28.0- Copyright (C) 2001-2016 DLR and contributors; http://sumo.dlr.de
GUI version of the simulation SUMO.
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
- --emission-output.precision INT
- Write emission values with the given precision (default 2)
- --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)
- --lanechange-output FILE
- Record lane changes and their motivations for all vehicles into FILE
- --save-state.times INT[]
- Use INT[] as times at which a network state written
- --save-state.period TIME
- save state repeatedly after TIME period
- --save-state.prefix FILE
- Prefix for network states
- --save-state.suffix FILE
- Suffix for network states (.sbx or .xml)
- --save-state.files FILE
- Files for network states
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).
- --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]
- --collision.check-junctions
- Enables collisions checks on junctions
- --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
- --waiting-time-memory TIME
- Length of time interval, over which accumulated waiting time is taken into account
- --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.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.
- --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 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.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
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-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 time penalties when driving across tls controlled junctions based on green split instead of checking actual phases
- --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
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
- -D, --demo
- Restart the simulation after ending (demo mode)
- -T, --disable-textures
- Do not load background pictures
- --window-size STR
- Create initial window with the given x,y size
EXAMPLES¶
- sumo-gui.exe -b 0 -e 1000 -n net.xml -r routes.xml
- start a simulation from time 0 to 1000 with given net and routes
- sumo-gui.exe -c munich_config.cfg
- start with a configuration file
- sumo-gui.exe --help
- print help
REPORTING BUGS¶
Report bugs at <http://sumo.dlr.de/trac/>.Get in contact via <sumo@dlr.de>.
-
Build features: x86_64-pc-linux-gnu InternalLanes DoublePrecision TRACI PROJ GDAL GUI
Copyright (C) 2001-2016 DLR and contributors; http://sumo.dlr.de
SUMO gui Version 0.28.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
November 2016 | SUMO gui Version 0.28.0 |