ValuesInSpikes (FPScript)

21.09.2021

Sucht in einem Datensatz nach Werten, die zu einem Spike gehören.

Syntax

ValuesInSpikes(DataSet, MinHeight, MaxWidth [ , Operation = EVENT_DEFAULT ])

 

Die Syntax der ValuesInSpikes-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.

MinHeight

Gibt den Betrag des minimalen Delta-Y vor, das erreicht werden muss, um den Anfang oder das Ende eines Spikes zu detektieren.

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.

MaxWidth

Ist maximale die Anzahl an Datenpunkten, die ein Spike haben darf.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt.

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:

Konstante

Bedeutung

EVENT_INDEX

Im Ergebnis-Datensatz werden die Indizes der Werte bzw. Punkte abgelegt, die der Bedingung entsprechen.

EVENT_EXTRACT

Nur die Punkte bzw. Werte, die der Bedingung entsprechen, werden in den Ergebnis-Datensatz übertragen.

EVENT_SETVOID

Punkte bzw. Werte, die der Bedingung nicht entsprechen, werden zwar mit in den Ergebnis-Datensatz übernommen, dort aber ungültig markiert.

EVENT_DEFAULT

Entspricht EVENT_SETVOID, wenn eine Datenmatrix oder Signalreihe vorliegt, und ansonsten EVENT_INDEX.

+ EVENT_COMPLEMENT

Diese Konstante kann optional hinzu addiert werden und kehrt dann die gewählte Operation um. Es werden dann z. B. bei EVENT_EXTRACT die Punkte übernommen, die der Bedingung nicht entsprechen.

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

Ein Spike nach oben wird z. B. erkannt, wenn das Signal um mindestens MinHeight ansteigt und spätestens nach MaxWidth Datenpunkten um mindestens -MinHeight abfällt. Spikes, die sich am Anfang oder Ende des Datensatzes befinden, werden ebenfalls erkannt, d. h. der Datensatzanfang wird als Spike-Anfang und das Datensatzende entsprechend als Spike-Ende betrachtet.

Folgende Grafik zeigt ein Signal mit hervorgehobenen Spikes mit maximale Breite 2 und minimaler Höhe 0,15. Die beiden Spikes am Ende wurden ausgelassen, weil diese zu breit oder nicht hoch genug waren.

Verfügbarkeit

FlexPro Basic, Professional, Developer Suite

Beispiele

Arguments s
Dim idx, y, n
idx = ValuesInSpikes(s, 0.1, 1, EVENT_INDEX)
s.y[idx] = ?
return s
 

Dieses Beispiel sucht nach Spikes in einem Signal und erzeugt ein Signal, in dem alle Werte, die zu Spikes gehören, ungültig gesetzt sind.

Siehe auch

NextValueInSpike-Funktion

Analyseobjekt Ereignisisolation

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren