Vampir 7 User Manual

4.1. TIMELINE CHARTS

Figure 4.8: Counter Timeline options dialog

under “Options...”. It provides the possibility include/exclude the graphs, lines and data

points from the chart. It is also possible to enable an average line showing the average

value of all data points in the visible area.

The counter type setting is used to determine how the data points should be con-

nected. This is dependent on the type of the counter and usually predefined during the

recording of the trace data. Nevertheless, this setting can also be changed afterwards

in Vampir.

The “Counter Data Timeline” chart allows to create custom metrics. This process is

described in Section 4.1.3. Created custom metrics become available in the “Select

Metric” dialog.

4.1.3 Performance Radar

The “Performance Radar” chart, Figure 4.9, displays counter data and provides the

possibility to create custom metrics. In contrast to the “Counter Data Timeline” the

“Performance Radar” shows one counter for all processes at once. The values of the

counter are displayed in a color coded fashion.

The displayed counter in the chart can be chosen via the context menu entry “Set

Metric”. Own created custom metrics are listed under this option as well.

The option “Adjust Bar Height to” allows to change the height of the displayed value

bars in the chart. This useful for traces with a high number of processes. Here the

option “Adjust Bar Height to → Fit Chart Height” tries to display all processes in the

chart. This enables a overview of the counter data across the entire application run.

32

---

CHAPTER 4. PERFORMANCE DATA VISUALIZATION

Figure 4.9: Performance Radar

Figure 4.10: Adjusted value range in color scale

33

---

4.1. TIMELINE CHARTS

“Set Chart Mode” allows to define whether minimum, maximum, or average values

should be shown. This setting comes into effect when multiple measured data points

need to be displayed on one pixel. If “Maximum” or “Minimum” is active, the data point

with the highest or lowest value is displayed, respectively. In case of “Average” the

average of all data points on the respective pixel width is displayed. This process is

also explained in the section “Counter Data Timeline” 4.1.2.

The value range of the color scale can be easily adjusted with the left mouse button.

In order to adjust the color coded value rage just drag the edges of the color scale to

the desired positions. Figure 4.10 shows the “Performance Radar” chart in Figure 4.9

with a smaller value range of 1G - 3G FLOPS. This allows to easily spot areas of high

or low performance in the trace file. The selected value range can also be dragged to

other positions in the color scale. A double-click with the left mouse button on the color

scale resets the selected value range.

The option “Options → Color Scale...” in the context menu of the chart allows to cus-

tomize the color scale to the own preferences.

Figure 4.11: Custom Metrics Editor

The “Custom Metrics Editor” allows to derive own metrics based on existing counters

and functions. The editor is accessible via the context menu entry “Customize Met-

rics...”. Figure 4.11 shows an example custom metric Wait Time. This metric is an

addition of the time spent in the functions MPI Irecv and MPI Wait. Custom Metrics

are build from input metrics that are liked together with the available operations. The

34

---

CHAPTER 4. PERFORMANCE DATA VISUALIZATION

context menu accessible via the right mouse button allows to add new input metrics

and operations. All created custom metrics become available in the “Set Metric...” se-

lections of the “Performance Radar” and “Counter Data Timeline” charts. There are

available as well in the overlay mode of the “Master Timeline”. Custom metrics can be

exported and imported in order to use them in multiple trace files.

4.2 Statistical Charts

4.2.1 Function Summary

The “Function Summary” chart, Figure 4.12, gives an overview of the accumulated

time consumption across all function groups and functions. For example every time

a process calls the MPI Send() function the elapsed time of that function is added to

the MPI function group time. The chart gives a condensed view of the execution of

the application. A comparison between the different function groups can be made and

dominant function groups can be distinguished easily.

Figure 4.12: Function Summary

It is possible to change the information displayed via the context menu entry “Set Met-

ric” that offers options like “Average Exclusive Time”, “Number of Invocations”, “Accu-

mulated Inclusive Time”, etc.

35

---

4.2. STATISTICAL CHARTS

Note: “Inclusive” means the amount of time spent in a function and all of its subrou-

tines. “Exclusive” means the amount of time spent in just this function.

The context menu entry “Set Event Category” specifies whether function groups or

functions should be displayed in the chart. The functions own the color of their function

group.

It is possible to hide functions and function groups from the displayed information with

the context menu entry “Filter”. In order to mark the function or function group to be

filtered just click on the associated label or color representation in the chart. Using the

“Process Filter” (see Section 4.4) allows you to restrict this chart to a set of processes.

As a result, only the consumed time of these processes is displayed for each function

group or function. Instead of using the filter which affects all other displays by hiding

processes, it is possible to select a single process via “Set Process” in the context

menu of the “Function Summary”. This does not have any effect on other charts.

The “Function Summary” can be shown as “Histogram” (a bar chart, like in timeline

charts) or as “Pie Chart”. To switch between these representations use the “Set Chart

Mode” entry of the context menu.

The shown functions or function groups can be sorted by name or value via the context

menu option “Sort By”.

4.2.2 Process Summary

The “Process Summary”, depicted in Figure 4.13, is similar to the “Function Summary”

but shows the information for every process independently. This is useful for analyzing

the balance between processes to reveal bottlenecks. For instance finding that one

process spends a significantly high time performing the calculations could indicate an

unbalanced distribution of work and therefore can slow down the whole application.

The context menu entry “Set Event Category” specifies whether function groups or

functions should be displayed in the chart. The functions own the color of their function

group.

The chart calculates statistics based on “Number of Invocations”, “Accumulated Inclu-

sive Time”, or “Accumulated Exclusive Time”. To change between these three modes

use the context menu entry “Set Metric”.

The number of clustered profile bars is based on the chart height by default. You can

also disable the clustering or set a fixed number of clusters via the context menu entry

“Clustering” by selecting the corresponding value in the spin box. Located left of the

clustered profile bars is a graphical overview indicating the processes associated to the

cluster. Moving the cursor over the blue areas in the overview opens a tooltip stating

the respective process name.

36

---