# Prinzipalkomponenten Darstellung Widget type: `opendash-widget-hc-pca` · Plugin: `@opendash/plugin-openware` ![Principal component visualization preview](../../../../../_attachments/opendash/widgets/assets/widget-previews/hc-pca-pie.png) ### Beschreibung Die **Prinzipalkomponenten Darstellung** ermöglicht es dir, komplexe, mehrdimensionale Datenströme zu bündeln und deren relative Anteile in einer kompakten Grafik zu vergleichen. IoT-Anwender profitieren davon, indem sie die Haupttreiber von Systemzuständen, Verbräuchen oder Lasten sofort identifizieren und prozentual gewichten können. ### Voraussetzungen * Mindestens zwei oder mehr kontinuierliche Datenpunkte (z. B. Telemetriedaten wie Wirkleistung, Scheinleistung oder Ströme), die inhaltlich miteinander verglichen werden sollen. * Historische oder Echtzeit-Zeitreihendaten innerhalb des Systems für das gewählte Auswertungsfenster. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf dem leeren Platzhalter deines Widgets auf die Schaltfläche **Einstellungen**. 2. Klicke im Bereich **Wähle Datenquellen aus, die du visualisieren möchtest** in das Eingabefeld **Auswahl von einem Daten Item**. 3. Wähle im sich öffnenden Menü die gewünschten Datenpunkte aus (z. B. `Wirkleistung (Gesamt)`, `Cos-Phi (Gesamt)` und `Wirkarbeit (Gesamt)`) durch Setzen der jeweiligen Kontrollkästchen und bestätige die Auswahl mit **Schließen**. 4. Definiere im Bereich darunter das Zeitfenster, indem du beispielsweise auf **Relative Auswahl** klickst, eine `1` in das Zahlenfeld einträgst und das Dropdown-Menü daneben auf **Tag** einstellst. 5. Wechsel ganz oben im Konfigurationsfenster in den Reiter **Einstellungen**. 6. Wähle unter **Visualisierungsart festlegen** deine gewünschte Darstellungsform aus (z. B. **Kuchendiagramm**). 7. Klicke unten rechts auf **Speichern**, um die Konfiguration abzuschließen und das Widget auf deinem Dashboard zu generieren. --- ## 2. Erweiterte Einstellungen & Formatierung Im Konfigurationsfenster kannst du im Reiter **Daten** und **Einstellungen** detaillierte Anpassungen an den Berechnungen und der optischen Anzeige vornehmen: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Relative Auswahl** | Option zur zeitlichen Eingrenzung im Daten-Reiter. | Berechnet die Anteile dynamisch basierend auf einem rollierenden Zeitfenster (z. B. der jeweils letzte Tag). | | **Absolute Auswahl** | Option zur zeitlichen Eingrenzung im Daten-Reiter. | Fixiert die Auswertung auf einen statischen Zeitraum mit exaktem Start- und Enddatum. | | **Daten aus der Zukunft laden** | Kontrollkästchen für zukünftige Datenwerte. | Ermöglicht das Einbeziehen von Prognosedaten oder geplanten Zielwerten in das Diagramm. | | **Randwerte ergänzen** | Kontrollkästchen zur Datenbereinigung. | Füllt eventuelle Datenlücken an den äußeren Grenzen des Zeitfensters mit den jeweils nächsten verfügbaren Werten auf. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen zur zeitlichen Glättung. | Rundet das Auswertungsfenster automatisch auf die exakten Grenzen der gewählten Zeiteinheit ab. | | **Sonstige Einstellungen / Automatisch Aktualisieren** | Ausklappbares Menü im Datenbereich. | Aktualisiert die Anzeige auf dem Dashboard zyklisch mit den neuesten Live-Datenpunkten. | | **Kuchendiagramm** | Darstellungsoption im Einstellungs-Reiter. | Visualisiert die Datenpunkte als klassische, geschlossene Kreissegmente. | | **Donutdiagramm** | Darstellungsoption im Einstellungs-Reiter. | Stellt die Anteile als Ring mit einer leeren Mitte dar. | | **Donutdiagramm (halb)** | Darstellungsoption im Einstellungs-Reiter. | Zeigt die Verteilung kompakt in Form eines Halbkreises bzw. Bogens an. | | **Zeige Legende unter Diagramm** | Kontrollkästchen für Beschriftungen. | Blendet eine übersichtliche Legende mit den Namen aller Datenpunkte unterhalb der Grafik ein. | | **Zeige Label auf Graphen** | Kontrollkästchen für Direktbeschriftung. | Schreibt die Bezeichnungen und Werte für eine schnelle Erfassung direkt auf die einzelnen Segmente. | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern wird das Widget als übersichtliche Kreise- oder Ringgrafik auf deinem Dashboard dargestellt. Die verschiedenen Datenpunkte werden farblich voneinander abgegrenzt, wobei die Größe des jeweiligen Segments direkt proportional zu dessen Wert im Gesamtkontext steht. Wenn du mit der Maus über ein bestimmtes Segment fährst, öffnet sich ein interaktives Infofeld (Tooltip). Hier kannst du den exakten Namen des Datenpunkts, den gemessenen **Wert**, den Gesamtwert aller Komponenten (**Total**) sowie den exakten prozentualen **Anteil** präzise ablesen. > 💡 **Praxis-Tipp:** Verwende dieses Widget, um Lastverschiebungen oder Effizienzfaktoren wie den Leistungsfaktor (`Cos-Phi`) im Verhältnis zur echten Wirkleistung zu überwachen. Dadurch siehst du auf einen Blick, welche Komponente die Systemeffizienz dominiert oder wo ungenutzte Scheinleistung kapazitäre Engpässe verursacht.