unimore/hpc-2022-g3
unimore/hpc-2022-g3
1
Fork 0
mirror of https://github.com/Steffo99/unimore-hpc-assignments.git synced 2024-11-22 16:14:24 +00:00
Code Activity

Update CONTRIBUTING with the bench target

Browse source
This commit is contained in:
Steffo 2022-11-16 17:44:49 +01:00
parent e23d565fd2
commit cc23d73254
Signed by: steffo
GPG key ID: 6965406171929D01
1 changed files with 5 additions and 50 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

55
CONTRIBUTING.md
View file

@ -18,61 +18,16 @@ Per compilare il codice a noi assegnato, è necessario:
## Come debuggare e profilare
Ho configurato [CLion](https://www.jetbrains.com/clion/) con le istruzioni necessarie al debug e il profiling del programma.
Ho configurato il [Makefile](OpenMP/linear-algebra/kernels/atax/Makefile) con un phony target che esegue il programma 9 volte e calcola il tempo di esecuzione medio:
> (Essendo studenti dell'Unimore, abbiamo diritto a una licenza gratuita, che potete ottenere attraverso il [GitHub Student Pack](https://education.github.com/pack).)
### Debug
Per effettuare il debug del codice, è necessario selezionare la runConfiguration `atax_acc` e cliccare il pulsante "Debug" con l'insetto verde:
![La posizione del tasto "Debug" nell'interfaccia di CLion.](.media/debug.png)
### Profiling locale
Per effettuare il profiling del codice, è necessario selezionare la runConfiguration `atax_acc` e cliccare il pulsante "Profile" con l'orologio e il play verde:
![La posizione del tasto "Profile" nell'interfaccia di CLion.](.media/profile.png)
Di default, CLion è configurato per usare `perf` per profilare: è quindi necessario che sia installato e configurato sul vostro sistema!
### Profiling remoto
Per effettuare il profiling remoto, è necessario:
1. Accedere ad un Nano fornito da Unimore:
```console
$ # Per istruzioni complete, usa le informazioni fornite nelle dispense o nella chat Matrix del corso!
$ ssh hpc-nano9
```
2. Clonare o aggiornare questo repository:
* Clonare il repository da zero:
```console
$ git clone https://github.com/Steffo99/unimore-hpc-1.git
$ cd ./unimore-hpc-1
```
* Aggiornare un repository già esistente:
```console
$ cd ./unimore-hpc-1
$ git pull
```
3. Accedere alla cartella in cui è contenuta l'applicazione assegnata:
1. Accedere alla cartella in cui è contenuto:
```console
$ cd ./OpenMP/linear-algebra/kernels/atax
```
4. Eseguire il Makefile:
2. Eseguire il Makefile:
```console
$ make clean all
$ make bench
```
5. Abilitare `perf`:
```console
$ module load perf/1.0
```
6. <!-- TODO -->
> Nota: funziona solo su sistemi UNIX-like!