# Histogramm Widget type: `opendash-widget-ow-histogram` · Plugin: `@opendash/plugin-openware`  ### Beschreibung Das **Histogramm** ist ein leistungsstarkes Visualisierungswerkzeug, das die Häufigkeitsverteilung eines bestimmten Datenpunkts über einen gewählten Zeitraum hinweg darstellt. IoT-Anwender können damit auf einen Blick erkennen, in welchen Wertebereichen (sogenannten Klassen oder Bins) sich ihre Maschinen oder Prozesse am häufigsten aufhalten – beispielsweise, wie oft eine Anlage im optimalen Lastbereich lief oder wie stabil Temperaturen blieben. ### Voraussetzungen * Mindestens ein kontinuierlicher Datenpunkt (z. B. Leistung in kW, Temperatur in °C oder Druck in bar), dessen historische Werte analysiert werden sollen. * Vorhandene historische Datenreihen im System für den gewünschten Auswertungszeitraum. --- ## 1. Konfiguration und Einrichtung 1. Klicke auf dem leeren Widget-Platzhalter im Dashboard auf das Zahnrad-Symbol oder die Schaltfläche **Einstellungen**, um das Konfigurationsmenü zu öffnen. 2. Navigiere zum Reiter **Daten**. 3. Klicke auf das Eingabefeld unter **Wähle Datenquellen aus, die du visualisieren möchtest.**, um das Dropdown-Menü mit den verfügbaren Datenpunkten zu öffnen. 4. Suche in der Struktur nach dem gewünschten Messwert und klicke darauf, um ihn auszuwählen. Bestätige die Auswahl anschließend mit einem Klick auf **Schließen**. 5. Lege im Bereich **Wähle den Zeitraum, für den die Daten geladen werden sollen.** fest, welcher Zeitbereich ausgewertet werden soll. Wähle standardmäßig **Relative Auswahl**, trage eine Zahl ein (z. B. `1`) und wähle die passende Zeiteinheit (z. B. `Woche`) aus dem Dropdown-Menü. 6. Klicke unten rechts auf **Speichern**, um die Konfiguration zu übernehmen und das fertige Histogramm auf deinem Dashboard anzuzeigen. --- ## 2. Erweiterte Einstellungen & Formatierung Um dein Histogramm präziser anzupassen oder das visuelle Verhalten zu steuern, kannst du im Konfigurationsfenster zusätzliche Optionen nutzen. Die wichtigsten Felder und Regler aus den Bereichen **Daten**, **Sonstige Einstellungen** und dem Reiter **Einstellungen** sind hier zusammengefasst: | Option | Beschreibung | Funktion | | :--- | :--- | :--- | | **Filter hinzufügen** | Kontrollkästchen direkt unter der Datenquellenauswahl. | Erlaubt es, bestimmte Ausreißer oder ungültige Werte vor der Analyse mathematisch herauszufiltern. | | **Aktueller Wert** | Zeitbereichs-Option im Daten-Reiter. | Beschränkt die Häufigkeitsberechnung auf das aktuell laufende, dynamische Zeitfenster. | | **Relative Auswahl** | Zeitbereichs-Option im Daten-Reiter. | Ermöglicht die flexible Auswertung der Daten bezogen auf den aktuellen Moment (z. B. die letzten 24 Stunden oder die letzte Woche). | | **Absolute Auswahl** | Zeitbereichs-Option im Daten-Reiter. | Fixiert das Histogramm auf einen fest definierten historischen Kalenderzeitraum mit exaktem Start- und Enddatum. | | **Daten aus der Zukunft laden** | Kontrollkästchen im Zeitbereichs-Menü. | Bezieht zukünftige Plan- oder Prognosedaten in die Häufigkeitsverteilung ein, falls diese im System vorhanden sind. | | **Randwerte ergänzen** | Kontrollkästchen im Zeitbereichs-Menü. | Schließt eventuelle Datenlücken an den Rändern des gewählten Zeitraums durch die jeweils letzten bekannten Messwerte. | | **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im Zeitbereichs-Menü. | Rundet das Zeitfenster automatisch auf die vollen Grenzen der gewählten Zeiteinheit (z. B. Beginn am Montag um 00:00 Uhr bei einer Woche). | | **Klassenanzahl / Bins** | Einstellungsoption im Reiter **Einstellungen**. | Bestimmt, in wie viele vertikale Balken (Intervalle) die Messdaten unterteilt werden sollen. Je mehr Bins, desto feiner die Verteilung. | | **Häufigkeitstyp** | Auswahlmenü im Reiter **Einstellungen**. | Schaltet die vertikale Achse zwischen absoluter Anzahl der Messwerte und prozentualer (relativer) Häufigkeit um. | | **Farbe** | Farbpalette im Reiter **Einstellungen**. | Ermöglicht die individuelle farbliche Gestaltung der Balken, um sie an das Design deines Dashboards anzupassen. | --- ## 3. Das fertige Dashboard-Ergebnis Nach dem Speichern siehst du ein übersichtliches Säulendiagramm auf deinem Dashboard. Auf der horizontalen Achse (X-Achse) sind die Messwerte in gleichmäßige Abschnitte (Klassen) unterteilt. Die vertikale Achse (Y-Achse) zeigt dir an, wie oft oder wie lange Werte innerhalb dieses spezifischen Abschnitts gemessen wurden. Der höchste Balken stellt somit den am häufigsten aufgetretenen Zustand oder Betriebspunkt deines IoT-Geräts dar. Du kannst direkt ablesen, ob deine Werte eine klassische Glockenkurve bilden (Normalverteilung) oder ob es auffällige Asymmetrien gibt – beispielsweise zwei getrennte Spitzen, was auf zwei völlig unterschiedliche Betriebszustände hindeutet. > 💡 **Praxis-Tipp:** Nutze das Histogramm für das Qualitäts- und Prozess-Monitoring! Indem du den Durchfluss oder Druck einer Leitung über eine Woche analysierst, siehst du sofort, ob die Anlage stabil im definierten Soll-Bereich arbeitet oder ob gefährliche Peaks in den Randbereichen auftreten, die auf Verschleiß hindeuten.