# Sankey Diagramm
Widget type: `opendash-widget-hc-aggregate-sankey` · Plugin: `@opendash/plugin-openware`

### Beschreibung
Das **Sankey Diagramm** dient zur grafischen Darstellung von Stoff-, Energie- oder Datenströmen im System. IoT-Anwender können damit komplexe Verteilungen und Abhängigkeiten visualisieren, indem sie Mengenströme über mehrere hierarchische Ebenen hinweg als proportionale Bänder abbilden und so Engpässe oder Verluste sofort erkennen.
### Voraussetzungen
* Strukturierte Datenquellen oder Status-Datenpunkte, die hierarchisch oder logisch miteinander verknüpft werden können.
* Kontinuierliche Messdaten oder summierte Zählerstände im System für den zu analysierenden Zeitraum.
---
## 1. Konfiguration und Einrichtung
1. Klicke auf dem leeren Platzhalter deines neuen Widgets auf die Schaltfläche **Einstellungen**.
2. Definiere im Reiter **Daten** den gewünschten Auswertungszeitraum, indem du beispielsweise auf **Relative Auswahl** klickst, eine `1` einträgst und die Zeiteinheit auf **Woche** belässt.
3. Wechsel oben in den Reiter **Einstellungen**, um die strukturellen Datenströme und Hierarchien anzulegen.
4. Klicke unter dem Symbol für fehlende Daten auf das **Plus-Zeichen (`+`)**, um eine neue Strukturgruppe zu erstellen.
5. Bewege den Mauszeiger über den vordefinierten Gruppennamen `New Group`, klicke auf das **Stift-Symbol (Bearbeiten)** und benenne die Gruppe individuell um (z. B. in `Unternehmen`).
6. Klicke ganz rechts in der Zeile auf den **Pfeil nach unten**, um die Detailoptionen der Gruppe auszuklappen.
7. Klicke rechts neben **Keine Datenpunkt(e)** auf das **Plus-Zeichen (`+`)**, um die gewünschten Telemetriedaten oder Zählerstände auszuwählen, die in diese Flussebene einfließen sollen, und füge bei Bedarf unter **Keine Untergruppe(n)** weitere Verzweigungen hinzu.
8. Schließe die Einrichtung ab, indem du unten rechts auf **Speichern** klickst.
---
## 2. Erweiterte Einstellungen & Formatierung
Für das Sankey Diagramm stehen dir im Konfigurationsfenster eine Vielzahl von zeitlichen, logischen und visuellen Feineinstellungen in den Reitern **Daten** und **Einstellungen** zur Verfügung:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Relative Auswahl** | Zeitbereichs-Option im Reiter Daten. | Berechnet die Datenströme dynamisch basierend auf einem fließenden Zeitraum (z. B. letzte Woche). |
| **Absolute Auswahl** | Zeitbereichs-Option im Reiter Daten. | Fixiert das Diagramm auf einen statischen Zeitraum mit festem Start- und Enddatum. |
| **Daten aus der Zukunft laden** | Kontrollkästchen im unteren Datenbereich. | Ermöglicht die Vorschau von prognostizierten Strömen oder Planwerten, falls vorhanden. |
| **Randwerte ergänzen** | Kontrollkästchen im unteren Datenbereich. | Füllt Lücken an den Rändern des Zeitfensters mit den jeweils angrenzenden Werten auf. |
| **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im unteren Datenbereich. | Rundet das gewählte Auswertungsfenster automatisch auf die exakten Grenzen der Zeiteinheit ab. |
| **Sonstige Einstellungen / Automatisch Aktualisieren** | Ausklappbarer Menüpunkt im Datenbereich. | Aktiviert oder deaktiviert das kontinuierliche Nachladen von Live-Daten zur Echtzeitanzeige. |
| **Hierarchie der Daten festlegen** | Dropdown-Menü im Reiter Einstellungen. | Ermöglicht die Umschaltung zwischen einer benutzerdefinierten Struktur (**Custom**) oder vordefinierten Systemhierarchien. |
| **Verfahrensauswahl (z. B. Summe)** | Dropdown-Feld innerhalb einer angelegten Gruppe. | Legt fest, über welche mathematische Funktion die Werte der zugewiesenen Knoten zusammengefasst werden. |
| **Namen der Datenpunkte kürzen** | Kontrollkästchen im Bereich Bezeichnungen formatieren. | Aktiviert die automatische Einkürzung von langen, unübersichtlichen Systemnamen im Diagramm. |
| **Kürzung am Anfang bis / am Ende bis** | Text-Eingabefelder unterhalb der Namenskürzung. | Definiert die exakte Zeichenanzahl, die am Anfang oder Ende des Datenpunktnamens abgeschnitten werden soll. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach der erfolgreichen Einrichtung siehst du ein ausdrucksstarkes Flussdiagramm auf deinem Dashboard. Die einzelnen Datenpunkte und Gruppen werden als vertikale Blöcke (Knoten) dargestellt, die durch geschwungene Linien und Bänder miteinander verbunden sind. Das Besondere dabei: Die Breite der Verbindungsbänder ist direkt proportional zur Menge oder Stärke des jeweiligen Datenstroms.
Du kannst sofort optisch erfassen, wo die größten Mengen fließen, wie sich Gesamtströme (z. B. der Hauptenergiezähler eines Werks) auf einzelne Unterverbraucher und Maschinen aufteilen und an welchen Stellen unerwartete Abzweigungen oder Verluste auftreten.
> 💡 **Praxis-Tipp:** Nutze das Sankey Diagramm idealerweise für ein transparentes Energie- oder Ressourcenmanagement. Wenn du den Hauptstrom- oder Hauptwasserzähler als Ausgangsknoten definierst und die Hallen- sowie Maschinenzähler als Untergruppen anordnest, siehst du ohne langes Rechnen, welche Anlage die meiste Energie verschlingt und wo Optimierungspotenziale liegen.