Skip to content

feat(forecast): Phase 4 – PR 4-D PV-Prognose mit Gütemessung, Blending, Kalibrierung und Clipping - #29

Open
PXLJAKE wants to merge 27 commits into
phase-4/b-storagefrom
phase-4/d-pv-forecast
Open

PXLJAKE wants to merge 27 commits into
phase-4/b-storagefrom
phase-4/d-pv-forecast

Conversation

@PXLJAKE

@PXLJAKE PXLJAKE commented Oct 21, 2026

Copy link
Copy Markdown
Owner

Gestapelt auf #26 (PR 4-B). Er hängt nicht von #27 (Tarife) ab. Die Basis wird nach dem Merge der Vorgänger umgestellt.

Was

WP5 aus docs/plans/phase-4.md, Paket suncore/forecast/pv/ und suncore/forecast/accuracy.py:

  • Adapter (vorlagengesteuert, liefern QuantileSeries in W):
    • Solcast: detailedForecast, 30 min, P10/P50/P90 aus kW. Die Tagessensoren heute bis d4 werden verbunden. Fehlt ein Tag, entsteht eine None-Lücke, kein kopierter Nachbarwert.
    • Open-Meteo Solar Forecast: wh_period_15m, energieerhaltend in W umgerechnet.
    • Forecast.Solar: über energy/solar_forecast (wh_hours je config_entry_id). Bei mehreren Einträgen wird nicht geraten. Die Integration lässt nur den 0-Wh-Wert um Mitternacht weg, dieser wird aufgefüllt. Schlüssel außerhalb des Rasters, etwa zum Sonnenaufgang, werden energieerhaltend der umgebenden Periode zugeschlagen; die Quelle fällt deswegen nie aus.
    • Generische Attribut-Vorlage: als Liste oder Zuordnung.
  • PvForecastService:
    • Aktualisierung alle 30 min, bei Entity-Änderung und sofort nach (Wieder-)Verbindung.
    • Gute Daten werden nie durch leere oder kaputte Abrufe ersetzt.
    • Lücken werden höchstens 6 h lang aus der vorigen Ausgabe gefüllt.
    • Speichern höchstens stündlich oder bei einer Änderung über 15 %, nur die Rohausgabe.
  • Prognosegüte: MAE und Bias (Ist − Prognose) je Quelle und Vorlauf (0–6, 6–24, 24–48 h). Gerechnet wird über 14 Tage, nur bei Tageslicht und ohne abgeregelte Slots, im Nachtjob.
  • Blending:
    • Gewichte aus der inversen MAE, Mindestgewicht, manuelle Gewichte möglich, Renormalisierung je Slot.
    • P10/P90 werden bei Uneinigkeit der Quellen verbreitert (Gesamtvarianz).
    • Eine Quelle ohne Abruf seit über 12 h fällt aus dem Mix, solange eine frische Quelle Daten hat.
  • Kalibrierung:
    • Ein Faktor je Stunde × Jahreszeit × Wetterklasse. Die Wetterklasse ist der Clear-Sky-Index aus Sonnenstand und Haurwitz-Modell auf der Modulfläche; der Standort kommt aus HAs get_config.
    • Der Faktor ist auf 0,5–1,5 begrenzt und wird bei wenigen Daten Richtung 1 geschrumpft.
    • Gelernt wird je Quelle vor dem Blend.
    • Angewendet erst ab 30 Tagen Historie. Vorher wird nur berechnet und zum Vergleich angezeigt.
  • Abregelung (Clipping): Erkannt werden die Einspeisung am Exportlimit, wenn die Prognose höher war, und ein Wechselrichter-Plateau, das aus den Daten abgeleitet wird. Abgeregelte Slots zählen nicht in Gütemessung und Kalibrierung.
  • API:
    • GET /api/v1/forecast/pv?hours=48: je Quelle die Reihe mit Aktualität, der Mix, die Gewichte und der Kalibrierungsstatus, roh und kalibriert zum Vergleich.
    • GET /api/v1/forecast/accuracy: inklusive blended.
  • Demo: drei unterschiedlich verzerrte Quellen (Solcast, Open-Meteo und Forecast.Solar) mit festem Seed.

Warum

Der Planer (4-F) und das Risikomodell (4-E) brauchen eine 48-h-PV-Prognose mit Unsicherheit, die aus der gemessenen Güte der Quellen lernt (BRIEF §4.2, Plan §0).

Wie getestet

  • ./scripts/check.sh grün: 3654 Python-Tests, 219 Frontend-Tests, Abdeckung 96 %, Bundle 132,7 kB. markdownlint ohne Fehler.
  • Hypothesis-Tests:
    • Die Gewichte summieren sich zu 1 und halten das Mindestgewicht.
    • P10 ≤ P50 ≤ P90.
    • Eine einzelne Quelle geht unverändert durch.
    • Die Faktoren bleiben begrenzt, die Schrumpfung ist monoton.
    • Vor 30 Tagen bleibt die Kalibrierung inaktiv.
  • Szenarien:
    • Eine Quelle mit +30 % bekommt weniger Gewicht und wird ab Tag 30 korrigiert.
    • Ein Ost-West-Dach, das als Süddach prognostiziert wurde, wird korrigiert.
    • Ein Plateau am Exportlimit wird erkannt, eine natürliche Mittagsspitze nicht.
  • Simulator: Der Mix der drei Demo-Quellen hat an Tag 15 eine MAE von 58,9 W. Die Einzelquellen liegen bei 75,3 / 117,2 / 135,1 W.
  • Clear-Sky-Modell numerisch gegen Berlin geprüft (Mittagshöhe Juni 60,8°, Dezember 14,1°).
  • Weitere Tests: Sommer-/Winterzeit (46/50 Halbstunden-Slots), echte Forecast.Solar-Form (nur Mitternacht fehlt), Sonnenaufgangs-Schlüssel, Stop während des Nachtjobs (Geräte-Freigabe zuerst).

Risiken

  • Die Konstanten für Kalibrierung und Abregelung sind begründet gewählt, aber noch nicht an echten Daten eingestellt.
  • Bei Nulleinspeisung erkennt SunCore die Abregelung nur über das Plateau. Das ist bewusst so, sonst würde jede Überprognose als Abregelung versteckt.
  • Der eingebaute Ersatz über die Open-Meteo-API kommt erst in Phase 6, zusammen mit den Preis-Ersatzquellen. Der Grund: Nutzungsbedingungen und Azimut-Konvention konnten nicht live geprüft werden.
  • Commit-Historie: ein WIP-Sicherungscommit und ein leerer feat-Abschlusscommit (wegen der Nutzungslimits). Squash-Merge empfohlen, damit der CHANGELOG sauber bleibt.

Safety-Review

n/a laut Reviewer: kein Geräte-Schreibpfad. Der neue WS-Befehl energy/solar_forecast ist nur lesend und durch Grenzregel 9 auf ha/sim beschränkt. forecast/ importiert kein storage. Beim Stoppen werden die Geräte freigegeben, bevor auf den Nachtjob gewartet wird; dafür gibt es einen Test.

Checkliste

  • Tests für neues Verhalten, Lint/Typen/Tests grün
  • Keine hardcodierten UI-Strings; neue Keys in en und de
  • Doku aktualisiert (Recherche: get_config latitude/longitude; Vorlagen-Changelog; Plan-Abweichungen)
  • docs/STATUS.md aktualisiert
  • Nichts erfunden: Feldnamen aus docs/research/integrations.md, Offenes als UNVERIFIED

Offene Fragen an den Maintainer

Für alle gilt ohne Antwort der Standard.

  1. Exportlimit: Trag deine 13,5 kW im Assistenten beim Netzanschluss ein, dann erkennt SunCore die Abregelung am Limit. Standard: du trägst es ein, wenn du den Assistenten das nächste Mal öffnest.
  2. Auswahl im Assistenten: Bei mehreren Forecast.Solar-Einträgen im Energie-Dashboard ist eine Auswahl nötig. Standard: kommt mit 4-H.
  3. Schwellen: 15 % Änderung, 15 min Speicherabstand, 6 h Auffüllen, 14 Tage Gütefenster, 12 h bis zum Ausschluss einer veralteten Quelle. Standard: so lassen.
  4. Gewichte: Sie beruhen auf der Güte der unkalibrierten Quellen. Standard: so lassen, später auch die kalibrierte Güte bewerten.
  5. Solcast: Die Tagessensoren bis d4 reichen für 48 h. Standard: d5–d7 werden nicht eingebunden.
  6. UNVERIFIED:
    • Solcast: Translation-Keys von d3/d4 und das Datumsformat der Fallback-Aktion
    • Open-Meteo: Übersetzungsschlüssel und die CC-BY-4.0-Attribution in der Oberfläche (kommt mit 4-H)
    • Forecast.Solar: Schlüssel als Periodenbeginn und mögliche Sonnenaufgangs-Schlüssel
    • ob der Supervisor-Proxy energy/solar_forecast durchreicht

Generated by Claude Code

claude added 27 commits October 19, 2026 16:27
Snapshot so nothing is lost when the usage limit stops the session; not yet
checked, squashed in spirit by the following WP5 commits.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
… (WP5)

Template-driven PV forecast sources (Solcast, Forecast.Solar via energy/solar_forecast,
Open-Meteo Solar Forecast, generic attribute), refresh service with keep-last-good and
hourly-or-material storage, nightly accuracy bookkeeping, API and demo forecasts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…class (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…ted inverter plateau (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…clipping-free data (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…ot every zero (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…source (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
… fresh one exists (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…)connects (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…vices first (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…log the runtime (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…ED (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…r-sky model

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…ping detection (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…red peaks, not a growing max (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…the boundary docstring (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…; regenerate the compatibility table (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…only (WP5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
…st sources

The demo now has three PV forecast sources (WP5); the E2E check expected Solcast to be
the only one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHXsfH6PkT62o9idByAd6e
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants