Mean (FPScript)

07.02.2018
 Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Statistik > Mean

Mean (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

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

Mean (FPScript)

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

Syntax

Mean(DataSet, [ Mode = MEAN_ARITHMETIC + PROCESS_ROWS ] [ , IntervalWidth ])

 

Die Syntax der Mean-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Der zu durchsuchende Datensatz.

Es sind alle Datenstrukturen erlaubt. Es sind alle numerischen Datentypen erlaubt.

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

Wählt die Art des Mittelwertes aus. Gibt an, wie Datenmatrizen und Signalreihen verarbeitet werden sollen und ob einzelne, gleitende oder Blockmittelwerte ermittelt werden sollen.

Das Argument Mode kann folgende Werte haben:

Konstante

Bedeutung

MEAN_ARITHMETIC

Es wird der arithmetische Mittelwert berechnet.

MEAN_SQUARE

Es wird der quadratische Mittelwert berechnet.

Dieser wird auch "Root Mean Square (RMS)" genannt.

MEAN_GEOMETRIC

Es wird der geometrische Mittelwert berechnet.

MEAN_HARMONIC

Es wird der harmonische Mittelwert berechnet.

...plus einer Konstante, die die Verarbeitung von Datenmatrizen und Signalreihen bestimmt...

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.

... plus einer optionalen Konstanten, die den Typ des Mittelwertes 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.

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 MEAN_ARITHMETIC + PROCESS_ROWS gesetzt.

IntervalWidth

Dieses Argument wird für die Ermittlung von gleitenden und Blockmittelwerte 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 Berechnung 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

Ein Einzelwert wird 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 Blockmittelwerten 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 Mittelwert, andernfalls ist das Ergebnis eine Datenreihe bzw. ein Signal mit einem Mittelwert pro Spalte bzw. Zeile.

Ist DataSet komplex, so werden Betrag und Phase getrennt gemittelt. Der Datentyp des Ergebnisses ist reelle oder komplexe 64-Bit Fließkommazahl.

Verfügbarkeit

FlexPro View, Standard, Professional, Developer Suite

Beispiele

Mean({2, 5, 8, 6, 4})

Ergibt 5.

Mean({1, 2, 3, 4, 5, 6}, PROCESS_COLUMNS + CALC_MOVING, 3)

Ergibt {1.5, 2, 3, 4, 5, 5.5}.

Mean({1, 2, 3, 4, 5, 6}, PROCESS_COLUMNS + CALC_BLOCK, 3)

Ergibt {2, 5}.

Siehe auch

Quantile-Funktion

Analyseobjekt Statistische Kenngröße

Share article or send as email:

You might be interested in these articles