hpcviewer:
Interactive Presentation of Performance

The HPCToolkit Performance Tools

2018/10/26

Version develop

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.

Menus

hpcviewer provides five main menus:

File

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

Filter

This menu only contains one submenu:

View

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.

Window

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.

Help

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

See Also

hpctoolkit(1) .

Version

Version: develop

License and Copyright

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

Authors

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