weisang.com > Dokumentation > GlobalExtrema (FPScript)

FlexPro-Dokumentation

GlobalExtrema (FPScript)

21.09.2021

Sucht nach globalen Minima und/oder Maxima in einem Datensatz.

GlobalExtrema(DataSet, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])

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

Orientation

Gibt an, ob nach Minima, Maxima oder beidem gesucht werden soll.

Das Argument Orientation kann folgende Werte haben:

Konstante	Bedeutung
EVENT_POSITIVE	Nur nach globalen Maxima suchen.
EVENT_NEGATIVE	Nur nach globalen Minima suchen.
EVENT_BOTH	Nach globalen Minima und Maxima suchen.

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:

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.

Globale Maxima bzw. Minima sind alle Vorkommen des größten bzw. kleinsten Wertes im Datensatz.

FlexPro Basic, Professional, Developer Suite

GlobalExtrema({1, 3, 5, 4, 1}, EVENT_BOTH, EVENT_INDEX)

Ergibt {0L, 2L, 4L}. Das Minimum kommt zweimal vor.

Artikel teilen oder als Email versenden: