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

Click here to view the latest version of this page.
PrevUpHomeNext

Struct template peaks_over_threshold_impl

boost::accumulators::impl::peaks_over_threshold_impl — Peaks over Threshold Method for Quantile and Tail Mean Estimation.

Synopsis

template<typename Sample, typename LeftRight> 
struct peaks_over_threshold_impl {
  // types
  typedef numeric::functional::average< Sample, std::size_t >::result_type float_type; 
  typedef boost::tuple< float_type, float_type, float_type >               result_type;
  typedef mpl::int_< is_same< LeftRight, left >::value?-1:1 >              sign;       

  // construct/copy/destruct
  template<typename Args> peaks_over_threshold_impl(Args const &);

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

Description

According to the theorem of Pickands-Balkema-de Haan, the distribution function of the excesses over some sufficiently high threshold of a distribution function may be approximated by a generalized Pareto distribution

Equation1.3.


with suitable parameters and that can be estimated, e.g., with the method of moments, cf. Hosking and Wallis (1987),

Equation1.4.


and being the empirical mean and variance of the samples over the threshold . Equivalently, the distribution function of the exceedances can be approximated by . Since for the distribution function can be written as

Equation1.5.


and the probability can be approximated by the empirical distribution function evaluated at , an estimator of is given by

Equation1.6.


It can be shown that is a generalized Pareto distribution with and . By inverting , one obtains an estimator for the -quantile,

Equation1.7.


and similarly an estimator for the (coherent) tail mean,

Equation1.8.


cf. McNeil and Frey (2000).

Note that in case extreme values of the left tail are fitted, the distribution is mirrored with respect to the axis such that the left tail can be treated as a right tail. The computed fit parameters thus define the Pareto distribution that fits the mirrored left tail. When quantities like a quantile or a tail mean are computed using the fit parameters obtained from the mirrored data, the result is mirrored back, yielding the correct result.

For further details, see

J. R. M. Hosking and J. R. Wallis, Parameter and quantile estimation for the generalized Pareto distribution, Technometrics, Volume 29, 1987, p. 339-349

A. J. McNeil and R. Frey, Estimation of Tail-Related Risk Measures for Heteroscedastic Financial Time Series: an Extreme Value Approach, Journal of Empirical Finance, Volume 7, 2000, p. 271-300

peaks_over_threshold_impl public construct/copy/destruct

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

peaks_over_threshold_impl public member functions

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

PrevUpHomeNext