Keywords: usersguide

Next: 3.4 Timeline Zoomable Window Up: 3. Graphical User Interface Previous: 3.2 Logfile Convertor Window Contents

# 3.3 Legend Window

As soon as a SLOG-2 file is selected in the Main window and is ready for visualization, the Legend window like the one shown in Figure 3.6 will be displayed. All the features that are going to be discussed in the Legend window affect both the Timeline and the Histogram windows.

Figure 3.6: Typical Legend window when a slog2 file is first loaded into Jumpshot-4.

The Legend window contains mainly a four-column legend table. The four columns are labeled Topo, Name, V, and S, as in Table 3.6.

Table 3.6: Operations on the Legend window's columns.
Icon | Description | Left Mouse Click on Column Cell | Right Mouse Click on Column Cell or Left Mouse Click on Column Title
| Topology | Pick new Color (Figure 3.7) | None
| Name | Edit Name | Sort Order Menu (Figure 3.8)
| Visibility | Check or Uncheck | Checkbox Operations Menu (Figure 3.9)
| Searchability | Check or Uncheck | Checkbox Operations Menu (Figure 3.9)

Table 3.6 also lists out all defined mouse operations that are provided in each column. The operations are (1) left mouse clicking on the column title icon and on the column cell and (2) right mouse clicking in any column cell.

Figure 3.7: Color Chooser Dialog for column Category Topology

Figure 3.7 is the Color Chooser dialog that will pop up when one of the icon buttons in column Topo is pressed. The color editor provides three ways of choosing a new color. After selecting a new color from the dialog, the new color will be used to update the icon button. The update won't be carried out in the timeline canvas automatically; an explicit screen redraw is needed.

Figure 3.8: Sort Order operation menu for the column Category Name in the Legend window.

Figure 3.8 shows the popup dialog box either when the title icon of column Name is pressed or when the right mouse button is clicked somewhere in the column. Altogether, there are six different sort orders as shown in the figure and they are summarized in Table 3.8.

Table 3.8: Description of the Sort Order operation menu in the Legend window.
Ordering | Description
A...Z a...z | case-sensitive alphabetical ordering
z...a Z...A | reverse-case-sensitive alphabetical ordering
Aa...Zz | case-insensitive alphabetical ordering
zZ...aA | reverse-case-insensitive alphabetical ordering
Creation | category storage ordering in the slog2 file
Reverse Creation | reverse of Creation order

The first four are various combinations of alphabetical and case-sensitive order; for example, z...a Z...A refers to a reverse-case-sensitive alphabetical ordering. The second-to-last order in the list is called the Creation Order, which refers to the order in which categories are stored in the slog2 file when they are being created. The four alphabetical orderings have two hidden sort orders. One is called Preview Order, which puts the preview drawable category before all the real drawable categories of the same topology. The other is Topo Order, which refers to topological ordering (i.e., arrow is ahead of state). The Preview and Topo sort orders can be turned on or off through the Preference window in Table 3.22.

Figure 3.9: Checkbox Operation menu for column Category Visibility and Searchability

Figure 3.9 shows a popup dialog box when the title icon of column V (Visibility) or S (Searchability) is pressed or when the right mouse button is clicked somewhere in either column. The rule of selection in the legend table follows the standard practice of other graphical user interfaces as in Table 3.10. Together with these standard selection rules, the operations provided in the checkbox operation menu allow easy enabling and disabling of visibility as well as searchability checkboxes. With the help of continuous selection of the category rows in the legend table and the various sort orderings, users can easily make a huge number of categories disappear in the Timeline or Histogram window. For instance, in CLOG converted SLOG-2 file where upper-case names always refer to MPI names, the case-sensitive alphabetical ordering allows all MPI names to be put before all user-defined categories. With continuous mouse selection, the user can easily toggle the visibility of user-defined states in the Timeline or Histogram window. Also, every element in the column Name can be edited. This feature allows the user to correct undesirable category names set during logfile creation and even facilitates sorting of the names for selection purposes.

Table 3.10: Standard selection rules.
Left Mouse Operation | Action
CLICK | Click on an object deselects any existing selection and selects the object.
CONTROL-CLICK | Control-click on an object toggles its selection without affecting the selection of any other objects
SHIFT-CLICK | Shift-click on an object extends the selection from the most recently selected object to the current object.
DRAGGING | Dragging (that is, moving the mouse while holding down left mouse button) through a range of TEXT deselects any existing selection and selects the range of text.

NOTE: Any change done in the Legend window that alters the appearance of drawables will not be automatically updated in the Timeline canvas until the CanvasReDraw button in the Timeline window is pressed.

Next: 3.4 Timeline Zoomable Window Up: 3. Graphical User Interface Previous: 3.2 Logfile Convertor Window Contents