Jumpshots

Graphical Visualization Tools for Parallel Programs

Description

Jumpshots are graphical tools for understanding the performance of parallel programs. They are evolved from upshot and are written in Java. There are 2 versions of Jumpshots, Jumpshot-2 and Jumpshot-3, distributed with MPE. Jumpshot-2 interprets CLOG tracefiles and Jumpshot-3 interprets SLOG tracefiles which is capable of handle big tracefiles (in GB range).

Configuring & Building Jumpshots

Since Jumpshots are distributed with MPE, the top level MPE configure will configure both version of Jumpshots by default. Through the use of configure option --with-java=<JDK> in MPE configure, user can supply a user installed java installation to MPE to build both version of Jumpshots. Even though Jumpshot-3 can be built by both JDK 1.1 and JDK 1.2, Jumpshot-2 can only be built with JDK 1.1. Because of this limitation, user is advised to use JDK 1.1 when building Jumpshots for MPE. However user can build Jumpshot-2 and Jumpshot-3 separately from MPE with different versions of JDK. If user chooses to do that, be sure to install them back to the final install directory share/, otherwise the logviewer script won't work properly. A list of configure options is available by typing ./configure --help in the top-level jumpshot-2 and jumpshot-3 directories.

For detailed information on building Jumpshot-2, refer to the README in the top-level jumpshot-2 source directory at mpe/viewers/jumpshot-2.

For details information on building Jumpshot-3, refer to the README and UserGuide.txt in the top-level jumpshot-3 directory at mpe/viewers/jumpshot-3.

Usage

Both versions of Jumpshots are installed in the final install directory, share/. End-users are not expected to call jumpshots directly, instead there is a display program selector script called logviewer located in bin/. This script will select the appropriate viewer based on the logfile's file extension, ie. log file format. For more information about logviewer, do "logviewer -help".

For more details on the button definitions in Jumpshot-2, click the help button on Jumpshot-2's main window to bring up the ASCII version of button definitions.

For Jumpshot-3, besides the ASCII version of button definitions available by clicking in the main window's help -> Manual buttons, there is also a HTML viewer which displays a step-by-step tour of Jumpshot-3 of how and what user can learn from a typical logfile. The HTML tour can be invoked by clicking the main window's help->Tour buttons. New users of Jumpshots are advised to read the Tour document.

Additional Information

Jumpshot-3 is written based on Jumpshot-2 but contains many enhanced new features not found in Jumpshot-2, and also contains a lot more graphic bugs fixed. So users are advised to use Jumpshot-3 whenever possible.

Location:/home/MPI/mansrc/jumpshot