TAU Commander

TAU Commander is a user interface for the TAU Performance System, a set of tools for analyizing the performance of parallel programs. 

Availability and Restrictions

TAU Commander is available on the Owens Cluster. The versions currently available at OSC are:

VERSION OWENS
1.2.1 X*
* Current Default Version

You can use  module spider taucmdr to view available modules for a given machine. Feel free to contact OSC Help if you need other versions for your work.

Access

TAU Commander is available without restriction to all OSC users.

Usage

Usage on Owens

Set-up

To configure your enviorment for use of TAU Commander, use command  module load taucmdr . This will load the default version.

Creating a project

The first step to use TAU Commander on your code is to create and configure a project. To create a project, use the command tau initalize. Additional options for compilers, MPI libraries, measurements. etc. are available.

For instance, to configure for Intel compilers use the command tau initialize --compilers Intel and to configure for MPI use tau initialize --mpi.

For more details about how to initialize your project use the command tau help initialize.

After running creating the project you should see a dashboard for your project with a target, application, and 3 default measurements. You can now create additional measurements or modify the application and target. See the TAU Commander user guide for more information about how to configure your project.

Compiling and Running your Code

To compile your code to run with TAU Commander, just add tau before the compiler. For instance, if you are compiling with gcc now compile with tau gcc. Similarly, when you run your code add tau before the run command. So, if you usually run with mpiexec -ppn 4 ./my_prog now run with tau mpiexec -ppn 4 ./my_prog. Each time the program is run with tau prepended, a new trial is created in the project with performance data for that run.

Post-processing

Once you have generated performance data with TAU Commander you have 3 options to view the trial performance data:
  1. view the data in text format (not always available),
  2. view the data in a GUI using an OnDemand VDI (Virtual Desktop Interface) or X11 forwarding enabled,
  3. or export the data to your local machine (requires minimal installation of TAU commander on your local machine).
To view the data:
tau trial show trial_number

To export the data:

tau trial export trial_number

Further Reading