# Copyright © 2026 Setti Solutions S.R.L, www.setti.md. All rights reserved. """The plan's saving split by carrier and lever (docs/methods.md A12, E14): for the console's Savings page, which shows per carrier what the household paid with Cantabile and would have paid without, and the levers load shifting / off-peak buying and heating apart. From the plan's own per-step costs (optimizer.step_costs: per carrier what each step costs with the plan and without it, at the same prices), summed over the horizon, and the heating's share of the electricity saving: the heating and cooling devices' electric draw at the horizon's mean import price (as the baseline counts it) against the step's own price, i.e. the saving from moving the heat pump's or heater's electricity in time. The rest of the electricity saving is load shifting and off-peak buying (battery, car, appliances). Gas and district heat are the heating's alone. {"electricity": {"plan_eur", "base_eur", "heating_eur"}, "gas": {"plan_eur", "base_eur"[, "why", "note"]}, "heat": {...}, "oil": {...}} Gas, heating oil and district heat whose saving rounds to 0.00 EUR carry why (a code) and note (in words) instead of a bare 0 (2026-11-09, the owner: "we still have no saving from gas/oil?"; methods E14): not_used the carrier is priced, the plan makes no heat with it (a hybrid's heat pump made all of it) flat_price one price at every step of the horizon: the plan's heat costs the same whenever it is made, there is nothing to move in time (the baseline counts the plan's own heat at the mean price, A12.2; a lower room temperature is not counted as a saving, E14; a hybrid's choice of source is not counted either) not_shifted the price varies, but the heat lies where it is needed not_planned the heating or tank on it was refused (its refusal's why: e.g. no gas price); 0 in plan and base, nothing of it is planned Electricity whose saving rounds to 0.00 EUR carries why and note too (audit 2026-11-09: 28 homes showed electricity 0 without a reason): no_lever the plan moves no electricity: no battery, no car plugged in or expected, no electric heating (heat pump, heater) and no electric hot water; the household's own use is a fixed term (a district-heat or gas flat, a car away) flat_price it has a lever, but one import price at every step and no battery: the lever's draw costs the same whenever it runs not_shifted the price varies (or a battery could store), but the plan found nothing cheaper than the baseline: the draw already lies in the cheapest hours, or nothing is due in the horizon The levers found are in the note. base_eur − plan_eur summed over the carriers is the plan's own saving, baseline_eur − cost_eur: the plan's electricity carries the market's contracts (a tenant-power flat's energy bought from its building at the offer's price per slot, GGV §42b / Mieterstrom §42a / §42c; before, only the grid meter was priced and such a flat showed electricity 0.00 against a baseline of its whole load). None without a tariff (no step costs).""" def saving_parts(s: dict, m, x, steps: dict | None) -> dict | None: if steps is None: return None out = {} for carrier, d in steps.items(): out[carrier] = {"plan_eur": round(sum(d["plan"]), 4), "base_eur": round(sum(d["base"]), 4)} if "electricity" in out: pi = s["price_import"] mean = sum(pi) / m.T heating = 0.0 for kind, v in m.devices.values(): if not v or kind not in ("heating", "cooling"): continue for t, p in enumerate(v["power"]): if p is not None: heating += m.eur_wh(t, mean - pi[t]) * x(p) out["electricity"]["heating_eur"] = round(heating, 4) if "electricity" in out: why = electricity_zero_why(s, m, out["electricity"]) if why is not None: out["electricity"].update(why) for carrier in HEAT_CARRIERS: why = zero_why(s, m, carrier, out.get(carrier)) if why is not None: out.setdefault(carrier, {"plan_eur": 0.0, "base_eur": 0.0}).update(why) return out HEAT_CARRIERS = {"gas": ("price_gas", "gas"), "oil": ("price_oil", "heating oil"), "heat": ("price_heat", "district heat")} ZERO_EUR = 0.005 # a saving that rounds to 0.00 EUR def zero_why(s: dict, m, carrier: str, part: dict | None) -> dict | None: """Why a heat carrier's saving is 0 in this plan ({why, note}; module docstring), None where it has a saving or is not there at all.""" key, words = HEAT_CARRIERS[carrier] if part is None: # not in the plan: a heating control or tank on it refused for want of its price for r in (s.get("refused") or {}).values(): if f"{carrier}_price" in (r.get("missing") or []): return {"why": "not_planned", "note": f"its heating is not planned: {r.get('why') or 'refused'}"} return None if abs(part["base_eur"] - part["plan_eur"]) >= ZERO_EUR: return None hybrid = any(kind == "heating" and v and v.get("src") == "hybrid" and (v.get("fuel") or "gas") == carrier for kind, v in m.devices.values()) col = "district" if carrier == "heat" else "gas" rooms = any(kind == "heating" and v and any(c is not None for c in v.get(col) or []) and (carrier == "heat" or (v.get("fuel") or "gas") == carrier) for kind, v in m.devices.values()) tail = "; a hybrid's choice between heat pump and boiler is not counted as a saving" if hybrid else "" if abs(part["plan_eur"]) < ZERO_EUR and abs(part["base_eur"]) < ZERO_EUR: return {"why": "not_used", "note": (f"the heat pump made all the heat in this plan: no {words} used" if hybrid else f"no {words} used in this plan") + tail} ps = [p for p in (s.get(key) or [])[:m.T] if p is not None] if ps and max(ps) - min(ps) < 1e-9: return {"why": "flat_price", "note": f"one {words} price ({ps[0]:.2f} ct/kWh) at every hour of the plan: its heat " "costs the same whenever it is made, nothing to move in time" + ("; a lower room temperature is not counted as a saving" if rooms else "") + tail} return {"why": "not_shifted", "note": f"the {words} price varies, but the heat was needed when it was made" + tail} def electric_levers(m) -> list[str]: """What in this plan can move electricity in time (its words).""" out = [] for kind, v in m.devices.values(): if not v: continue # e.g. a car not plugged in and none expected if kind == "battery" and float(v.get("cap") or 0) > 0: out.append("battery") elif kind == "ev": out.append("car") elif kind in ("heating", "cooling") and v.get("src") in ("electric", "heat_pump", "hybrid"): out.append({"heat_pump": "heat pump", "hybrid": "hybrid's heat pump"}.get(v["src"], "electric heating") if kind == "heating" else "cooling") elif kind == "dhw_tank" and v.get("src") == "electric": out.append("electric hot water") return sorted(set(out)) def electricity_zero_why(s: dict, m, part: dict) -> dict | None: """Why the electricity saving is 0 in this plan ({why, note}; module docstring), None where it has one.""" if abs(part["base_eur"] - part["plan_eur"]) >= ZERO_EUR: return None levers = electric_levers(m) if not levers: return {"why": "no_lever", "note": "nothing in this plan moves electricity in time (no battery, no car plugged in " "or expected, no heat pump or electric heating, no electric hot water): " "the household's own use is the same with and without the plan"} ps = [p for p in (s.get("price_import") or [])[:m.T] if p is not None] if ps and max(ps) - min(ps) < 1e-9 and "battery" not in levers: return {"why": "flat_price", "note": f"one electricity price ({ps[0]:.2f} ct/kWh) at every hour of the plan: " f"the {', '.join(levers)} costs the same whenever it runs"} return {"why": "not_shifted", "note": f"the {', '.join(levers)} found nothing cheaper in this plan: its draw " "already lies in the cheapest hours, or nothing is due in the horizon"}