xref: /petsc/doc/tutorials/performance/guide_to_TAS.md (revision 3f02e49b19195914bf17f317a25cb39636853415)
1# Time, Accuracy, Speed Analysis (TAS)
2
3```{highlight} none
4```
5
6Below is the guide to running TAS using ex13, which is a Poisson Problem in 2D and 3D with Finite Elements:
7
81. Compile `ex13.c`
9
10> 1. This example source file, and the corresponding `makefile` are located in `PETSC_DIR/src/snes/tutorials/`
11>
12> 2. Compile with the command:
13>
14>    > ```console
15>    > $ make ex13
16>    > ```
17
182. Run ex13 with the following command:
19
20   ```
21   mpiexec -n 2 ./ex13 -log_view :/home/<user name>/PETSC_DIR/lib/petsc/bin/ex_13_test.py:ascii_info_detail \
22     -dm_distribute \
23     -dm_plex_box_faces 8,8 \
24     -potential_petscspace_degree 1 \
25     -snes_convergence_estimate \
26     -convest_num_refine 5
27   ```
28
293. A log file in the above directory called `ex_13_test.py` should now be present. This is also the same directory that contains the TAS python3 script `petsc_tas_analysis.py`
30
314. Now run `petsc_tas_analysis.py`:
32
33   ```
34   ./petsc_tas_analysis.py -f ex_13_test
35   ```
36
375. You should see something similar to the following in your terminal window:
38
39   > ```{literalinclude} exampleTASOutPut.txt
40   > ```
41
426. Finally the graphs will appear in the subdirectory `graphs/`
43
44For more detailed help in using TAS:
45: 1. See detailed user's guide
46  2. On the command line use `./petsc_tas_analysis.py -h`
47