Skip to content

Commit df0d1d4

Browse files
committed
README explanations for the new plugins
1 parent b7fecd9 commit df0d1d4

File tree

2 files changed

+29
-8
lines changed

2 files changed

+29
-8
lines changed

examples/nvml-profiling/README.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,32 @@
11

2-
# Hello World
2+
# `Nvidia Management Library` profiling
33

4-
A simple example that just prints on each event. This examples serves as an equivalent of a "Hello World" program.
4+
This profiler is a convenience wrapper for the [Nvidia Management Library python library](https://pypi.org/project/nvidia-ml-py/), which is intended for monitoring an managing GPU states. It is also the underlying interface for the nvidia-smi tool. This plugin is intended to make using this library more streamlined, and tries to do much of the heavy lifting for collecting data from the different sources provided by NVML.
5+
6+
Please refer to the documentation for more information on what metrics are provided.
7+
8+
Primarily we support:
9+
- [Some device queries](https://docs.nvidia.com/deploy/nvml-api/group__nvmlDeviceQueries.html#group__nvmlDeviceQueries)
10+
- [Some device commands](https://docs.nvidia.com/deploy/nvml-api/group__nvmlDeviceCommands.html#group__nvmlDeviceCommands)
11+
- [Field value queries](https://docs.nvidia.com/deploy/nvml-api/group__nvmlFieldValueQueries.html#group__nvmlFieldValueQueries)
12+
- [Sampling queries](https://docs.nvidia.com/deploy/nvml-api/group__nvmlDeviceStructs.html#group__nvmlDeviceStructs_1gcef9440588e5d249cded88ce3efcc6b5)
13+
14+
## Requirements
15+
16+
[A compatible Nvidia GPU](https://docs.nvidia.com/deploy/nvml-api/nvml-api-reference.html#nvml-api-reference). Keep in mind that NVML supports many different generations and types of GPUs. As such many features may or may not be available depending on which GPU you have.
17+
18+
The NVML library, installed as part of the GPU driver on Windows / Linux.
19+
20+
The [Nvidia Management Library python library](https://pypi.org/project/nvidia-ml-py/).
521

622
## Running
723

824
From the root directory of the repo, run the following command:
925

1026
```bash
11-
python experiment-runner/ examples/hello-world/RunnerConfig.py
27+
python experiment-runner/ examples/nvml-profiling/RunnerConfig.py
1228
```
1329

1430
## Results
1531

16-
The results are generated in the `examples/hello-world/experiments` folder.
32+
The results are generated in the `examples/nvml-profiling/experiments` folder, in json format.
Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,21 @@
11

2-
# Hello World
2+
# `PowerLetrics` profiler
33

4-
A simple example that just prints on each event. This examples serves as an equivalent of a "Hello World" program.
4+
This plugin servers as a ease of use wrapper for the Linux cli tool [powerletrics](https://github.com/green-kernel/powerletrics), that is modeled after
5+
the OSX powermetrics utility.
6+
7+
## Requirements
8+
9+
[powerletrics](https://github.com/green-kernel/powerletrics) is assumed to be already installed.
510

611
## Running
712

813
From the root directory of the repo, run the following command:
914

1015
```bash
11-
python experiment-runner/ examples/hello-world/RunnerConfig.py
16+
python experiment-runner/ examples/powerletrics-profiling/RunnerConfig.py
1217
```
1318

1419
## Results
1520

16-
The results are generated in the `examples/hello-world/experiments` folder.
21+
The results are generated in the `examples/powerletrics-profiling/experiments` folder.

0 commit comments

Comments
 (0)