Metadata-Version: 2.1
Name: HeliosGPUController
Version: 2.0.1
Summary: Helios GPU Controller dynamically reduces Graphics Processing Unit (GPU) clock speeds by leveraging insights from the current energy mix and meteorological data. Data is obtained by the SMARD API and Forecast.Solar. The goal is to reduce power consumption of non-renewable sources.
Author-email: Lasse Mueller <mueller.lasse.ltd@gmail.com>, Bao Nguyen <baotrani@yahoo.de>, Berkehan Unal <unal@tnt.uni-hannover.de>
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML~=6.0.1
Requires-Dist: requests~=2.31.0
Requires-Dist: geocoder~=1.38.1
Requires-Dist: pytz~=2023.3.post1
Requires-Dist: numpy~=1.26.2
Requires-Dist: matplotlib~=3.8.2
Requires-Dist: timezonefinder~=6.4.0
Requires-Dist: suntime~=1.2.5
Requires-Dist: geopy~=2.4.1

# Helios version: 2.0


This is the code for the Helios GPU Controller

Developers:

Lasse Müller, Bao Tran Nguyen, Berkehan Ünal

## Usage
### Requirements
Our solution was developed using Python. To run the software, these are the prerequisites:
* Operating system distribution of Windows or Linux
* Python >=3.8
* Preferably a virtual environment

### Installation of Software and Dependencies
A development copy of the project's repository or software can be created using the following command.
```
$ git clone https://github.com/automl-private/MLProject_Mueller-Nguyen-Uenal_Helios
```

To include the package into a virtual environment directly, consider installing with:
```
$ pip install HeliosGPUController

Include in the code: from helios_gpu_controller.HeliosGPUController import HeliosGPUController
```

## Config File ##
An example config file can be found in src/helios_gpu_controller/conf.yaml
These are the configuration parameters

* use_helios_on_init: If set to false, GPU throttling won't be enabled by instantiating HeliosGPUController, but only with calling throttle_gpu() method
* devices: List of all devices that the HeliosGPUController has access to
* min_clock_speed_percent: minimum GPU clock frequency in percent. Helios recommendation: 0.5. Going higher than 0.5 reduces Helios' effectiveness.
* update_rate: Update Rate in minutes. The update rate determines, how often the GPU clock frequency is updated.
* using_solar_panels: Enable Helios solar
* avg_power_consumption_per_year: Average power consumption of your household. In kWh
* max_power_of_home_pc: Maximum power consumption of your computer. In Watts
* declination: Declination of your solar panels
* azimuth: Azimuth of your solar panels. 0 - south, 90 - west, 180 - north, 270 - east
* peak_kw: Peak Output of your photovoltaic system
* need_user_permission: if set to true, prompt a permission window, before Helios reduces your GPU frequency

## Code Execution ##
Helios GPU controller runs in a subprocess and does not interfere with the main program loop. When use_helios_on_init is set to True, the Controller is executed automatically on init.
To run Helios, use the following code snippets:

When use_helios_on_init is set to True:
```
Execute: gpu_controller = HeliosGPUController("conf.yaml")
After the program finishes: gpu_controller.stop_helios()
```

When use_helios_on_init is set to False:
```
Execute: gpu_controller = HeliosGPUController("conf.yaml")
To throttle GPU manually: gpu_controller.throttle_gpu()
After the program finishes: gpu_controller.stop_helios()
```

## License ##

This project is licensed under the [MIT License](./LICENSE).

```
 _   _         _                       ___    ___    _   _     ___                  _                _    _                
( ) ( )       (_ )  _                 (  _`\ (  _`\ ( ) ( )   (  _`\               ( )_             (_ ) (_ )              
| |_| |   __   | | (_)   _     ___    | ( (_)| |_) )| | | |   | ( (_)   _     ___  | ,_) _ __   _    | |  | |    __   _ __ 
|  _  | /'__`\ | | | | /'_`\ /',__)   | |___ | ,__/'| | | |   | |  _  /'_`\ /' _ `\| |  ( '__)/'_`\  | |  | |  /'__`\( '__)
| | | |(  ___/ | | | |( (_) )\__, \   | (_, )| |    | (_) |   | (_( )( (_) )| ( ) || |_ | |  ( (_) ) | |  | | (  ___/| |   
(_) (_)`\____)(___)(_)`\___/'(____/   (____/'(_)    (_____)   (____/'`\___/'(_) (_)`\__)(_)  `\___/'(___)(___)`\____)(_)                                                                                                                                                                                                                                                
```
