Interactive Presentation of Performance

The HPCToolkit Performance Tools


Version 2017.11

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.


Send log entries to a console in addition to a log file.

Log additional information about plugin dependency problems.

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.

See Also

hpctoolkit(1) .


Version: 2017.11

License and Copyright

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


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