juham-automation 0.0.15__py3-none-any.whl → 0.0.17__py3-none-any.whl

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
@@ -306,12 +314,19 @@ class HotWaterOptimizer(Juham):
         # don't bother to switch the relay on for small intervals, to avoid
         # wearing contactors out
         if remaining_ts < self.operation_threshold:
+            print(
+                f"Skipping balance, remaining time {remaining_ts}s < {self.operation_threshold}s"
+            )
             return False
 
         # check if the balance is sufficient for heating the next half of the energy balancing interval
         # if yes then switch heating on for the next half an hour
         needed_energy = 0.5 * self.radiator_power * remaining_ts
         elapsed_interval = ts - self.net_energy_balance_ts
+        print(
+            f"Needed energy {int(needed_energy)}Wh, current balance {int(self.net_energy_balance)}Wh"
+        )
+
         if (
             self.net_energy_balance > needed_energy
         ) and not self.net_energy_balancing_rc:
@@ -342,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)
@@ -350,13 +365,11 @@ class HotWaterOptimizer(Juham):
             if elapsed_b > self.energy_balancing_interval:
                 self.net_energy_balancing_mode = False
                 self.info(
-                    f"TODO: Net energy balancing mode because elapsed {elapsed_b}s is less than balancing interval {self.energy_balancing_interval}s"
+                    f"Exiting net energy balancing mode: {elapsed_b}s > {self.energy_balancing_interval}s"
                 )
             else:
-                self.info(
-                    f"TODO: Net energy balance waiting interval {elapsed_b}s to end"
-                )
-                # return 0
+                self.info(f"Net energy balance waiting interval {elapsed_b}s to end")
+                return 0
 
         if self.current_temperature > self.maximum_boiler_temperature:
             self.info(

{juham_automation-0.0.15.dist-info → juham_automation-0.0.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: juham-automation
-Version: 0.0.15
+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.15.dist-info → juham_automation-0.0.17.dist-info}/RECORD

@@ -3,7 +3,7 @@ juham_automation/japp.py,sha256=zD5ulfIcaSzwbVKjHv2tdXpw79fpw97B7P-v-ncY6e4,1520
 juham_automation/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 juham_automation/automation/__init__.py,sha256=73Mw0jkipeMCoUtpREHJPATfKe368ZyNeqfbjamBx_Q,481
 juham_automation/automation/energycostcalculator.py,sha256=7GGKLv5JpHAY3XVjbkboXuQBk-whpWkBwNuQ68Tv4Pc,11091
-juham_automation/automation/hotwateroptimizer.py,sha256=a3kp6JuOG13wHoC3CJFS4rz1HxedR2RHNTiKiJkuvEI,22359
+juham_automation/automation/hotwateroptimizer.py,sha256=oOgMgfqzqLN-hNdqaxgK_eKuw6q3JCsnZNM5XG17nko,23194
 juham_automation/automation/powermeter_simulator.py,sha256=0g0gOD9WTqxUj9IbENkea_33JrJ2sZDSQVtmxVUHcD8,4688
 juham_automation/automation/spothintafi.py,sha256=XnL2zIPx_XaP_1E8ksuYEUemtHP7N6tLlSv2LEBQyXQ,4471
 juham_automation/automation/watercirculator.py,sha256=d7PQFNajtVafizS_y2R_6GWhm_GYb8uV4-QScz1Sggo,6569
@@ -15,9 +15,9 @@ juham_automation/ts/log_ts.py,sha256=DPfeJhbSMQChY37mjAxEmE73Ys3dxUvNsN78PSuBm9Y
 juham_automation/ts/power_ts.py,sha256=esNbtH1xklyUaf0YJQ2wDuxTAV3SnEfx-FtiBGPaSVA,1448
 juham_automation/ts/powermeter_ts.py,sha256=zSATxZAzz1KJeU1wFK8CP86iySWnHil89mridz7WHos,2421
 juham_automation/ts/powerplan_ts.py,sha256=-Lhc7v5Cj7USy2MfmyUEusXSox9UbEoDtYGReDEt3cw,1527
-juham_automation-0.0.15.dist-info/licenses/LICENSE.rst,sha256=D3SSbUrv10lpAZ91lTMCQAke-MXMvrjFDsDyM3vEKJI,1114
-juham_automation-0.0.15.dist-info/METADATA,sha256=hOAyfbi17nrr7UZ3rYBLGB47Thc8RkBm4mfdrka2o64,4733
-juham_automation-0.0.15.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-juham_automation-0.0.15.dist-info/entry_points.txt,sha256=di8tXChhP8B_98bQ44u-1zkOha2kZCoJpCAXxTgoSw8,491
-juham_automation-0.0.15.dist-info/top_level.txt,sha256=jfohvtocvX_gfT21AhJk7Iay5ZiQsS3HzrDjF7S4Qp0,17
-juham_automation-0.0.15.dist-info/RECORD,,
+juham_automation-0.0.17.dist-info/licenses/LICENSE.rst,sha256=D3SSbUrv10lpAZ91lTMCQAke-MXMvrjFDsDyM3vEKJI,1114
+juham_automation-0.0.17.dist-info/METADATA,sha256=os2IZ8IJd054hzwvnWwzC8OPdX5939zEMzdrSwH77nw,4733
+juham_automation-0.0.17.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+juham_automation-0.0.17.dist-info/entry_points.txt,sha256=di8tXChhP8B_98bQ44u-1zkOha2kZCoJpCAXxTgoSw8,491
+juham_automation-0.0.17.dist-info/top_level.txt,sha256=jfohvtocvX_gfT21AhJk7Iay5ZiQsS3HzrDjF7S4Qp0,17
+juham_automation-0.0.17.dist-info/RECORD,,