Model electrical heat sources (UPS, gaming PC) per zone

Electrical equipment heats its room, and a gaming session can add
hundreds of watts, which the 3-parameter model attributed to the boiler
or the bias term.

heat_sources.py adds heat sources as config subentries ("Add heat
source"): an active-power sensor (W/kW; VA and % rejected), the zone,
the share that becomes heat, an automatic baseline (20th percentile of
24 h, so the persistent UPS load is not double counted with the bias
term) or a manual one, an optional "included in" parent (the UPS total
minus a separately measured PC, one level deep) and a first-order
thermal response time. The heat during each interval is the power held
from its start, like the radiator lag. After startup or an outage a
source's response must run two time constants before it counts as
settled.

zone_model.py layers each zone: the base model is kept unchanged as the
fallback and comparison, and an extended FeatureLearner adds "internal"
(kW above baseline after the response) and neighbour coupling for
adjacent zones. It learns only intervals where all its inputs are
known, and is used for forecasts once as trained as the base. The
optimizer accepts a multi-zone step model; forecasts let extra power
fade to baseline with a configurable half-life (default 30 min).

On a synthetic office with thermostat cycling and gaming sessions the
extended model recovers the electrical, boiler and loss coefficients
within 10 %. Status lists each source's power, effective power,
baseline, variable and responding heat; models show the extended
coefficients with confidence. Saved models gain optional zone_models
and heat_sources keys.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

custom_components/heating_mpc/translations/en.json

@@ -67,10 +67,12 @@
           "comfort_band": "Comfort tolerance (°C)",
           "room_max_age_minutes": "Maximum room sensor report age (minutes)",
           "weather_max_age_minutes": "Maximum weather sensor report age (minutes)",
-          "room_stale_use_last_value": "Keep using the last value of a room sensor that stopped reporting"
+          "room_stale_use_last_value": "Keep using the last value of a room sensor that stopped reporting",
+          "internal_heat_half_life_minutes": "Extra electrical heat: forecast half-life (minutes)"
         },
         "data_description": {
-          "room_stale_use_last_value": "Off: a room sensor older than its report-age limit is left out and the other rooms are re-weighted. On: its last value is still used, for up to 24 hours without a report; for sensors that report only when the value changes. Unavailable or invalid room sensors are always left out. Nothing pauses unless no room is usable."
+          "room_stale_use_last_value": "Off: a room sensor older than its report-age limit is left out and the other rooms are re-weighted. On: its last value is still used, for up to 24 hours without a report; for sensors that report only when the value changes. Unavailable or invalid room sensors are always left out. Nothing pauses unless no room is usable.",
+          "internal_heat_half_life_minutes": "Forecasts assume heat above the baseline fades with this half-life, for example when a gaming session ends. 0 assumes it stops now."
         }
       },
       "weather": {
@@ -171,6 +173,77 @@
       "abort": {
         "reconfigure_successful": "The zone was updated."
       }
+    },
+    "heat_source": {
+      "entry_type": "Heat source",
+      "initiate_flow": {
+        "user": "Add heat source",
+        "reconfigure": "Edit heat source"
+      },
+      "step": {
+        "user": {
+          "title": "Electrical heat source",
+          "description": "Equipment whose electrical power ends up as heat in a zone, such as a UPS with computers. Only the variation above a persistent baseline is modeled: the constant part is already part of the zone's learned behavior. Use active power (W or kW), not VA or load %.",
+          "data": {
+            "name": "Name",
+            "sensor": "Active power sensor",
+            "zone": "Zone",
+            "heat_fraction": "Share of power that becomes heat in the zone",
+            "baseline_mode": "Baseline",
+            "baseline_w": "Manual baseline (W)",
+            "included_in": "Already included in the measurement of",
+            "response_minutes": "Thermal response time (minutes)",
+            "enabled": "Enabled"
+          },
+          "data_description": {
+            "heat_fraction": "1.0 when the equipment is in this zone. Lower it if part of the heat goes elsewhere, for example out of a vent.",
+            "baseline_mode": "Automatic uses the low end of the last 24 hours (the persistent load).",
+            "included_in": "Choose the UPS or meter whose reading already contains this device, so its power is not counted twice.",
+            "response_minutes": "How quickly the zone feels a change in power: room air, furniture and equipment take time to warm."
+          }
+        },
+        "reconfigure": {
+          "title": "Electrical heat source",
+          "description": "Equipment whose electrical power ends up as heat in a zone, such as a UPS with computers. Only the variation above a persistent baseline is modeled: the constant part is already part of the zone's learned behavior. Use active power (W or kW), not VA or load %.",
+          "data": {
+            "name": "Name",
+            "sensor": "Active power sensor",
+            "zone": "Zone",
+            "heat_fraction": "Share of power that becomes heat in the zone",
+            "baseline_mode": "Baseline",
+            "baseline_w": "Manual baseline (W)",
+            "included_in": "Already included in the measurement of",
+            "response_minutes": "Thermal response time (minutes)",
+            "enabled": "Enabled"
+          },
+          "data_description": {
+            "heat_fraction": "1.0 when the equipment is in this zone. Lower it if part of the heat goes elsewhere, for example out of a vent.",
+            "baseline_mode": "Automatic uses the low end of the last 24 hours (the persistent load).",
+            "included_in": "Choose the UPS or meter whose reading already contains this device, so its power is not counted twice.",
+            "response_minutes": "How quickly the zone feels a change in power: room air, furniture and equipment take time to warm."
+          }
+        }
+      },
+      "error": {
+        "source_name_required": "Enter a name.",
+        "sensor_in_other_source": "This power sensor is already used by another heat source.",
+        "invalid_parent_source": "The parent must be an existing source that is not itself included in another.",
+        "source_has_children": "Other sources are included in this one, so it cannot be included in another.",
+        "baseline_required": "Enter the manual baseline in W.",
+        "too_many_sources": "At most 16 heat sources are supported."
+      },
+      "abort": {
+        "reconfigure_successful": "The heat source was updated.",
+        "no_zones": "Add a zone first."
+      }
+    }
+  },
+  "selector": {
+    "baseline_mode": {
+      "options": {
+        "auto": "Automatic (24-hour low)",
+        "manual": "Manual value"
+      }
     }
   }
 }

custom_components/heating_mpc/translations/ro.json

@@ -67,10 +67,12 @@
           "comfort_band": "Toleranță confort (°C)",
           "room_max_age_minutes": "Vârsta maximă a raportării senzorilor interiori (minute)",
           "weather_max_age_minutes": "Vârsta maximă a raportării senzorilor meteo (minute)",
-          "room_stale_use_last_value": "Folosește în continuare ultima valoare a unui senzor de cameră care nu mai raportează"
+          "room_stale_use_last_value": "Folosește în continuare ultima valoare a unui senzor de cameră care nu mai raportează",
+          "internal_heat_half_life_minutes": "Căldură electrică suplimentară: timp de înjumătățire în prognoză (minute)"
         },
         "data_description": {
-          "room_stale_use_last_value": "Dezactivat: un senzor de cameră mai vechi decât limita de raportare este ignorat, iar ponderile celorlalte camere sunt recalculate. Activat: ultima lui valoare este folosită în continuare, cel mult 24 de ore fără raportare; pentru senzorii care raportează doar la schimbarea valorii. Senzorii de cameră indisponibili sau invalizi sunt mereu ignorați. Nimic nu se oprește decât dacă nicio cameră nu poate fi folosită."
+          "room_stale_use_last_value": "Dezactivat: un senzor de cameră mai vechi decât limita de raportare este ignorat, iar ponderile celorlalte camere sunt recalculate. Activat: ultima lui valoare este folosită în continuare, cel mult 24 de ore fără raportare; pentru senzorii care raportează doar la schimbarea valorii. Senzorii de cameră indisponibili sau invalizi sunt mereu ignorați. Nimic nu se oprește decât dacă nicio cameră nu poate fi folosită.",
+          "internal_heat_half_life_minutes": "Prognozele presupun că puterea peste consumul de bază scade cu acest timp de înjumătățire, de exemplu la finalul unei sesiuni de jocuri. 0 presupune că se oprește acum."
         }
       },
       "weather": {
@@ -171,6 +173,77 @@
       "abort": {
         "reconfigure_successful": "Zona a fost actualizată."
       }
+    },
+    "heat_source": {
+      "entry_type": "Sursă de căldură",
+      "initiate_flow": {
+        "user": "Adaugă sursă de căldură",
+        "reconfigure": "Modifică sursa de căldură"
+      },
+      "step": {
+        "user": {
+          "title": "Sursă electrică de căldură",
+          "description": "Echipamente a căror putere electrică ajunge căldură într-o zonă, de exemplu un UPS cu calculatoare. Se modelează doar variația peste un consum de bază persistent: partea constantă face deja parte din comportamentul învățat al zonei. Folosește putere activă (W sau kW), nu VA sau procent de încărcare.",
+          "data": {
+            "name": "Nume",
+            "sensor": "Senzor de putere activă",
+            "zone": "Zonă",
+            "heat_fraction": "Partea din putere care devine căldură în zonă",
+            "baseline_mode": "Consum de bază",
+            "baseline_w": "Consum de bază manual (W)",
+            "included_in": "Inclusă deja în măsurătoarea pentru",
+            "response_minutes": "Timp de răspuns termic (minute)",
+            "enabled": "Activă"
+          },
+          "data_description": {
+            "heat_fraction": "1,0 când echipamentul este în această zonă. Micșorează valoarea dacă o parte din căldură ajunge în altă parte, de exemplu pe o ventilație.",
+            "baseline_mode": "Automat folosește partea de jos a ultimelor 24 de ore (consumul persistent).",
+            "included_in": "Alege UPS-ul sau contorul a cărui citire conține deja acest dispozitiv, ca puterea să nu fie numărată de două ori.",
+            "response_minutes": "Cât de repede simte zona o schimbare de putere: aerul, mobila și echipamentele au nevoie de timp să se încălzească."
+          }
+        },
+        "reconfigure": {
+          "title": "Sursă electrică de căldură",
+          "description": "Echipamente a căror putere electrică ajunge căldură într-o zonă, de exemplu un UPS cu calculatoare. Se modelează doar variația peste un consum de bază persistent: partea constantă face deja parte din comportamentul învățat al zonei. Folosește putere activă (W sau kW), nu VA sau procent de încărcare.",
+          "data": {
+            "name": "Nume",
+            "sensor": "Senzor de putere activă",
+            "zone": "Zonă",
+            "heat_fraction": "Partea din putere care devine căldură în zonă",
+            "baseline_mode": "Consum de bază",
+            "baseline_w": "Consum de bază manual (W)",
+            "included_in": "Inclusă deja în măsurătoarea pentru",
+            "response_minutes": "Timp de răspuns termic (minute)",
+            "enabled": "Activă"
+          },
+          "data_description": {
+            "heat_fraction": "1,0 când echipamentul este în această zonă. Micșorează valoarea dacă o parte din căldură ajunge în altă parte, de exemplu pe o ventilație.",
+            "baseline_mode": "Automat folosește partea de jos a ultimelor 24 de ore (consumul persistent).",
+            "included_in": "Alege UPS-ul sau contorul a cărui citire conține deja acest dispozitiv, ca puterea să nu fie numărată de două ori.",
+            "response_minutes": "Cât de repede simte zona o schimbare de putere: aerul, mobila și echipamentele au nevoie de timp să se încălzească."
+          }
+        }
+      },
+      "error": {
+        "source_name_required": "Introdu un nume.",
+        "sensor_in_other_source": "Acest senzor de putere este folosit deja de altă sursă.",
+        "invalid_parent_source": "Sursa părinte trebuie să existe și să nu fie ea însăși inclusă în alta.",
+        "source_has_children": "Alte surse sunt incluse în aceasta, deci nu poate fi inclusă în alta.",
+        "baseline_required": "Introdu consumul de bază manual în W.",
+        "too_many_sources": "Sunt permise cel mult 16 surse de căldură."
+      },
+      "abort": {
+        "reconfigure_successful": "Sursa de căldură a fost actualizată.",
+        "no_zones": "Adaugă mai întâi o zonă."
+      }
+    }
+  },
+  "selector": {
+    "baseline_mode": {
+      "options": {
+        "auto": "Automat (minimul ultimelor 24 de ore)",
+        "manual": "Valoare manuală"
+      }
     }
   }
 }