# Zeitmuster (Kreisdarstellung)
![[hc-pattern-circle.png]]
### Beschreibung
Das **Zeitmuster (Kreisdarstellung) Widget** visualisiert zeitliche Verläufe und zyklische Datenmuster in Form eines kreisförmigen Netz- oder Radardiagramms (oft auch als Uhrzeit-Spidardiagramm genutzt). IoT-Anwender erhalten dadurch eine intuitive Übersicht darüber, zu welchen Tageszeiten oder Intervallen bestimmte Messwerte – wie beispielsweise der Energieverbrauch – ihre Spitzenwerte erreichen oder abfallen.
### Voraussetzungen
* Mindestens eine aktive Datenquelle, die fortlaufende numerische Zeitreihen oder Telemetriedaten (z. B. Wirkleistung, Temperatur oder Durchflussmengen) liefert.
* Entsprechende Berechtigungen zur Bearbeitung und Konfiguration von Dashboards im System.
---
## 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. Wähle im Bereich **Visualisierungsart festlegen** die Option **Kreisförmiges Diagramm**.
7. Bestimme im Bereich **Wähle eine Daten Aggregation** die gewünschte 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 Kreisdiagramms 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** | Ausklappbares Menü im Daten-Reiter. | Bietet Funktionen wie die automatische Aktualisierung des Widgets in festen Intervallen. |
| **Liniendiagramm (gekurvt)** | Option unter **Visualisierungsart festlegen**. | Stellt das Zeitmuster als klassisches, horizontales Liniendiagramm statt in Kreisform dar. |
| **Aggregationsstufe wählen** | Dropdown-Menü (z. B. *Stunde innerhalb von Tag*). | Bestimmt die zeitliche Granularität und die Achsenabschnitte des Kreises (z. B. 24-Stunden-Zifferblatt). |
| **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 kreisförmigen 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 siehst du ein spinnennetzartiges, kreisförmiges Diagramm. Die Achsen verlaufen strahlenförmig von innen nach außen und sind wie ein 24-Stunden-Zifferblatt angeordnet (z. B. Abschnitte für *0-1*, *1-2* bis *23-24* Uhr). Die blaue Datenlinie verbindet die aggregierten Werte der jeweiligen Uhrzeiten miteinander. Je weiter sich die Linie nach außen zum Rand des Kreises bewegt, desto höher ist der gemessene Wert in diesem Zeitraum.
Wenn du mit der Maus über die Datenlinie fährst (Hover-Effekt), öffnet sich ein interaktiver Tooltip. Dieser zeigt dir sofort den Namen der Datenquelle sowie die exakte Stunde und den präzisen numerischen Wert an (z. B. den durchschnittlichen Verbrauch um Punkt *10 Uhr*).
> 💡 **Praxis-Tipp:** Nutze dieses Widget, um deine Spitzenlasten im Tagesverlauf aufzudecken! Wähle unter **Wähle eine Daten Aggregation** die Option **Maximalwerte**, um die absoluten Verbrauchspeaks über den Tag hinweg im Blick zu behalten. Verformt sich der Kreis an bestimmten Uhrzeiten extrem nach außen, weißt du sofort, zu welcher Stunde deine Anlagen die meiste Energie anfordern.