In order to use Cray Apprentice2, the following module must be loaded:

module load apprentice2

The tool is then started with the command

app2

or ( Apprentice data format file has filename extension .ap2 )

app2 data_file.ap2

or

app2 exp_dir

An execution of instrumented version of your program creates also the Apprentice data format file. If this is not the case, one can use pat_report to convert the native format of CrayPat, e.g.:

pat_report -f ap2 myprogram+pat+123td.xf

Apprentice2 can produce a number of very informative plots of performance data. They help the user to pinpoint problems in load balance, MPI overhead, I/O strategy and so on.

As an example, we consider the traffic report, in which the program execution for each MPI task is displayed as a time line and the MPI communication between the tasks is indicated by lines between the task time lines. To produce the necessary information for this specify

setenv PAT_RT_SUMMARY 0

before running the experiment. 

The detailed use of Cray Apprentice2 is described in Section 6 of http://docs.cray.com/books/S-2376-41/S-2376-41.pdf