# Energiediagramm

> Status: Implementiert fuer IP-Symcon 8.0+.

Das Modul adaptiert `Energy_Pie` als unabhaengiges Enelix-Utils-Modul. Es
wertet fortlaufende Energiezaehler aus dem IP-Symcon-Archiv aus und zeigt die
Energiebilanz sowie Eigenverbrauchsquote und Autarkiegrad in einer individuellen
HTML-SDK-Darstellung.

## Properties

| Ident | Typ | Standard / Beschreibung |
| --- | --- | --- |
| `ProduktionZaehlerID` | Integer | Pflichtquelle fuer produzierte Energie |
| `EinspeisungZaehlerID` | Integer | Pflichtquelle fuer eingespeiste Energie |
| `NetzbezugZaehlerID` | Integer | Pflichtquelle fuer bezogene Energie |
| `VerbrauchZaehlerID` | Integer | Optionale direkte Hausverbrauchsquelle |
| `Zaehlerfaktor` | Float | `1.0`; gemeinsamer Faktor auf kWh |
| `Standardzeitraum` | String | `day`; Tag, Woche, Monat, Jahr oder Gesamt |
| `Aktualisierungsintervall` | Integer | `60 s`; 10 bis 3600 Sekunden |
| `FarbeEigenverbrauch` | String | Farbe der Eigenverbrauchsquote |
| `FarbeAutarkie` | String | Farbe des Autarkiegrads |
| `Debug` | Boolean | Zusaetzliche Diagnoseausgaben |

## Zeitraeume und Bedienung

Die Visualisierung bietet Tag, Woche, Monat, Jahr, Gesamt und Datumsbereich.
Der freie Datumsbereich umfasst Start- und Enddatum jeweils vollstaendig. Fuer
die Kalenderzeitraeume kann vor- und zuruecknavigiert oder direkt zum aktuellen
Zeitraum gesprungen werden. Zukuenftige Datumswerte werden nicht akzeptiert.

## Darstellung

Kachel und vergroesserte Ansicht enthalten bereits beim ersten HTML-Aufbau
einen vollstaendigen Datenstand. Ein nachgelagertes Refresh aktualisiert die
Werte; beim erneuten Sichtbarwerden wird ebenfalls aktualisiert. Das
Diagrammraster zeigt bei ausreichender Breite zwei Kreisdiagramme nebeneinander
und bei geringer Breite automatisch untereinander.

## Daten und Fehlerverhalten

Die drei Pflichtzaehler muessen numerisch und im Archiv vorhanden sein. Der
Hausverbrauch wird aus einer optionalen direkten Quelle gelesen oder aus
Produktion minus Einspeisung plus Netzbezug berechnet. Bei fehlendem Archiv
oder fehlenden Werten zeigt die Darstellung einen Diagnosehinweis statt einer
leeren Flaeche.

## Adaption aus Enelix 1

| Bereich | Behandlung |
| --- | --- |
| Archivierte Produktions-, Einspeise- und Netzbezugszaehler | angepasst uebernommen |
| Tag, Woche, Monat, Jahr und Gesamt | uebernommen |
| Frei waehlbarer Datumsbereich | neu implementiert |
| Standardzeitraum in der Konfiguration | neu implementiert |
| Farben der Kreisdiagramme | neu konfigurierbar |
| Vergroesserte Ansicht | mit eingebetteten Initialdaten stabilisiert |
| Starres Zwei-Spalten-Layout | durch responsives Raster ersetzt |
| Erzwungener Sprung auf Heute beim Laden | verworfen |