Returns an accumulator function which incrementally computes a moving coefficient of variation (CV).
W
parameter defines the number of values over which to compute the moving coefficient of variation.W
values are needed to fill the window buffer, the first W-1
returned values are calculated from smaller sample sizes. Until the window is full, each returned value is calculated from all provided values.window size
mean value
accumulator function
var accumulator = incrmcv( 3 );
var cv = accumulator();
// returns null
cv = accumulator( 2.0 );
// returns 0.0
cv = accumulator( 1.0 );
// returns ~0.47
cv = accumulator( 3.0 );
// returns 0.5
cv = accumulator( 7.0 );
// returns ~0.83
cv = accumulator();
// returns ~0.83
var accumulator = incrmcv( 3, 2.0 );
If provided a value, the accumulator function returns an updated accumulated value. If not provided a value, the accumulator function returns the current accumulated value.
Notes
NaN
or a value which, when used in computations, results inNaN
, the accumulated value isNaN
for all future invocations.value
accumulated value or null