Maximum (FPScript)

21.09.2021

Ermittelt einzelne, gleitende oder Blockmaxima für einen Datensatz.

Syntax

Maximum(DataSet, [ Mode = PROCESS_COLUMNS ] [ , IntervalWidth ])

 

Die Syntax der Maximum-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Der auszuwertende Datensatz.

Es sind alle Datenstrukturen erlaubt. 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.

Mode

Gibt an, wie Datenmatrizen und Signalreihen verarbeitet werden sollen und ob einzelne, gleitende oder Blockmaxima ermittelt werden sollen. Wenn Sie das Argument weglassen, erfolgt die spaltenweise Ermittlung von Einzelmaxima.

Das Argument Mode kann folgende Werte haben:

Konstante

Bedeutung

PROCESS_COLUMNS

Die Bearbeitung erfolgt spaltenweise. Das Ergebnis enthält einen Wert pro Spalte.

PROCESS_ROWS

Die Bearbeitung erfolgt zeilenweise. Das Ergebnis enthält einen Wert pro Zeile.

PROCESS_COMPLETE

Die Bearbeitung erfolgt global. Das Ergebnis enthält einen Wert für den ganzen Datensatz.

...plus einer optionalen Konstanten, die die Berechnungsweise bestimmt:

Konstante

Bedeutung

+ CALC_BLOCK

Blockweise Berechnung. Pro Intervall wird ein Wert berechnet.

+ CALC_MOVING

Gleitende Berechnung. Für jeden Wert im Datensatz wird ein Resultat im angegebenen Intervall ermittelt.

Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert PROCESS_COLUMNS gesetzt.

IntervalWidth

Dieses Argument wird für die Ermittlung von gleitenden und Blockmaxima benötigt. Die Intervallbreite gibt dann die Anzahl der zu betrachtenden Werte an. Die Breite sollte eine ungerade Zahl sein. Ansonsten ist das Intervall unsymmetrisch und es wird rechts vom Zentrum ein Wert mehr als links davon in die Suche einbezogen.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt.

Der Wert muss größer gleich 1 sein.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Anmerkungen

Wenn DataSet ein Einzelwert ist, so wird er unverändert zurückgegeben. Bei Signalen und Signalreihen wird die Y-Komponente verarbeitet und die X- bzw. Z-Komponente nach Möglichkeit übernommen. Bei der Berechnung von gleitenden und Blockmaxima entspricht die Datenstruktur des Ergebnisses der des Argumentes. Wenn ansonsten DataSet eine Datenreihe oder ein Signal ist, ist das Ergebnis ein Einzelwert mit dem gesuchten Maximum. Andernfalls ist das Ergebnis eine Datenreihe bzw. ein Signal mit einem Maximum pro Spalte bzw. Zeile.

Verfügbarkeit

FlexPro View, Basic, Professional, Developer Suite

Beispiele

Maximum({4, 6})

Ergibt 6.

Maximum({4, 6, 9, 3, 5, 4})

Ergibt 9.

Maximum({4, 6, 9, 3, 5, 4}, PROCESS_COLUMNS + CALC_MOVING, 3)

Ergibt {6, 9, 9, 9, 5, 5}.

Maximum({4, 6, 9, 3, 5, 4}, PROCESS_COLUMNS + CALC_BLOCK, 3)

Ergibt {9, 5}.

Siehe auch

Minimum-Funktion

Range-Funktion

GlobalMaximum-Funktion

Analyseobjekt Statistische Kenngröße

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren