hpcviewer:
Interactive Presentation of Performance

The HPCToolkit Performance Tools

2018/07/13

Version 2017.11

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

Table of Contents

Synopsis

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

GUI usage:
      Launch hpcviewer and open the experiment database [hpctoolkit-database].

Description

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.

Arguments

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

Options

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

-debug
Log additional information about plugin dependency problems.

Detailed Description

Views

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

Panes

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

Version: 2017.11

License and Copyright

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

Authors

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