# Zeitmuster (Liniendarstellung)
Widget type: `opendash-widget-pattern` · Plugin: `@opendash/plugin-highcharts`

### Beschreibung
Das **Zeitmuster (Liniendarstellung) Widget** visualisiert zyklische Trends und periodische Datenstrukturen in Form eines klassischen, gekurvten Liniendiagramms. IoT-Anwender erhalten dadurch eine übersichtliche Darstellung, mit der sich wiederkehrende Muster oder Lastspitzen zu bestimmten Tageszeiten über ein längeres Zeitfenster hinweg präzise vergleichen lassen.
### Voraussetzungen
* Mindestens eine aktive Datenquelle im System, die kontinuierliche numerische Zeitreihen (z. B. Wirkleistung, Energieverbrauch oder Durchflussmengen) liefert.
* Die erforderlichen Benutzerberechtigungen, um das Dashboard anzupassen und neue Widgets zu konfigurieren.
---
## 1. Konfiguration und Einrichtung
1. Klicke auf die Schaltfläche **Einstellungen** auf dem noch unkonfigurierten Widget-Block, um das Konfigurationsfenster zu öffnen.
2. Stelle sicher, dass du dich im Reiter **Daten** befindest, und klicke in das obere Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.**.
3. Wähle aus der Liste die gewünschte numerische Variable aus (z. B. `Wirkleistung (Gesamt) (Demo Energy - Gesamt)`).
4. Lege im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das Zeitintervall fest. Belasse es standardmäßig bei `1` **Woche** im Modus **Relative Auswahl** oder passe die Werte nach deinen Wünschen an.
5. Wechsle ganz oben in den Reiter **Einstellungen**.
6. Stelle sicher, dass im Bereich **Visualisierungsart festlegen** die Option **Liniendiagramm (gekurvt)** ausgewählt ist.
7. Scrolle zum Bereich **Wähle eine Daten Aggregation** und bestimme die mathematische Berechnungsart für deine Datenpunkte (z. B. **Durchschnitt**).
8. Klicke unten rechts auf **Speichern**, um die Konfiguration anzuwenden und das Diagramm auf deinem Dashboard zu erstellen.
---
## 2. Erweiterte Einstellungen & Formatierung
Über die erweiterten Parameter lässt sich die mathematische Aufbereitung und die Interaktivität des Liniendiagramms präzise steuern:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Filter hinzufügen** | Auswahloption unter den Datenquellen. | Ermöglicht es, die einbezogenen Telemetriedaten vorab nach bestimmten logischen Kriterien zu filtern. |
| **Absolute Auswahl** | Tab im Bereich der Zeitraumeinstellungen. | Wechselt von einer dynamischen, rollierenden Zeitschleife zu einem fest definierten Start- und Enddatum. |
| **Daten aus der Zukunft laden** | Kontrollkästchen im Zeitraum-Menü. | Bezieht prognostizierte Werte oder zukünftige Soll-Vorgaben in das Diagramm ein, sofern diese verfügbar sind. |
| **Randwerte ergänzen** | Kontrollkästchen im Zeitraum-Menü. | Interpoliert fehlende Datenpunkte an den äußeren Grenzen des Zeitfensters, um eine geschlossene Darstellung zu sichern. |
| **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Zeitraum-Menü. | Rundet den Abfragezeitraum automatisch auf die Grenzen der gewählten Zeiteinheit (z. B. volle Stunden) ab. |
| **Sonstige Einstellungen (Automatisch Aktualisieren)** | Ausklappbares Menü im Daten-Reiter. | Aktualisiert die Visualisierung auf dem Dashboard in regelmäßigen Intervallen selbstständig mit neuen Live-Daten. |
| **Kreisförmiges Diagramm** | Option unter **Visualisierungsart festlegen**. | Stellt das Zeitmuster alternativ als kreisförmiges Netz- oder Radardiagramm dar. |
| **Aggregationsstufe wählen** | Dropdown-Menü (z. B. *Stunde innerhalb von Tag*). | Bestimmt die zeitliche Granularität und die Beschriftung der x-Achse (z. B. Einteilung in 2-Stunden-Blöcke über den Tag hinweg). |
| **Summe / Minimalwerte / Maximalwerte** | Optionen unter **Wähle eine Daten Aggregation**. | Wechselt die Berechnungsgrundlage pro Zeitabschnitt von Durchschnitt auf Gesamtsumme, den absoluten Tiefstwert oder den Höchstwert. |
| **Zeige Legende unter Diagramm** | Kontrollkästchen unter **Interaktionsmöglichkeiten**. | Blendet eine erklärende Datenreihen-Legende direkt unterhalb der Grafik ein. |
| **Zeige einen Tooltip für Datenpunkte** | Kontrollkästchen unter **Interaktionsmöglichkeiten**. | Aktiviert oder deaktiviert das Informationsfenster, das beim Überfahren der Datenlinien erscheint. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach erfolgreicher Konfiguration zeigt das Widget ein kartesisches Liniendiagramm. Die vertikale y-Achse bildet den Messwert ab (z. B. die Wirkleistung in kW), während die horizontale x-Achse die Zeitintervalle des Tages darstellt (z. B. zweistündige Abschnitte wie *0-1*, *6-7*, *11-12* bis *21-22* Uhr). Eine fließend gekurvte blaue Linie visualisiert die aggregierten Werte über diese Zeiträume hinweg und macht Steigungen oder Abfälle auf einen Blick sichtbar.
Wenn du mit der Maus über die Linie fährst (Hover-Effekt), öffnet sich ein interaktiver Tooltip. Dieser zeigt dir sofort den Namen der Datenquelle sowie das exakte Zeitfenster und den präzisen numerischen Wert an (z. B. den durchschnittlichen Verbrauch im Intervall um *14 Uhr*).
> 💡 **Praxis-Tipp:** Wenn du wissen möchtest, wann deine Anlagen im Laufe eines Tages die absolute Höchstlast fordern, stelle die Option **Wähle eine Daten Aggregation** auf **Maximalwerte**. So zeigt dir die Linie nicht die durchschnittliche Last, sondern die höchsten jemals gemessenen Spitzenwerte innerhalb der jeweiligen Tagesstunden an.