AVR

Average input X over evaluation cycles.

[SPU AVR X TYP T RS OUT Y]

input	description	data type	value type	default value
X	data to be averaged	number, vector, matrix	variable
TYP	averaging method	number (int.), string	constant
T	averaging parameter, depends on method	number or n.c.	TYP=1→variable TYP≠2→constant
RS	reset flag	number or n.c.	variable
output	description	data type	value type	comment
Y	averaged input data	same type as X	variable

Description

The averaging algorithm is defined by the inputs TYP and T. The atom averages the elements X[i,j]_t over evaluation cycles t (i=row index, j=column index, t=cycle counter) and stores the averaged value in the element Y[i,j]_t.

The cycle counter t is initialized with 0 and incremented by 1 after each evaluation cycle. The cycle counter is reset, if the input RS is set to a value greater than 0. The input RS is checked each time the SPU is started.

infinite average

TYP=0 or linear

T=0

Y[i,j]t={X[i,j]tif t=01t+1(t.Y[i,j]t−1+X[i,j]t)if t>0

running average

TYP=0 or linear

T>0; T is the (integer) number of averaging cycles

Y[i,j]t={1t+1∑z=0tX[i,j]zif 0⩽t<T1T∑z=0T−1X[i,j]t−zif t⩾T

exponential average

TYP=1 or exponential

0<T<1; T is the averaging factor

Y[i,j]t={X[i,j]tif t=0 (or T out of range)T.Y[i,j]t−1+(1−T).X[i,j]tif t>0

minimum

TYP=2 or minimum

T is not used

Y[i,j]t={X[i,j]tif t=0min(Y[i,j]t−1,X[i,j]t)if t>0

maximum

TYP=3 or maximum

T is not used

Y[i,j]t={X[i,j]tif t=0max(Y[i,j]t−1,X[i,j]t)if t>0

power

TYP=4 or power

T is not used

• each input element X_i,j is squared
• same averaging as for TYP=4 is performed
• square root of each output element Y_i,j is taken

See also

<SP-atoms>