AbsoluteDeviationFromMean (FPScript)
Ermittelt die mittlere absolute Abweichung vom Mittelwert eines Datensatzes. Es werden die Differenzen jeden Wertes zum Mittelwert des Datensatzes ermittelt und davon der Durchschnitt berechnet.
Syntax
AbsoluteDeviationFromMean(DataSet, [ Mode = PROCESS_ROWS ] [ , IntervalWidth ])
Die Syntax der AbsoluteDeviationFromMean-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. Das Argument Mode kann folgende Werte haben:
Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert PROCESS_ROWS gesetzt. |
IntervalWidth |
Dieses Argument wird für die Ermittlung von gleitenden und Blockabweichungen vom Mittelwert 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
Das Ergebnis ist immer vom Datentyp 64-Bit Fließkomma.
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 Blockabweichungen vom Mittelwert entspricht die Datenstruktur des Ergebnisses der des Argumentes. Wenn ansonsten DataSet eine Datenreihe oder ein Signal ist, ist das Ergebnis ein Einzelwert mit der gesuchten mittleren absoluten Abweichung, andernfalls ist das Ergebnis eine Datenreihe bzw. ein Signal mit einer mittleren absoluten Abweichung pro Spalte bzw. Zeile.
Verfügbarkeit
FlexPro Basic, Professional, Developer Suite
Beispiele
AbsoluteDeviationFromMean({1, 4, 7}) |
Ergibt 2.0. Der Mittelwert der Datenreihe ist 4. Der erste und der dritte Wert weichen jeweils um 3 vom Mittelwert ab. Das Ergebnis berechnet sich somit aus (3 + 0 + 3) / 3. |
AbsoluteDeviationFromMean({{1, 4, 7}, {1, 4, 7}}) |
Ergibt {0.0, 0.0, 0.0}. Die Funktion berechnet aus der Matrix zeilenweise die mittlere absolute Abweichung vom Mittelwert. |
AbsoluteDeviationFromMean({{1, 4, 7}, {1, 4, 7}}, PROCESS_COLUMNS) |
Ergibt {2.0, 2.0}. Die Funktion berechnet aus der Matrix spaltenweise die mittlere absolute Abweichung vom Mittelwert. |
AbsoluteDeviationFromMean({1, 2, 3, 2, 1}, CALC_MOVING, 3) |
Ergibt { 0.5, 0.6666666666666666, 0.4444444444444445, 0.6666666666666666, 0.5 }. Die Funktion berechnet die gleitende mittlere absolute Abweichung vom Mittelwert für {1, 2}, {1, 2, 3}, {2, 3, 2}, {3, 2, 1} und {2, 1}. |
AbsoluteDeviationFromMean({1, 2, 3, 4, 4.5, 5}, CALC_BLOCK, 3) |
Ergibt { 0.6666666666666666, 0.3333333333333333 }. Die Funktion berechnet blockweise die mittlere absolute Abweichung vom Mittelwert für {1, 2, 3} und {4, 4.5, 5}. |