The Java-based hpcviewer interactively presents program performance in a top-down fashion.
hpcviewer [options] [hpctoolkit-database]
Launch hpcviewer and open the experiment database [hpctoolkit-database].
The Java-based hpcviewer interactively presents program-performance experiment databases in a top-down fashion. Since experiment databases are self-contained, they may be relocated from a cluster for visualization on a laptop or workstation.
hpcviewer supports three principal views of an application's performance data. Each view reports both inclusive costs (including callees) and exclusive costs (excluding callees).
To select a group of threads, use the thread selection window by clicking the thread-view button from the calling-context view. On the thread selection window, one needs to select the checkbox of the threads of interest. To narrow the list, one can specify the thread name on the filter part of the window. Recall that the format of the thread is ``process_id . thread_id''. Hence, to specify just a main thread (thread zero), one can type '.0' on the filter, and the view only list threads 0 (such as 1.0, 2.0, 3.0).
Once threads have been selected, click OK, and the Thread view will be activated. The tree of the view is the same as the tree from calling context view, with the metrics only from the selected threads. If there are more than one selected threads, the metrics are the average of the values of the selected threads.
The browser window is split into three panes:
Which items appear in the outline depend on which view is displayed:
The header above the navigation pane contains buttons for adjusting the displayed view:
hpcviewer can display graphs of thread-level metric values. This is useful for quickly assessing load imbalance across processes and threads.
To create a graph, choose the calling context view and select an item in the navigation pane, then pop up the context menu by right-clicking the item. A list of graphable metrics appears at the bottom of the context menu, each with a sub-menu showing the three graph styles that hpcviewer can make. The Plot graph displays metrics by MPI rank and thread number; The Sorted plot graph displays metrics sorted by value; and the Histogram graph displays a barchart of metric value distributions.
Note: graphs are currently available only for databases created by hpcprof-mpi (but not by hpcprof). See Plotting Graphs of Thread-level Metric Values in the User's Manual for details and sample graphs.
Rice University's HPCToolkit Research Group
Email: hpctoolkit-forum =at= rice.edu