Metadata-Version: 2.1
Name: smartwatts
Version: 2.0.0
Summary: SmartWatts is a formula for a self-adaptive software-defined power meter based on the PowerAPI framework.
Home-page: UNKNOWN
Author: Guillaume Fieni
License: BSD 3-Clause License
Keywords: energy,powerapi,containers,performance counters,power meter
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.8
License-File: LICENSE

SmartWatts is a software-defined power meter based on the PowerAPI toolkit.
SmartWatts is a configurable software that can estimate the power consumption of
software in real-time.
SmartWatts need to receive several metrics provided by
[hwpc-sensor](https://github.com/powerapi-ng/hwpc-sensor) :

- The Running Average Power Limit (RAPL)
- TSC
- APERF
- MPERF
- CPU_CLK_THREAD_UNHALTED:REF_P
- CPU_CLK_THREAD_UNHALTED:THREAD_P
- LLC_MISSES
- INSTRUCTIONS_RETIRED

The reasons of those metrics are described in [SmartWatts: Self-Calibrating
Software-Defined Power Meter for Containers](https://hal.inria.fr/hal-02470128)

# About

SmartWatts is an open-source project developed by the [Spirals research
group](https://team.inria.fr/spirals) (University of Lille 1 and Inria).

The documentation is available [here](http://powerapi.org).

## Contributing

If you would like to contribute code you can do so through GitHub by forking the
repository and sending a pull request.
You should start by reading the [contribution guide](https://github.com/powerapi-ng/smartwatts-formula/blob/master/contributing.md)

When submitting code, please check that it is conform by using `pylint` and
`flake8` with the configurations files at the root of the project.

## Publications

- **[SmartWatts: Self-Calibrating Software-Defined Power Meter for Containers](https://hal.inria.fr/hal-02470128)**: G. Fieni, R. Rouvoy, L. Seinturier. _IEEE/ACM International Symposium on Cluster, Cloud and Grid Computing (CCGrid). May 2020, Melbourne, Australia

## Acknowledgments

SmartWatts is written in [Python](https://www.python.org/) (under [PSF
license](https://docs.python.org/3/license.html)) and built on top of
[PowerAPI](https://github.com/powerapi-ng/powerapi)


