Example: MPI only

We first select the experiment for profiling a MPI-only version mm via sampling.

tau_select_mpi-sample
At this point, Tau Commander will begin to create the corresponding TAU and any other dependent libraries to accomplish this experiment. Below is the "tau dash
after we have selected "mm_mpi-sample".
tau_dash_after_sample_select

We now build the mm_mpi application with no need for instrumentation because we are relying on sampling to make our mpi and execution measurements.   The included Makefile.intel shows that the compiler invocation "mpicc" is now replaced with "tau mpicc". make-sample

We run the example inside an interactive que idev.  At this point we have only created experiments but not trials which constitute running the application and collecting results.
We see how to create a trial (ie. run the experiment) by using the help command.

trial create help

We use the "--launcher" command because Stampede and TACC systems use "ibrun" to launch MPI applications.  We run our trial on 7 MPI ranks with an offset of zero cores.tau_trial_create-run-sample

At this point, the profiles produced by TAU are stored in a particular ".tau" directory mostly hidden from the user to avoid confusion.  To see what trials have been created during this experiment we use "tau trial list".

trial_list-sample

This number zero trial uses "C" like enumeration.  We can view the results both graphically or via a text display.  All results are viewed via "tau trial show .... ". We use the "--profile-tool" argument to use TAU's "pprof" to give a text representation of profile information.

tria-show-profile-tools

Below we use "tau trial show" which defaults to using TAU's paraprof.  This requires an X windows connection or Virtual Desktop connection.  The Paraprof results shows 7 ranks with color-coding for different sampled sections.  Note that sampling using binutils and libunwind can give line number ranges associated with sampled measured sections.

trial_show-sample

To change experiments, we invoke: "$tau exp select mm_mpi-inst". This selects the experiment which use  PDT to instrument source code to provide hooks for measurements.  Below we how to build for our example.  Note that the command looks the same as the previous experiment, but the result his different because of the experiment selected.

make-inst

We now see multiple TAUs built to satisfy the already "selected" experiments.tau_select-inst

We now can invoke the run command via trial create.  Note the executable name is the same, but this executable has been recompiled to have instrumentation.

trial_create-inst

We again use "tau trial show" to see results where we have 3 MPI ranks.  The profiles now shows measurements by function and not line regions within a function. trial-show-inst

Below we show how you can access different trials associated with different experiments.
Note: "tau select <experiment name>" is the short hand.

trial-list-exp