# Wochen-Heatmap Widget type: `opendash-widget-pattern-heatmap` · Plugin: `@opendash/plugin-highcharts`  ### Beschreibung Das **Wochen-Heatmap Widget** visualisiert die Intensität und Verteilung von Messwerten über die gesamte Arbeitswoche hinweg in einer übersichtlichen Farbmatrix. IoT-Anwender erhalten dadurch ein farbcodiertes Muster, mit dem Ausreißer, Spitzenlasten oder wiederkehrende Inaktivitäten nach Wochentag und Uhrzeit sofort ins Auge springen. ### Voraussetzungen * Mindestens eine aktive Datenquelle, die kontinuierliche Zeitreihen oder Zählerdaten (z. B. Stückzahlen, Energieverbräuche oder Maschinensignale) bereitstellt. * Die erforderlichen Zugriffsrechte, um Änderungen am Dashboard vorzunehmen und neue Widgets einzurichten. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf die Schaltfläche **Einstellungen** auf dem noch nicht konfigurierten Widget-Block, um in das Konfigurationsmenü zu gelangen. 2. Stelle sicher, dass du dich im Reiter **Daten** befindest, und klicke in das obere Auswahlfeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.**. 3. Wähle aus der Liste die gewünschte numerische Variable aus. 4. Definiere im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das gewünschte Zeitfenster. Gib dazu die Zahl ein (z. B. `2`) und wähle die Einheit aus dem Dropdown-Menü (z. B. **Wochen**). 5. Wechsle ganz oben in den Reiter **Einstellungen**. 6. Überprüfe die beiden Aggregationsschritte für die zeitliche Zusammenfassung (standardmäßig ist hier bereits jeweils **Durchschnitt** hinterlegt). 7. Klicke unten rechts im Konfigurationsfenster auf **Speichern**, um die Heatmap auf dem Dashboard zu erstellen. --- ## 2. Erweiterte Einstellungen & Formatierung Die Konfigurationsoberfläche bietet vielseitige Optionen, um die mathematische Datenglättung und Zeitfenster flexibel an deine Anforderungen anzupassen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Filter hinzufügen** | Kontrollkästchen direkt unter der Datenquellenauswahl. | Ermöglicht es, die einlaufenden Datenpunkte vorab nach bestimmten logischen Kriterien einzugrenzen. | | **Aktueller Wert** | Schaltfläche im Bereich der Zeitraumeinstellungen. | Schaltet die Datenbasis auf den exakt aktuellen, momentanen Messwert um. | | **Relative Auswahl** | Schaltfläche im Bereich der Zeitraumeinstellungen. | Nutzt ein dynamisch rollierendes Zeitfenster (z. B. die letzten X Wochen), das sich fortlaufend aktualisiert. | | **Absolute Auswahl** | Schaltfläche im Bereich der Zeitraumeinstellungen. | Fixiert den Auswertungszeitraum auf einen statischen Zeitraum mit festem Start- und Enddatum. | | **Keine Live-Daten laden** | Kontrollkästchen im Zeitraum-Menü. | Deaktiviert die Echtzeit-Aktualisierung des Widgets und friert den geladenen Datenstand ein. | | **Daten aus der Zukunft laden** | Kontrollkästchen im Zeitraum-Menü. | Nimmt vorausschauende Planungsdaten oder Soll-Vorgaben in die Matrix auf, falls diese im System existieren. | | **Randwerte ergänzen** | Kontrollkästchen im Zeitraum-Menü. | Vervollständigt unvollständige Datenpunkte an den äußeren Grenzen des gewählten Abfragezeitraums. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Zeitraum-Menü. | Rundet das gewählte Zeitfenster automatisch sauber auf die Grenzen der genutzten Zeiteinheit ab. | | **Sonstige Einstellungen (Automatisch Aktualisieren)** | Ausklappbares Menü im Daten-Reiter. | Ermöglicht die Aktivierung einer regelmäßigen, automatischen Aktualisierung des Widgets auf dem Dashboard. | | **Schritt 1 (Aggregation)** | Dropdown-Menü im Reiter Einstellungen. | Bestimmt, wie Werte innerhalb einer konkreten Stunde zusammengefasst werden (z. B. **Summe**, **Anzahl**, **Minimalwerte**, **Maximalwerte**, **Durchschnitt**, **Differenz Min & Max** oder **Differenz zwischen erstem & letztem Wert**). | | **Schritt 2 (Aggregation)** | Dropdown-Menü im Reiter Einstellungen. | Bestimmt, wie die Ergebnisse aller passenden Stunden im Gesamtzitraum zusammengefasst werden (bietet dieselben mathematischen Optionen wie Schritt 1). | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern wird das Widget als übersichtliches Kachelraster dargestellt. Die vertikale Achse zeigt die Wochentage von **Montag** bis **Sonntag**, während die horizontale Achse den Tag in Stundenabschnitte unterteilt (z. B. *0-1*, *8-9*, *16-17* bis *23-24* Uhr). Jedes einzelne Quadrat im Raster steht für eine ganz bestimmte Stunde an einem bestimmten Wochentag. Die Intensität der Werte wird über eine Farbabstufung (z. B. von hellem zu dunklem Blau) dargestellt. Eine Farbskala am rechten Rand des Widgets dient dabei als Legende und ordnet den Farbtönen die entsprechenden Zahlenwerte zu. Fährst du mit der Maus über eine der Kacheln (Hover-Effekt), öffnet sich ein Tooltip, der dir den exakten Namen der Datenquelle, den Wochentag, das Stundenintervall sowie den präzisen berechneten Wert anzeigt. > 💡 **Praxis-Tipp:** Nutze die Heatmap, um versteckte Energiefresser oder unproduktive Nebenzeiten zu identifizieren! Wenn du in den Einstellungen bei beiden Aggregationsschritten **Summe** wählst, erkennst du an besonders dunkel gefärbten Kacheln sofort, zu welchen Uhrzeiten am Wochenende oder nach Schichtende ungewöhnlich hohe Verbräuche oder Aktivitäten stattgefunden haben.