README.md

py-rapl: a very simple library to sample RAPL counters via powercap/sysfs interface

Introduction

py-rapl is a very simple library that supports sampling the RAPL, or Running Average Power Limit energy counters that are provided by most, if not all modern Intel CPUs.

Usage

import rapl

s1 = rapl.RAPLMonitor.sample()
# Some work that you want to measure.
s2 = rapl.RAPLMonitor.sample()

# Take the difference of the samples
diff = s2 - s1

# Print the difference in microjoules
print(diff.energy("package-0", "core", rapl.UJOULES))

# Print the average power
print(diff.average_power("package-0", "core"))