- completed simulation_widget and holt_widget sections to manual
git-svn-id: svn://svn.gna.org/svn/sgpemv2/trunk@1090 3ecf2c5c-341e-0410-92b4-d18e462d057c
This commit is contained in:
paolo
parent
661f38671e
commit
753f5db241
|
|
@ -799,11 +799,122 @@ request!
|
|||
@subsection The Simulation widget
|
||||
@cindex simulation widget
|
||||
|
||||
@image{simulation_widget,,,Screenshot of the simulation widget}
|
||||
|
||||
The simulation graph, as his name tell, show graphically the simulation progress
|
||||
along the time.@*
|
||||
It represent the processes status at each instant from the simulation beginning
|
||||
to the actual one.@*
|
||||
Into the graph is possible to view the processes only or both processes and threads.
|
||||
|
||||
@strong{Note:} this graph illustrates the @emph{past}. After each simulation
|
||||
step is gone, the corresponding processes'/threads' states are drawn.
|
||||
|
||||
The graph is divided in three areas:
|
||||
@itemize
|
||||
@item At left there are the processes (and optionally threads) names list
|
||||
@item From center to the right take place the graphical area
|
||||
@item At the bottom there is the time ruler
|
||||
@end itemize
|
||||
|
||||
@strong{The Processes/Threads names list}
|
||||
|
||||
Here each process is listed in insertion order.@*
|
||||
If the thread visualization is enabled, below every process is shown a list of his threads.
|
||||
|
||||
@strong{The graphical area}
|
||||
|
||||
It's a rectangular region wich contains some horizontal bars.
|
||||
Each bar correspond to a process or thread; the processes' bars are fat, the threads'
|
||||
are thin.
|
||||
|
||||
The bars are composed horizontally to show the story of each process and thread.
|
||||
If the process (thread) state change, and this is the rule, the corresponding bar
|
||||
change color.@*
|
||||
As default the colors are: green, yellow, red.
|
||||
|
||||
@itemize
|
||||
@item @strong{Green} is used for running processes/threads
|
||||
@item @strong{Yellow} is used for ready processes/threads (waiting to run)
|
||||
@item @strong{Red} is used for blocked processes/threads (waiting for a resource)
|
||||
@end itemize
|
||||
|
||||
The bar starts when the process or thread begin, ends when it die.@*
|
||||
The length of the bar correspond to the time life of the process or thread.
|
||||
|
||||
|
||||
@strong{The time ruler}
|
||||
|
||||
Below the graphical area there is a time ruler from 0 to the current instant.@*
|
||||
The last represented time is the @emph{past} instant.
|
||||
|
||||
The first click on play button will show only notch 0 and no process bars.@*
|
||||
At the second time, on the ruler, will be notches 0 and 1 and eventually the squares
|
||||
corresponding to living processes or threads.@*
|
||||
The other clicks... are all the same!
|
||||
|
||||
@strong{How to show/hide threads}
|
||||
|
||||
With the menu item "Show Threads" under the "View" menu the user can enable or
|
||||
disable threads visibility.
|
||||
|
||||
|
||||
@c % -------------------------------------------------
|
||||
@node The Holt graph, The Preferences dialog, The Simulation widget, From the GUI
|
||||
@subsection The Holt graph
|
||||
@cindex holt
|
||||
|
||||
@image{holt_circle,7.3,8,Screenshot of the holt graph}
|
||||
|
||||
The graph show the simulation status at @emph{this time}.@*
|
||||
It represent resources, processes or threads (and status),
|
||||
requests for resources and allocation.
|
||||
|
||||
If the user choose to view processes then a circle per process is displayed,
|
||||
if she/he choose to view threads only a circle per thread (and no process)
|
||||
is displayed.
|
||||
|
||||
Resources are drawn as squares, processes and threads are circular, requests and
|
||||
allocations are in form of arrows.@*
|
||||
An arrow from process (thread) to a resource is a request from the process to have
|
||||
the resource; an arrow from the resource to the process denote the allocation of the
|
||||
resource to the process.
|
||||
|
||||
The colors, as usual, are: green, yellow, red.
|
||||
|
||||
@itemize
|
||||
@item @strong{Green} is used for running processes/threads
|
||||
@item @strong{Yellow} is used for ready processes/threads (waiting to run)
|
||||
@item @strong{Red} is used for blocked processes/threads (waiting for a resource)
|
||||
@end itemize
|
||||
|
||||
@strong{How to show processes or threads}
|
||||
|
||||
With the menu item "Show Threads" under the "View" menu the user can switch from
|
||||
processes to threads visibility.
|
||||
|
||||
@strong{How to show or hide the Holt Window}
|
||||
|
||||
Holt graph, for pratical reasons, is placed in a separate frame out of the main
|
||||
application window.@*
|
||||
With the item "Show Holt graph" of the "View" menu is possible to show or hide
|
||||
this window. To close is always possible to use the standard close button or
|
||||
system menu command.
|
||||
|
||||
@strong{Changing size and shape}
|
||||
|
||||
The user can change size of the Holt window.@*
|
||||
As the window change size, his contents is scaled and rearranged to fit into
|
||||
the client area.@*
|
||||
If the height/width ratio is >= 5/3 the items are arranged vertially in two
|
||||
columns, resources at left, processes (or threads) at right.@*
|
||||
If the height/width ratio is <= 3/5 the items are arranged horizontally in two
|
||||
rows, resources at top, processes (or threads) at bottom.@*
|
||||
Otherwise the items are disposed along a circle.
|
||||
|
||||
@image{holt_vert,12.1,8,Vertical arrangement of the holt graph}
|
||||
@image{holt_horiz,4.5,8,Horizontal arrangement of the holt graph}
|
||||
|
||||
@c % -------------------------------------------------
|
||||
@node The Preferences dialog, Controlling the simulation, The Holt graph, From the GUI
|
||||
@subsection The Preferences dialog
|
||||
|
|
|
|||
Loading…
Reference in New Issue