Returns an accumulator function which incrementally computes a moving geometric mean.
W
parameter defines the number of values over which to compute the moving geometric mean.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
accumulator function
var accumulator = incrmgmean( 3 );
var v = accumulator();
// returns null
v = accumulator( 2.0 );
// returns 2.0
v = accumulator( 5.0 );
// returns ~3.16
v = accumulator( 3.0 );
// returns ~3.11
v = accumulator( 5.0 );
// returns ~4.22
v = accumulator();
// returns ~4.22
If provided a value, returns an updated geometric mean; otherwise, returns the current geometric mean.
Notes
NaN
or a value which, when used in computations, results inNaN
, the accumulated value isNaN
for all future invocations.NaN
for all future invocations.value
geometric mean