Returns an accumulator function which incrementally computes a harmonic mean.
accumulator function
var accumulator = incrhmean();
var v = accumulator();
// returns null
v = accumulator( 2.0 );
// returns 2.0
v = accumulator( 5.0 );
// returns ~2.86
v = accumulator();
// returns ~2.86
If provided a value, returns an updated harmonic mean; otherwise, returns the current harmonic mean.
Notes
NaN
or a value which, when used in computations, results inNaN
, the accumulated value isNaN
for all future invocations.value
harmonic mean