Extrema (FPScript)
Sucht nach lokalen Minima und/oder Maxima in einem Datensatz.
Syntax
Extrema(DataSet, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])
Die Syntax der Extrema-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. |
||||||||||||
Hysteresis |
Gibt den Betrag an, um den die Signalamplitude nach der Erkennung eines lokalen Maximums bzw. Minimums mindestens fallen bzw. steigen muss, damit es als lokales 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. |
||||||||||||
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
Die lokalen Extrema im Datensatz werden ü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.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
Extrema({1, 3, 5, 4, 1}, 1, EVENT_BOTH, EVENT_EXTRACT) |
Ergibt 5. |