TAU installations at NSC


Level of support

Tier 1 NSC has at least one application expert on staff with knowledge about this software, and we will try to help you with any problems. We have also ran some internal tests to make sure that the program is working as intended. NSC also commits to installing updates to this program as they become available.

Please see the page describing our software support categories for more information.
You can also contact support@nsc.liu.se for further information.

TAU (Tuning and Analysis Utilities) is a portable profiling and tracing toolkit for performance analysis of parallel programs written in Fortran, C++, C, Java and Python. TAU installation at NSC is PAPI enabled. It also provides the graphical analysis tools, e.g., paraprof and jumpshot.

Please contact NSC Support if you have any questions or problems.

How to run

Load the module corresponding to the version you want, e.g

 module load tau/2.21.4

This will set the path for TAU executables and scripts and the paths for default native compilers and mpi to be used by TAU compiler.

Compilation of program: Use the TAU compiler wrappers, tau_cc.sh, tau_f90.sh etc. for compiling programs, e.g., to compile a FORTRAN program test.f90 use

 tau_f90.sh test.f90

This will compile / link both serial as well as MPI programs. The TAU compiler wrapper will use the native compiler internally.

TAU compiler has many options which is chosen based on type of profiling. We will recommend to use the following two options

 -optPreProcess 
 -optTauSelectFile=selectFile

where selectFile is a file containing selective instrumentation instructions. An example of selective instrumentation file is given below:

### start of file ###

BEGIN_INSTRUMENT_SECTION
#loops routine="#"
#static phase name="phase1" file="davidson.*" line=351 to line=368
END_INSTRUMENT_SECTION

BEGIN_FILE_EXCLUDE_LIST
diolib.*
END_FILE_EXCLUDE_LIST

### end of file ##############

In this example all the files are instrumented except diolib.f

Running of program: The binary can be launched with mpprun command. A typical runscript is given below:

### start runscript ##############

#!/bin/sh
#SBATCH -A ACNAME
#SBATCH -t 20
#SBATCH -N 1 

### set the below variables as needed ####
export TAU_VERBOSE=0
export TAU_PROFILE=1
export TAU_COMM_MATRIX=1
export TAU_CALLPATH=0
export TAU_CALLPATH_DEPTH=3
export TAU_TRACE=0
export PROFILEDIR=PATH_TO_PROFILE_DIR
export TRACEDIR=PATH_TO_TRACE_DIR

mpprun ./app_tau

### end runscript ##################

Please refer to the full documentation of Tau for more details.