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

### Beschreibung
Das Widget **Sankey aus Sensorauswahl** visualisiert Energie- und Materialflüsse zwischen verschiedenen Sensoren als Flussdiagramm. Es ermöglicht dir, Verteilungen, Hauptverbraucher und Verlustströme innerhalb deiner Systemstruktur auf einen Blick zu erkennen und transparent nachzuvollziehen. Dadurch erhältst du eine fundierte Grundlage zur Optimierung deiner Ressourcenströme.
### Voraussetzungen
* Mindestens zwei oder mehr verknüpfte Sensoren bzw. Datenpunkte mit numerischen Messwerten (z. B. Wirkleistung oder Verbrauch).
* Eine definierte Hierarchie- oder Pfadstruktur (oder ein Wurzel-Sensor), um Aufteilungen und Verbindungen zwischen den Knotenpunkten abzubilden.
---
## 1. Konfiguration und Einrichtung
1. Öffne das Widget-Einstellungen-Fenster und wähle den Reiter **Daten**.
2. Klicke auf das Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.** und wähle alle relevanten Sensoren aus, deren Flüsse dargestellt werden sollen.
3. Bestimme unter **Wähle den Zeitraum, für den die Daten geladen werden sollen.** das Zeitfenster (z. B. über **Relative Auswahl** oder **Absolute Auswahl**).
4. Wechsle oben auf den Reiter **Einstellungen**.
5. Wähle unter **Datenaggregationsoptionen** die gewünschte Aggregationsfunktion (z. B. **Summe**) sowie das Zeit-Intervall (z. B. **Ausgewählter Zeitbereich**).
6. Gehe zum Bereich **Hierarchie** und wähle im Dropdown-Menü den passenden **Wurzel-Sensor** aus.
7. Vergib bei Bedarf im Feld **Wurzel Label** eine benutzerdefinierte Beschriftung für den Startknoten.
8. Klicke unten rechts auf **Speichern**, um die Konfiguration abzuschließen und das Sankey-Diagramm auf deinem Dashboard zu generieren.
---
## 2. Erweiterte Einstellungen & Formatierung
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Wähle Datenquellen aus...** | Mehrfachauswahl-Suchfeld für Sensoren. | Legt fest, welche Datenpunkte in das Flussdiagramm einfließen. |
| **Relative / Absolute Auswahl** | Zeitraumbestimmungs-Modus. | Erlaubt die Wahl zwischen relativer Zeitspanne (z. B. letzte Woche) und festen Daten. |
| **Daten aus der Zukunft laden** | Kontrollkästchen für zukunftbezogene Daten. | Erlaubt das Einbinden von Prognosedaten, falls vorhanden. |
| **Randwerte ergänzen** | Option zur Datenergänzung an Zeiträndern. | Schließt Lücken an den Rändern des gewählten Zeitintervalls. |
| **Start/Endzeit an Zeitfenster anpassen** | Synchronisation mit dem Zeitfenster. | Passt die Datenabfrage exakt an die Schnittstellen des Zeitintervalls an. |
| **Sonstige Einstellungen** | Zusatzoptionen im Daten-Reiter. | Bietet erweiterte Einstellungen zur Datenverarbeitung. |
| **Datenaggregationsoptionen** | Rechenmethode für Messwerte (Summe, Durchschnitt, Min/Max etc.). | Bestimmt, wie die Rohdaten für jeden Pfad zusammengefasst werden. |
| **Aggregations-Intervall** | Zeitraster-Auswahl (Minute, Stunde, Tag, Woche, Ausgewählter Zeitbereich). | Legt fest, über welchen Zeitraum die Aggregation aggregiert wird. |
| **Hierarchie** | Festlegung von Pfaden und Struktur. | Ermöglicht die automatische oder manuelle Zuordnung von Eltern- und Kind-Knoten. |
| **Optiondaten Wurzel-Sensor wählen** | Dropdown-Liste zur Wahl des Hauptknotens. | Definiert den Sensor, der als Ursprung/Hauptquelle im Diagramm fungiert. |
| **Wurzel Label** | Freitextfeld für die Beschriftung der Quelle. | Ändert den angezeigten Namen des Hauptknotens im Diagramm. |
| **Trennzeichen** | Zeichen zur Pfadtrennung. | Trennt Hierarchieebenen in automatisch eingelesenen Sensorpfaden. |
| **Optional, z.B. Heizung/Gebäude A** | Textfelder für individuelle Pfadstrukturen. | Erlaubt das manuelle Zuweisen von Kategorien oder Gebäudestrukturen pro Sensor. |
| **Farboptionen** | Farbauswahl für die einzelnen Datenreihen. | Ermöglicht die individuelle farbliche Gestaltung jedes Flussstranges und Knotenpunkts. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach der Konfiguration zeigt das Widget einen visuellen Datenfluss von links nach rechts:
* **Links (Wurzelknoten):** Repräsentiert die gesamte eingespeiste Menge (z. B. die Gesamtwirkleistung mit 100 %).
* **Rechts (Verzweigungen):** Zeigt die Aufteilung auf die verschiedenen untergeordneten Sensoren und Senken.
Die Breite der Verbindungsbänder entspricht direkt dem jeweiligen Mengen- bzw. Verbrauchswert. Wenn du mit dem Mauszeiger über ein Band oder einen Knoten fährst, öffnet sich ein Tooltip mit der exakten Wertangabe und dem prozentualen Anteil am Gesamtfluss.
> 💡 **Praxis-Tipp:** Nutze einheitliche Farbcodierungen unter den **Farboptionen** für verschiedene Abteilungen oder Gebäudeteile, um kritische Hauptverbraucher auf den ersten Blick farblich voneinander zu unterscheiden.