# Mustersuche
Widget type: `openware-widget-pattern-search` · Plugin: `@opendash/plugin-openware`

### Beschreibung
Das Widget **Mustersuche** ermöglicht es dir, zeitlich begrenzte Verhaltensmuster oder Anomalien in deinen IoT-Datenströmen gezielt zu isolieren und im historischen Verlauf zu vergleichen. IoT-Anwender können hiermit wiederkehrende Lastspitzen, Maschinenzustände oder Abweichungen visuell markieren und automatisch nach ähnlichen Vorkommen in der Vergangenheit suchen lassen.
### Voraussetzungen
* Mindestens ein kontinuierlicher Datenpunkt (z. B. zeitreihenbasierte Telemetriedaten wie Wirkleistung, Temperatur oder Druck).
* Historische Datenbestände im System, um eine Mustersuche über einen längeren Zeitraum hinweg zu ermöglichen.
---
## 1. Konfiguration und Einrichtung
1. Klicke auf dem neu hinzugefügten Widget-Platzhalter direkt auf die Schaltfläche **Einstellungen**.
2. Klicke im Reiter **Daten** in das Eingabefeld **Auswahl von einem Daten Item** unter der Sektion „Wähle Datenquellen aus, die du Visualisieren möchtest“.
3. Navigiere durch die Gerätestruktur und wähle den gewünschten Datenpunkt aus. Bestätige deine Auswahl anschließend mit einem Klick auf **Schließen**.
4. *(Optional)* Wähle im Bereich „Wähle den Zeitraum, für den die Daten geladen werden sollen“ die Option **Absolute Auswahl**, um einen festen historischen Zeitraum für die Analyse zu definieren. Standardmäßig ist hier bereits ein relativer Zeitraum voreingestellt.
5. Wechsel im oberen Bereich des Konfigurationsfensters in den Reiter **Einstellungen**.
6. Klicke auf die farbige Schaltfläche unter dem Menüpunkt **Farbe**, wähle im Farbwähler deine gewünschte Linienfarbe für den Graphen aus und klicke anschließend unten rechts auf **Speichern**.
---
## 2. Erweiterte Einstellungen & Formatierung
Zusätzlich zu den Basisschritten kannst du die Datenabfrage und die optische Darstellung über folgende Optionen im Konfigurationsmenü feintunen:
| Option | Beschreibung | Funktion |
| :--- | :--- | :--- |
| **Relative Auswahl** | Zeitbereichs-Option im Reiter Daten. | Lädt Daten flexibel anhand eines rollierenden Zeitfensters relativ zum aktuellen Zeitpunkt (z. B. letzte Woche). |
| **Absolute Auswahl** | Zeitbereichs-Option im Reiter Daten. | Fixiert die Datenabfrage auf ein fest definiertes Start- und Enddatum im Kalender. |
| **Daten aus der Zukunft laden** | Kontrollkästchen im unteren Datenbereich. | Bezieht zukünftige Plan- oder Prognosewerte mit ein, sofern diese für den gewählten Datenpunkt existieren. |
| **Randwerte ergänzen** | Kontrollkästchen im unteren Datenbereich. | Schließt zeitliche Lücken an den Grenzen des Abfragezeitraums automatisch mit den jeweils angrenzenden Datenwerten. |
| **Start-/Endzeit an Zeiteinheit anpassen** | Kontrollkästchen im unteren Datenbereich. | Rundet den gewählten Abfragezeitraum exakt auf die Grenzen der eingestellten Zeiteinheit ab. |
| **Sonstige Einstellungen** | Ausklappbares Menü im Datenbereich. | Ermöglicht die Aktivierung einer automatischen Aktualisierung der Diagrammdaten im laufenden Betrieb. |
| **Farbe** | Farbauswahl-Regler im Reiter Einstellungen. | Ändert die Linienfarbe des Graphen im Dashboard für eine bessere visuelle Abgrenzung. |
---
## 3. Das fertige Dashboard-Ergebnis
Nach dem Speichern siehst du einen großen zeitlichen Liniengraphen deines ausgewählten Datenpunkts auf dem Dashboard. Um nach Mustern zu suchen, ziehst du einfach mit gedrückter Maustaste im oberen Graphen ein interessantes Zeitfenster auf (Zoom-In).
Sobald du hineingezoomt hast, teilt sich die Ansicht: Der obere Graph zeigt nun vergrößert dein ausgewähltes "Muster". Direkt darunter erscheint ein zweiter Graph, der den gesamten historischen Zeitraum abbildet. Klickst du jetzt unter dem eingezoomten Graphen auf die Schaltfläche **Zeige Muster**, kannst du über den Schieberegler **Toleranz für Ähnlichkeit** den Grad der Übereinstimmung festlegen. Das Widget markiert dir daraufhin im unteren Verlaufsgraphen automatisch alle grau hinterlegten Zeitbereiche, in denen ein nahezu identischer Datenverlauf erkannt wurde. Mit der Schaltfläche **Zurücksetzen** gelangst du jederzeit wieder in die Ausgangsansicht.
> 💡 **Praxis-Tipp:** Nutze dieses Widget, um typische Anfahrprozesse von Anlagen oder wiederkehrende Fehlermuster im Stromverbrauch zu identifizieren. Indem du die Toleranz für Ähnlichkeit schrittweise erhöhst, entdeckst du auch leicht abweichende Anomalien, die auf beginnenden Verschleiß oder veränderte Umgebungseinflüsse hindeuten können.