| | Chapter 7. Simulation-GUIThe simulation-GUI (graphical user interface) is basically a wrapper
around the command line simulation. The normal procedure is to start the
gui-version like any other Window-based application (double-click on it)
and to load a simulation's description specified using a "normal"
configuration-file as used by the simulation's command line version. After
loading it - what may dure a longer time if the network is large or the
simulation is forced to load many routes at once - the network shall
appear. Your application should then look like displayed below (with your
own network, of course). You can now start your simulation using the "play"-button and/or
manoeuvre within the network pressing one of the mouse buttons and moving
the mouse. When moving the mouse within the window with the left button
pressed, you'll move the network to the direction you move the mouse. When
the mouse is moved with the right button pressed, you change the scale the
network is displayed in, zooming into and out of the network. We will now discuss the different possibilities to use the graphical
user interface more deeply. 7.1. Main Window Interface- Open Simulation...
Opens a file dialog that lets you choose a
SUMO-configuration file that describes a complete simulation.
The simulation described within this file will be loaded.
Remark that you have to describe the simulation in full - no
further extension is possible.
You can of course load a simulation if another one is
already loaded. In this case, the previous simulation will be
closed.
- Reload Simulation
Reloads the previously opened simulation.
- Close
Closes the loaded simulation.
- [RECENT FILES]
if you have opened at least one file before, it will be
displayed within this list. The list may contain up to ten
files read previously.
- Clear Recent Files
Clears the list of recent files.
- Quit
Quits the application.
- Edit Chosen...
Opens a dialog that lets you load/save and edit the list
of chosen items.
- Edit Additional Weights...
This menu enables you to edit additional weights for
edges. These additional weight descriptions may be saved into
a file and read by the DUAROUTER
and his variants.
- Edit Breakpoints...
This menu enables you to edit, load and save
breakpoints. By now, the simulation will stop at one of the
given brekpoints (simulation time steps) and can be then
continued by pressing the "play"-button ( ).
- Application Settings...
By now, one can only set whether the application shall
be closed automatically when the loaded simulation
ends.
- Simulation Settings...
Displays the settings as read from the configuration
file. This item is only accessible if a simulation has been
loaded.
![[Caution]](images/caution.png) | Caution |
|---|
Under current development. (Better do not use
it)
|
- Show Status Line
By pressing this menu item, you can switch the status
line off and on.
- Show Message Window
By pressing this menu item, you can switch the message
window off and on.
- Show Tool Bar
By pressing this menu item, you can switch the toolbar
off and on.
- Tile Horizontally
Reorders the position of windows.
- Tile Vertically
Reorders the position of windows.
- Cascade
Reorders the position of windows.
- Close
Closes the uppermost window.
- Clear Message Window
Deletes all contents from the message window.
- About
Shows a small window with some information about
SUMO.
- Open Button
Opens a file dialog that lets you choose a
SUMO-configuration file that describes a complete simulation.
The simulation described within this file will be loaded.
Remark that you have to describe the simulation in full - no
further extension is possible.
You can of course load a simulation if another one is
already loaded. In this case, the previous simulation will be
closed.
- Reload Button
Reloads the previously opened simulation.
7.1.2.2. Simulation Operations- Play Button
Starts the simulation. If a loaded simulation was not
started before, it will begin with the step described by the
b(egin)-parameter within the loaded configuration file. If the
simulation was started and stopped, it will continue.
| Caution |
|---|
It is not possible to restart a simulation, you have
to reload it.
|
- Stop Button
Stops a running application. A stopped application can
be continued using the play-button (see above).
- Single Step Button
Performs a single simulation step.
- Current Step Field
After the loaded simulation has been started, the
information about the current time step is displayed
herein.
- Simulation Speed Control
The value you can change using this control is the time
the application waits between two simulation steps. The higher
the value, the slower the simulation will run.
7.1.2.3. Window Operations- New Microscopic View - Button
Opens a new window which displays the streets and
vehicles moving on them.
- New Lane-Aggregated View - Button
Opens a new window which displays the streets and
vehicles moving on them.
7.2. Simulation Window InterfacesSUMO-GUI provides different views on the simulation. The
microscopic view shows the vehicles running just the way as the
simulation performs his work. Aggregated views show the situation on the
streets by coloring lanes by an aggregated value. Vehicles are not shown
within the aggregated view. | Caution |
|---|
Aggregated views need additional simulation time and memory. For
larer netweorks it seems wise to switch them off using the menu-bar
option
|
7.2.1.1. Tracking Settings- Locate Junction - Button
Opens a window that allows to choose a junction name
from the set of junctions the network consists of. Pressing ok
with a chosen junction zooms the view to this junction.
- Locate Edge - Button
Opens a window that allows to choose an edge name from
the set of junctions the network consists of. Pressing ok with
a chosen edge zooms the view to this edge.
- Recenter View - Button
You can use this button to reset the view to show the
whole network. After pressing this button, the view will be
the same as after loading the simulation: The zoom factor will
be reset to a value that lets the window display the whole
simulation area and the middle of the loaded network will be
place into the middle of the view.
- Show Legend - Button
Switches the legend (only the scale) on and off.
- Change Lane Colouring Scheme - Button
The combobox allows you to choose how the view shall
determine a displayed lane's colour. The following coluring
schemes are avaliable for lanes:
- black: All lanes are black
- by purpose: normal lanes are coloured black, sources
green, sinks red and internal lanes blue
- by speed: The lanes are coloured by the speed
allowed on them, blue for fast lanes, red for slow
- Show Grid - Button
Turns the visualisation f the grid the network is mapped
onto on/off. This is rather a debugging feature.
- Show Tool Tips - Button
If this button is activated, the id for the object the
mouse pointer is over will be displayed.
- Show Full Geometry - Button
Switches between full and simple - geometry. The picture
beyond shows the difference between full and simple geometry
mode.
7.2.2. Additional Microscopic View Controls7.2.2.1. Tracking Settings- Locate Vehicle - Button
Opens a window that allows to choose a vehicle name from
the set of vehicle currently driving within the simulation.
Pressing ok with a chosen vehicle zooms the view to this
vehicle.
| Caution |
|---|
Under current development. (Better do not use it, may
terminate the application with an error)
|
- Change Vehicle Colouring Scheme - Button
The combobox allows you to choose how the view shall
determine a displayed vehicle's colour. The following coluring
schemes are avaliable for vehicles:
- by speed: The vehicle colour change continuously
from blue to red with decreasing speed
- specified: The loaded vehicle colours are
used
- by type: The vehicles are coloured as defined within
the vehicle's type definition
- by route: The vehicles are coloured as defined
within the vehicle's route definition
- random#1: Vehicles are coloured randomly (each
vehicle has a certain colour)
- random#2: Vehicles are coloured randomly (each
vehicle has a certain colour); Quite the same as
"random#1", but a different method is used to compute the
random colour
- lanechange#1: ... tbd ...
- lanechange#2: ... tbd ...
- lanechange#3: ... tbd ...
- waiting#1: ... tbd ...
- Change Lane Colouring Scheme - Button
The combobox allows you to choose how the view shall
determine a displayed lane's colour. The following coluring
schemes are avaliable for lanes:
- black: All lanes are black
- by purpose: normal lanes are coloured black, sources
green, sinks red and internal lanes blue
- by speed: The lanes are coloured by the speed
allowed on them, blue for fast lanes, red for slow
- by selection: Selected lanes are coloures blueish,
the other black
7.2.3. Additional Aggregated View Controls- Change Lane Colouring Scheme - Button
The combobox allows you to choose how the view shall
determine a displayed lane's colour. The following coluring
schemes are avaliable for lanes:
- by density: The lanes are coloured by the mean
density of vehicles over them
- by mean speed: The lanes are coloured by the mean
speed of vehicles passing them, blue for fast lanes, red
for slow
- by mean halts:
| Caution |
|---|
... not working, yet. ...
|
- black: All lanes are black
- by purpose: normal lanes are coloured black, sources
green, sinks red and internal lanes blue
- by speed: The lanes are coloured by the speed
allowed on them, blue for fast lanes, red for slow
- by selection: Selected lanes are coloures blueish,
the other black
- Remembering-factor dialer
This dialer enables you to change the "memory" of the
aggregated view.
7.3. Interacting with Objects7.3.1. Display an Object's NameEach view has the possibility to display tool tips. If enabled
using the "Show Tool Tips"-Button
() the name of an object will pop up in a yellow windows
if the cursor is over the object. A second click on the
"Show Tool Tips"-Button disables this
feature. | Caution |
|---|
This feature does slow down the visualisation. Use should use
this carefully and disable if not needed.
|
From version 0.8. you are able to add every object that has a
name (as shown if turning Tool Tips on) into a list of selected
objects. You can select an object by holding the
Alt-key and pressing the left mouse button when the
mouse is over the object. Doing the same a second time will deselect
the object again. You may wonder whether an object is selected or not.
Use the lane colouring "by selection" from
"". When this
colouring scheme is used, selected lanes are shown blueish, the other
black. The menu entry allows you to edit the list of selected objects by
deselected ones you don't need. It also allows you to save the list of
selected objects. The resulting file contains the names of the
selected objects predeccesed by the object's type, one per
line. | Caution |
|---|
Load is not implemented, yet.
|
| Caution |
|---|
The handling of selected items is not yet designed cmopletely.
Parts of the gui's behavior may change in the next time.
|
If you choose the option "" from an object's popup menu, a window like
the one displayed below will appear: This window conatins some of each object's parameter, including
the parameter's name, its current value and the information is static
(marked with a  ) or dynamic (marked with a  ) within a simulation
run. Pressing the right mouse button when being over a line marked as
dynamic will show a small popup window with only a single command:
"". Choosing this option
will allow you to open another window where this parameter's values
will be shown as a time line over the simulation run. You can change the aggregation time of the tracked values within
this window using the combobox in this window's menu. 7.3.5. TL-Tracker WindowsIf you position your mouse over one of the red, green or yellow
traffic light-bars that show the state of the traffic light and press
the right mouse button for at least one second, the appearing pop-up
includes a menu entry "".
Choosing this menu item will show up a diagram that shows the states
of the tl chronologically. Each pixel in x-direction shows the state
of the tls of one second. The display contains the tl-states from the
time the tracker has been opened, no scrolling aorund is
supported. 7.4. Additional Geometry FilesSince version 0.9.4 it is possible to load additional geometry
files into GUISIM which may contain definition of polygons or points of
interest. These shapes are currently meant to improve a simulation's
appearence and to allow an easier debugging. No special interaction with
them is implemented, yet. Both polygons and points-of-interest may be located at a "layer".
Shapes with lowest layer values are drawn first so that they can be
below those with a higher layer number. The network itself is drawn as
layer 0. An additional file may contain definitions for both
points-of-interest and polygons. Any name may be used for the embedding
element. In the following subchapters, it is described how polygons and
points-of-interest may be defined. 7.4.1. Polygon DefinitionsA polygon is defined as following: <poly id="<POLYGON_ID>" type="<TYPENAME>" color="<RED>,<GREEN>,<BLUE>" \
fill="<FILL_OPTION>" layer="<LAYER_NO>"><POINT> [<POINT>]+</poly>
These attributes have the following meanings: id: The id (a unique name) of the
polygon; mandatory string
type: A typename for the polygon. This
value has no meaning; optional string, default: ""
color: The color with which the polygon
shall be displayed; <RED>, <GREEN>, and <BLUE>
must be floating point numbers between 0 and 1. They are devided
using a ',' (no space); mandatory
fill: An information whether the polygon
shall be filled; optional bool, default: false
layer: The number of the layer in which
the polygon lies; optional int, default: -1
7.4.2. Point-of-interest DefinitionsA point-of-interest is defined as following: <poi id="<POLYGON_ID>" type="<TYPENAME>" color="<RED>,<GREEN>,<BLUE>" \
layer="<LAYER_NO>" [(x="<X_POS>" y="<Y_POS>") | (lane="<LANE_ID>" pos="<LANE_POS>")]/>
It means that the position a point-of-interest is located at may
be given either using explicite x/y-coordinates or a lane name and a
position on this lane. So, the attributes have the following
meanings: id: The id (a unique name) of the poi;
mandatory string
type: A typename for the poi. This value
has no meaning; optional string, default: ""
color: The color with which the poi shall
be displayed; <RED>, <GREEN>, and <BLUE> must be
floating point numbers between 0 and 1. They are devided using a
',' (no space); optional, default "1,0,0"
layer: The number of the layer in which
the polygon lies; optional int, default: 1
x: The position of the poi along the
x-axis; float
y: The position of the poi along the
y-axis; float
lane: The name of the lane the poi is
located at; string, the lane must be a part of the loaded
network
pos: The position on the named lane at
which the poi is located at; float
|
