Documentation.md

@@ -323,3 +323,50 @@ NB: if you want to install TAU on your local machine only to have tools such as
 ### Tracing using TAU
 
 TAU can be used to trace programs by setting the `TAU_TRACE` environment variable to 1.
+
+```
+TAU_TRACE=1 STARPU_NCPUS=8 tau_exec -T starpu,serial ./mult
+```
+
+It produces another type of files:
+- an event file: `events.0.edf`
+- a set of trace files: `tautrace.0.<process>.<thread>.trc`
+
+They can be merged with `tau_treemerge.pl`:
+```
+coti@voltar:~/x86/tau2/examples/starpu$ tau_treemerge.pl 
+/storage/users/coti/x86/tau2/x86_64/bin/tau_merge -m tau.edf -e events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf events.0.edf tautrace.0.0.0.trc tautrace.0.0.1.trc tautrace.0.0.10.trc tautrace.0.0.11.trc tautrace.0.0.12.trc tautrace.0.0.13.trc tautrace.0.0.14.trc tautrace.0.0.15.trc tautrace.0.0.2.trc tautrace.0.0.3.trc tautrace.0.0.4.trc tautrace.0.0.5.trc tautrace.0.0.6.trc tautrace.0.0.7.trc tautrace.0.0.8.trc tautrace.0.0.9.trc tau.trc
+tautrace.0.0.0.trc: 274 records read.
+tautrace.0.0.1.trc: 8 records read.
+tautrace.0.0.10.trc: 28 records read.
+tautrace.0.0.11.trc: 28 records read.
+tautrace.0.0.12.trc: 28 records read.
+tautrace.0.0.13.trc: 8 records read.
+tautrace.0.0.14.trc: 8 records read.
+tautrace.0.0.15.trc: 8 records read.
+tautrace.0.0.2.trc: 12 records read.
+tautrace.0.0.3.trc: 12 records read.
+tautrace.0.0.4.trc: 12 records read.
+tautrace.0.0.5.trc: 28 records read.
+tautrace.0.0.6.trc: 28 records read.
+tautrace.0.0.7.trc: 28 records read.
+tautrace.0.0.8.trc: 28 records read.
+tautrace.0.0.9.trc: 28 records read.
+```
+
+This command produces two files:
+- `tau.edf`
+- `tau.trc`
+
+These files need to be converted into a format that can be handled by your visualizer. 
+
+### Visualization using Jumpshot
+
+Jumpshot is available and documented [here](https://www.mcs.anl.gov/research/projects/perfvis/software/viewers/index.htm), and is distributed with TAU. You can find it in the `bin` directory of your installation.
+
+Jumpshot takes slog2 traces. They can be obtained from the TAU traces using a converting tool provided with TAU:
+```
+tau2slog2 tau.trc tau.edf -o starpu_mult.slog2
+jumpshot starpu_mult.slog2
+```
+![starpu_jumpshot](uploads/494d6ab5ef29f16da2ce751f7dec4a83/starpu_jumpshot.png)