GlobalMaximum (FPScript)

07.02.2018
 Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Ereignisisolation > GlobalMaximum

GlobalMaximum (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

  Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Ereignisisolation >

GlobalMaximum (FPScript)

Sucht nach dem globalen Maximum in einem Datensatz.

Syntax

GlobalMaximum(DataSet [ , Operation ])

 

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

Operation

Legt die Arbeitsweise der Funktion fest. Wenn Sie das Argument weglassen, liefert die Funktion bei Datenreihen und Signalen den Index des gefundenen Maximums als Einzelwert. Bei Datenmatrizen und Signalreihen wird in diesem Fall EVENT_SETVOID verwendet.

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_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.

Anmerkungen

Das globale Maximum ist der betragsmäßig größte Wert im Datensatz. Wenn mehrere solcher Werte existieren, wird nur der erste als globales Maximum anerkannt. Verwenden Sie die Funktion GlobalExtrema, wenn Sie in diesem Fall alle Vorkommnisse finden möchten. Die Operationen EVENT_EXTRACT und EVENT_INDEX sind für Datenmatrizen und Signalreihen nicht erlaubt.

Verfügbarkeit

FlexPro Standard, Professional, Developer Suite

Beispiele

GlobalMaximum({1,4,3,7,4,5})

Ergibt 3L. Das Ergebnis ist der Index des höchsten Wertes als Einzelwert.

GlobalMaximum({1,4,3,7,4,5}, EVENT_INDEX)

Ergibt {3L}. Das Ergebnis ist der Index des höchsten Wertes als Datenreihe.

Siehe auch

GlobalMinimum-Funktion

GlobalExtrema-Funktion

NextGlobalExtremum-Funktion

Maximum-Funktion

Analyseobjekt Ereignisisolation

Share article or send as email:

You might be interested in these articles