Interactive Presentation of Performance

The HPCToolkit Performance Tools


Version 2020.08-develop

The Java-based hpcviewer interactively presents program performance in a top-down fashion.

Table of Contents


Command-line usage:
      hpcviewer [options] [hpctoolkit-database]

GUI usage:
      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.


An HPCToolkit experiment database produced by hpcprof or hpcprof-mpi.


-h --help
Print a help message.

-jh, --java-heap
Set the JVM maximum heap size for this execution of hpcviewer. The value of size must be in megabytes (M) or gigabytes (G). For example, one can specify a size of 3 gigabytes as either 3076M or 3G.

Detailed Description


hpcviewer supports three principal views of an application's performance data. Each view reports both inclusive costs (including callees) and exclusive costs (excluding callees).


The browser window is split into three panes:

Thread-Centric Graphs

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.


hpcviewer provides five main menus:


This menu includes several menu items for controlling basic viewer operations.


This menu only contains one submenu:


This menu is only visible if at least one database is loaded. All actions in this menu are intended primarily for tool developer use. By default, the menu is hidden. Once you open a database, the menu is then shown.


This menu contains only one submenu to reset the position of the views to the original default position. Since hpcviewer is built on top of Eclipse, sometimes Eclipse fails to reposition its views due to its bugs. A work-around to fix this issue is an ongoing work.


This menu displays information about the viewer. The menu contains two items:

See Also

hpctoolkit(1) .


Version: 2020.08-develop

License and Copyright

© 2002-2020, Rice University.
See README.License.


Rice University's HPCToolkit Research Group
Email: hpctoolkit-forum =at= rice.edu
WWW: http://hpctoolkit.org.