# 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