juham-automation 0.0.16__tar.gz → 0.0.17__tar.gz

{juham_automation-0.0.16/juham_automation.egg-info → juham_automation-0.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: juham-automation
-Version: 0.0.16
+Version: 0.0.17
 Summary: Juha's Ultimate Home Automation Masterpiece
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>

{juham_automation-0.0.16 → juham_automation-0.0.17}/juham_automation/automation/hotwateroptimizer.py

@@ -16,13 +16,17 @@ from juham_core.timeutils import (
 
 class HotWaterOptimizer(Juham):
     """Automation class for optimized control of temperature driven home energy consumers e.g hot
-    water radiators. Reads spot prices, electricity forecast and temperatures to minimize electricity bill.
-    Additional control over heating is provided by the following attributes
+    water radiators. Reads spot prices, electricity forecast, power meter and temperatures to minimize electricity bill.
 
-    Computes UOI - optimization utilization index for each hour, based on the spot price and the solar power forecast.
-    Value of 0 means the hour is expensive, value of 1 means the hour is free. The UOI threshold determines the slots
-    that are allowed to be consumed.
+    Represents a heating system that knows the power rating of its radiator (e.g., 3kW).
+    The system subscribes to the 'power' topic to track the current power balance. If the solar panels
+    generate more energy than is being consumed, the optimizer activates a relay to ensure that all excess energy
+    produced within that hour is used for heating. The goal is to achieve a net zero energy balance for each hour,
+    ensuring that any surplus energy from the solar panels is fully utilized.
 
+    Computes also UOI - optimization utilization index for each hour, based on the spot price and the solar power forecast.
+    For negative energy balance this determines when energy is consumed. Value of 0 means the hour is expensive, value of 1 means
+    the hour is free. The UOI threshold determines the slots that are allowed to be consumed.
 
     """
 
@@ -299,6 +303,10 @@ class HotWaterOptimizer(Juham):
             bool: true if production exceeds the consumption
         """
 
+        # if net energy balance is negative, then we are not in balancing mode
+        if self.net_energy_balance < 0:
+            return False
+
         # elapsed and remaining time within the current balancing slot
         elapsed_ts = ts - quantize(self.energy_balancing_interval, ts)
         remaining_ts = self.energy_balancing_interval - elapsed_ts
@@ -316,7 +324,7 @@ class HotWaterOptimizer(Juham):
         needed_energy = 0.5 * self.radiator_power * remaining_ts
         elapsed_interval = ts - self.net_energy_balance_ts
         print(
-            f"Needed energy {needed_energy}Wh, current balance {self.net_energy_balance}Wh"
+            f"Needed energy {int(needed_energy)}Wh, current balance {int(self.net_energy_balance)}Wh"
         )
 
         if (
@@ -349,7 +357,7 @@ class HotWaterOptimizer(Juham):
 
         # check if we have energy to consume, if so return 1
         if self.consider_net_energy_balance(ts):
-            self.warning("Net energy balance positive")
+            self.info("Net energy balance positive")
             return 1
         elif self.net_energy_balancing_mode:
             balancing_slot_start_ts = quantize(self.energy_balancing_interval, ts)

{juham_automation-0.0.16 → juham_automation-0.0.17/juham_automation.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: juham-automation
-Version: 0.0.16
+Version: 0.0.17
 Summary: Juha's Ultimate Home Automation Masterpiece
 Author-email: J Meskanen <juham.api@gmail.com>
 Maintainer-email: "J. Meskanen" <juham.api@gmail.com>

{juham_automation-0.0.16 → juham_automation-0.0.17}/juham_automation.egg-info/SOURCES.txt

@@ -33,6 +33,7 @@ juham_automation/ts/powermeter_ts.py
 juham_automation/ts/powerplan_ts.py
 tests/__init__.py
 tests/test_japp.py
+tests/__pycache__/__init__.cpython-312.pyc
 tests/__pycache__/test_japp.cpython-312.pyc
 tests/automation/__init__.py
 tests/automation/test_energycostcalculator.py

{juham_automation-0.0.16 → juham_automation-0.0.17}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "juham-automation"
-version = "0.0.16"
+version = "0.0.17"
 description = "Juha's Ultimate Home Automation Masterpiece"
 readme = {file = "README.rst", content-type = "text/markdown"}
 requires-python = ">=3.8"