vsip_dvexpoavg_p - Vector Exponential Average

Core

This manual is preliminary and incomplete.
While our Core implementation implements all functions given in the standard we are still working on completing this documentation.

Please refer to the VSIPL standard for a complete function reference of the Core profile until we have completed work on this documentation.

[next] [prev] [prev-tail] [tail] [up]

4.3.19 vsip_dvexpoavg_p - Vector Exponential Average

void vsip_vexpoavg_f(vsip_scalar_f alpha, const vsip_vview_f *b, const vsip_vview_f *c); 
void vsip_cvexpoavg_f(vsip_cscalar_f alpha, const vsip_cvview_f *b, const vsip_cvview_f *c);

Description

This function computes the exponential average (also known as exponential moving average or first-order IIR filtering) of a vector. It updates the accumulator vector $c$ using the input vector $b$ and a smoothing factor $α$ . The operation performs element-wise exponential averaging:

ci= α·bi+(1- α)·ci

for all $i$ from 0 to $n-1$ , where $n$ is the length of the vectors, $α$ is the smoothing factor $0< α≤ 1$ , $bi$ is the current input value, and $ci$ is the accumulated average value.

The smoothing factor $α$ determines the weight of the new data relative to the accumulated average:

Smaller $α$ values (closer to 0) give more weight to the accumulated average (more smoothing)
Larger $α$ values (closer to 1) give more weight to the new data (less smoothing)

Parameters

vsip_dscalar_p alpha: Smoothing factor.
const vsip_dvview_p* b: Input vector containing the new data values.
const vsip_dvview_p* c: Input/Output vector that contains the accumulated average values on input and will store the updated averages on output.

Notes

Both vectors must have the same length.
The smoothing factor $α$ should be in the range $(0,1]$ . Values outside this range may lead to numerical instability.

[next] [prev] [prev-tail] [front] [up]