Skip to content

Commit 7d4fabf

Browse files
author
cerlane
committed
feedback from Andreas and some minor sentencing updatess
1 parent aeb82dc commit 7d4fabf

File tree

2 files changed

+56
-3
lines changed

2 files changed

+56
-3
lines changed

docs/software/gssr/containers.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ To invoke `gssr`, you can do the following in your sbatch file.
7777
#SBATCH -t 1:00:00
7878
#SBATCH ...
7979
80-
srun --environment=mycontainer bash -c 'gssr --wrap="python mycode.py"'
80+
srun --environment=mycontainer bash -c 'gssr --wrap="python abc.py"'
8181
8282
```
8383

@@ -88,7 +88,7 @@ The `bash -c` requirement is to initialise the bash environment within your cont
8888
If no `gssr` is used, the `srun` command in your container should like that.:
8989

9090
```
91-
srun --environment=mycontainer bash -c 'python mycode.py'.
91+
srun --environment=mycontainer bash -c 'python abc.py'.
9292
```
9393

9494
Now you are ready to submit your sbatch file to slurm with `sbatch` command.

docs/software/gssr/quickstart.md

Lines changed: 54 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,54 @@
1-
### From PyPi
1+
[](){#ref-gssr-quickstart}
2+
# gssr - Quickstart Guide
3+
4+
## Installation
5+
6+
### From Pypi
7+
8+
`gssr` can be easily installed as follows.:
9+
10+
pip install gssr
11+
12+
### From GitHub Source
13+
14+
To install directly from the source:
15+
16+
pip install git+https://github.com/eth-cscs/GPU-saturation-scorer.git
17+
18+
To install from a specific branch, e.g. the development branch, from the source:
19+
20+
pip install git+https://github.com/eth-cscs/GPU-saturation-scorer.git@dev
21+
22+
To install a specific release tag, e.g. gssr-v0.3, from the source:
23+
24+
pip install git+https://github.com/eth-cscs/[email protected]
25+
26+
## Profile
27+
28+
### Example
29+
30+
If you are submitting a batch job and the command you are executing is:
31+
32+
srun python abc.py
33+
34+
The corresponding srun command should be modified as follows.:
35+
36+
srun gssr profile -wrap="python abc.py"
37+
38+
* The `gssr` option to run is `profile`
39+
* The `"--wrap"` flag will wrap the command that you would like to run
40+
* The default output directory is `profile_out_{slurm_job_id}`
41+
* A label to the output data can be set with the `-l` flag
42+
43+
## Analyze
44+
45+
### Metric Output
46+
The profiled output can be analysed as follows.:
47+
48+
gssr analyze -i ./profile_out
49+
50+
### PDF File Output with Plots
51+
52+
gssr analyze -i ./profile_out --report
53+
54+
A/Multiple PDF report(s) will be generated.

0 commit comments

Comments
 (0)