Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

Struct template variance_impl

boost::accumulators::impl::variance_impl — Iterative calculation of variance.

Synopsis

// In header: <boost/accumulators/statistics_fwd.hpp>

template<typename Sample, typename MeanFeature, typename Tag> 
struct variance_impl : public accumulator_base {
  // construct/copy/destruct
  template<typename Args> variance_impl(Args const &);

  // public member functions
  template<typename Args> void operator()(Args const &);
  result_type result(dont_care) const;
};

Description

Iterative calculation of sample variance according to the formula

Equation 1.31. 


where

Equation 1.32. 


is the estimate of the sample mean and is the number of samples.

Note that the sample variance is not defined for .

A simplification can be obtained by the approximate recursion

Equation 1.33. 


because the difference

Equation 1.34. 


converges to zero as . However, for small the difference can be non-negligible.

variance_impl public construct/copy/destruct

  1. template<typename Args> variance_impl(Args const & args);

variance_impl public member functions

  1. template<typename Args> void operator()(Args const & args);
  2. result_type result(dont_care) const;

PrevUpHomeNext