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

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

Struct template variance_impl

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


// 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;
  template<typename Archive> void serialize(Archive &, const unsigned int);


Iterative calculation of sample variance according to the formula

Equation 1.36. 


Equation 1.37. 

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.38. 

because the difference

Equation 1.39. 

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;
  3. template<typename Archive> 
      void serialize(Archive & ar, const unsigned int file_version);