ValuesInBursts (FPScript)
Sucht in einem Datensatz nach Werten, die zu einem Burst gehören.
Syntax
ValuesInBursts(DataSet, Threshold, DeltaX [ , Operation = EVENT_DEFAULT ])
Die Syntax der ValuesInBursts-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
Der zu durchsuchende Datensatz. Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal und Signalreihe. Es sind alle numerischen Datentypen erlaubt. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
Threshold |
Gibt den Schwellenwert für die Burst-Suche vor. Es werden die Werte einem Burst zugerechnet, für die mindestens einer der Nachbarwerte im Intervall [-DeltaX, DeltaX] links oder rechts über dem Schwellenwert liegt. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
DeltaX |
Bestimmt das Intervall [-DeltaX, DeltaX], in dem mindestens ein Wert über dem Schwellenwert liegen muss, damit der jeweils zu prüfende Wert dem Burst zugerechnet wird. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein. Bei komplexen Datentypen erfolgt eine Betragsbildung. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||
Operation |
Legt die Arbeitsweise der Funktion fest. Das Argument Operation kann folgende Werte haben:
Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert EVENT_DEFAULT gesetzt. |
Anmerkungen
Das Argument DeltaX sollte so klein wie möglich, aber größer als die Periodendauer sein, damit einzelne Wellen nicht als einzelne Bursts erkannt werden. Mit der Funktion können nicht nur periodische Signale analysiert werden. Die Funktion kann z. B. auch verwendet werden, um einen Anstieg aus einem Signal zu extrahieren. Für DeltaX gleich Null stellt die Funktion einen einfachen Schwellenwert-Entscheider dar.
Folgende Grafik zeigt ein Signal mit zwei hervorgehobenen Bursts:
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Arguments s |
Dieses Beispiel sucht nach Bursts in einem Signal und erzeugt ein Signal, in dem alle Werte, die nicht zu Bursts gehören, auf Null gesetzt sind. |
ValuesInBursts({0, 0.1, 0, 0.1, 1.3, 1.2, 1.4, 0.3, 0.1, 0, 0.2}, 0.2, 1) |
Ergibt {3L, 4L, 5L, 6L, 7L, 8L}. Dieses Beispiel sucht nach Werten in einem Burst und liefert die Indizes zurück. Ein Wert gehört zu einem Burst, wenn er selbst oder der linke oder der rechte Nachbarwert über dem Pegel 0,2 liegt. |