Skip to content
Snippets Groups Projects
Commit 73045e2a authored by Bert Wesarg's avatar Bert Wesarg :keyboard:
Browse files

Update doc.zih.tu-dresden.de/docs/software/score_p.md

parent efc841eb
No related branches found
No related tags found
3 merge requests!322Merge preview into main,!319Merge preview into main,!203Update docs/software/score_p.md
...@@ -2,28 +2,28 @@ ...@@ -2,28 +2,28 @@
The Score-P measurement infrastructure is a highly scalable and easy-to-use tool suite for The Score-P measurement infrastructure is a highly scalable and easy-to-use tool suite for
profiling, event tracing, and online analysis of HPC applications. Currently, it works with the profiling, event tracing, and online analysis of HPC applications. Currently, it works with the
analysis tools Vampir, Scalasca, Periscope, and Tau. Score-P supports lots of features e.g. analysis tools Vampir, Scalasca, and Tau. Score-P supports lots of features e.g.
* MPI, SHMEM, OpenMP, pthreads, and hybrid programs * MPI, SHMEM, OpenMP, Pthreads, and hybrid programs
* Manual source code instrumentation * Manual source code instrumentation
* Monitoring of CUDA applications * Monitoring of CUDA, OpenCL, and OpenACC applications
* Recording hardware counter by using PAPI library * Recording hardware counter by using PAPI library
* Function filtering and grouping * Function filtering and grouping
Only the basic usage is shown in this Wiki. For a comprehensive Score-P user manual refer to the Only the basic usage is shown in this Wiki. For a comprehensive Score-P user manual refer to the
[Score-P website](https://www.vi-hps.org/projects/score-p/). [Score-P website](https://score-p.org/).
Before using Score-P, set up the correct environment with Before using Score-P, set up the correct environment with
```Bash ```Bash
module load scorep module load Score-P
``` ```
To make measurements with Score-P, the user's application program needs to be instrumented, i.e., at To make measurements with Score-P, the user's application program needs to be instrumented, i.e., at
specific important points ("events") Score-P measurement calls have to be activated. By default, specific important points ("events") Score-P measurement calls have to be activated. By default,
Score-P handles this automatically. In order to enable instrumentation of function calls, MPI as Score-P handles this automatically. In order to enable instrumentation of function calls, MPI as
well as OpenMP events, the user only needs to prepend the Score-P wrapper to the usual compiler and well as OpenMP events, the user only needs to prepend the Score-P wrapper to the usual compile and
linker commands. The following sections show some examples depending on the parallelization type of link commands. The following sections show some examples depending on the parallelization type of
the program. the program.
## Serial Programs ## Serial Programs
...@@ -41,13 +41,13 @@ automatically: ...@@ -41,13 +41,13 @@ automatically:
* original: `mpicc hello.c -o hello` * original: `mpicc hello.c -o hello`
* with instrumentation: `scorep mpicc hello.c -o hello` * with instrumentation: `scorep mpicc hello.c -o hello`
MPI implementations without own compilers (as on the Altix) require the user to link the MPI library MPI implementations without own compilers require the user to link the MPI library
manually. Even in this case, Score-P will detect MPI parallelization automatically: manually. Even in this case, Score-P will detect MPI parallelization automatically:
* original: `icc hello.c -o hello -lmpi` * original: `icc hello.c -o hello -lmpi`
* with instrumentation: `scorep icc hello.c -o hello -lmpi` * with instrumentation: `scorep icc hello.c -o hello -lmpi`
However, if Score-P falis to detect MPI parallelization automatically you can manually select MPI However, if Score-P fails to detect MPI parallelization automatically you can manually select MPI
instrumentation: instrumentation:
* original: `icc hello.c -o hello -lmpi` * original: `icc hello.c -o hello -lmpi`
...@@ -90,16 +90,16 @@ After the application run, you will find an experiment directory in your current ...@@ -90,16 +90,16 @@ After the application run, you will find an experiment directory in your current
which contains all recorded data. In general, you can record a profile and/or a event trace. which contains all recorded data. In general, you can record a profile and/or a event trace.
Whether a profile and/or a trace is recorded, is specified by the environment variables Whether a profile and/or a trace is recorded, is specified by the environment variables
`SCOREP_ENABLE_PROFILING` and `SCOREP_ENABLE_TRACING` (see `SCOREP_ENABLE_PROFILING` and `SCOREP_ENABLE_TRACING` (see
[documentation](https://perftools.pages.jsc.fz-juelich.de/cicd/scorep/tags/scorep-7.0/html/measurement.html)). [documentation](https://perftools.pages.jsc.fz-juelich.de/cicd/scorep/tags/latest/html/measurement.html)).
If the value of this variables is zero or false, profiling/tracing is disabled. Otherwise Score-P If the value of this variables is zero or false, profiling/tracing is disabled. Otherwise Score-P
will record a profile and/or trace. By default, profiling is enabled and tracing is disabled. For will record a profile and/or trace. By default, profiling is enabled and tracing is disabled. For
more information please see more information please see
[the list of Score-P measurement configuration variables] [the list of Score-P measurement configuration variables]
(https://perftools.pages.jsc.fz-juelich.de/cicd/scorep/tags/scorep-7.0/html/scorepmeasurementconfig.html) (https://perftools.pages.jsc.fz-juelich.de/cicd/scorep/tags/latest/html/scorepmeasurementconfig.html)
You may start with a profiling run, because of its lower space requirements. According to profiling You may start with a profiling run, because of its lower space requirements. According to profiling
results, you may configure the trace buffer limits, filtering or selective recording for recording results, you may configure the trace buffer limits, filtering or selective recording for recording
traces. Score-P allows to configure several parameters via environment variables. After the traces. Score-P allows to configure several parameters via environment variables. After the
measurement run you can find a scorep.cfg file in your experiment directory which contains the measurement run you can find a `scorep.cfg` file in your experiment directory which contains the
configuration of the measurement run. If you had not set configuration values explicitly, the file configuration of the measurement run. If you had not set configuration values explicitly, the file
will contain the default values. will contain the default values.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment