NextValueInSpike (FPScript)
Sucht nach dem nächsten Wert in einem Spike ab einer vorgegebenen Position.
Syntax
NextValueInSpike(DataSet, [ Position ], MinHeight, MaxWidth [ , Direction = EVENT_RIGHT ])
Die Syntax der NextValueInSpike-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||
|---|---|---|---|---|---|---|---|
DataSet |
Der zu durchsuchende Datensatz. Erlaubte Datenstrukturen sind Datenreihe und Signal. 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. |
||||||
Position |
Wenn Sie in einem Signal suchen, ist dies der X-Wert, ab dem gesucht werden soll. Wenn Sie in einer Datenreihe suchen, dann ist dies der Index des Wertes, ab dem gesucht werden soll. Ein negativer Index bestimmt hierbei eine Position relativ zum Ende des Datensatzes. Wenn Sie das Argument weglassen oder den Wert Empty übergeben, beginnt die Suche je, nach Suchrichtung, am Anfang oder am Ende des Datensatzes. Der erste bzw. letzte Wert des Datensatzes wird nur berücksichtigt, wenn Sie das Argument weglassen oder den Wert Empty übergeben. 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. |
||||||
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. |
||||||
Direction |
Legt die Suchrichtung der Funktion fest. Das Argument Direction 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_RIGHT 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. Wenn DataSet eine Datenreihe ist, dann ist das Ergebnis der Index des gefundenen Wertes. Ist DataSet ein Signal, dann ist das Ergebnis der X-Wert. Wenn kein nächster Wert in einem Spike gefunden werden konnte, dann wird der Wert Empty als Ergebnis ausgegeben.
Folgende Grafik zeigt ein Signal mit zwei hervorgehobenen Spikes:
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
NextValueInSpike(Signal, , 0.2 V, 1, EVENT_LEFT) |
Sucht in einem Signal ab dem Signalende nach links den nächsten Wert in einem Spike. Die minimale Spike-Höhe ist 0.2 V und die maximale Breite beträgt einen Datenpunkt. Das Ergebnis ist der X-Wert des gefundenen Spike. |
Signal[[NextValueInSpike(Signal, 4.5 s, 0.2 V, 1)]] |
Sucht in einem Signal ab der Position X = 4.5 s nach rechts den nächsten Wert in einem Spike. Das Ergebnis ist der Y-Wert der gefundenen Stelle. |