NextExtremum (FPScript)
Sucht nach dem nächsten Extremum ab einer vorgegebenen Position.
Syntax
NextExtremum(DataSet, [ Position ], Hysteresis, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])
Die Syntax der NextExtremum-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||
|---|---|---|---|---|---|---|---|---|---|
DataSet |
Ist 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. |
||||||||
Hysteresis |
Der Mindestbetrag, um den das Signal nach dem Extremum abfallen bzw. ansteigen muss, damit das Extremum akzeptiert 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. |
||||||||
Orientation |
Gibt an, ob nach Minima, Maxima oder beidem gesucht werden soll. Das Argument Orientation 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_BOTH gesetzt. |
||||||||
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
Das Ergebnis hat immer die Datenstruktur Einzelwert.
Das lokale Extremum im Datensatz wird über eine Hysteresebetrachtung ermittelt. Ein Wert wird als lokales Maximum erkannt, wenn die vorhergehenden Werte im Datensatz um mindestens den angegebenen Hysteresebetrag ansteigen und die nachfolgenden Werte um mindestens den angegebenen Hysteresebetrag abfallen. Ein Wert wird als lokales Minimum erkannt, wenn die vorhergehenden Werte im Datensatz um mindestens den angegebenen Hysteresebetrag abfallen und die nachfolgenden Werte um mindestens den angegebenen Hysteresebetrag ansteigen.
Wenn DataSet eine Datenreihe ist, dann ist das Ergebnis der Index des gefundenen Extremums. Ist DataSet ein Signal, dann ist das Ergebnis der X-Wert des Extremums. Wenn kein Extremum gefunden werden konnte, dann wird der Wert Empty als Ergebnis ausgegeben.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
NextExtremum(Signal, , 0.1 V, EVENT_POSITIVE, EVENT_LEFT) |
Sucht in einem Signal ab dem Signalende nach links das nächste lokale Maximum. Die Hysterese ist 0.1 V. Das Ergebnis ist der X-Wert des gefundenen Extremum. |
Signal[[NextExtremum(Signal, 4.5 s, 0.1 V)]] |
Sucht in einem Signal ab der Position X = 4.5 s nach rechts das nächste lokale Minimum oder Maximum. Die Hysterese ist 0.1 V. Das Ergebnis ist der Y-Wert des gefundenen Extremum. |