diff options
Diffstat (limited to 'doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html')
-rw-r--r-- | doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html | 64 |
1 files changed, 32 insertions, 32 deletions
diff --git a/doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html b/doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html index 56965a0137..d2b4f0546f 100644 --- a/doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html +++ b/doc/html/boost/accumulators/impl/peaks_over_threshold_impl.html @@ -8,7 +8,7 @@ <link rel="home" href="../../../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> <link rel="up" href="../../../accumulators/reference.html#header.boost.accumulators.statistics.peaks_over_threshold_hpp" title="Header <boost/accumulators/statistics/peaks_over_threshold.hpp>"> <link rel="prev" href="../extract/peaks_over_threshold.html" title="Global peaks_over_threshold"> -<link rel="next" href="../tag/abstract_peak_idp360025824.html" title="Struct abstract_peaks_over_threshold"> +<link rel="next" href="../tag/abstract_peak_idp430074832.html" title="Struct abstract_peaks_over_threshold"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table cellpadding="2" width="100%"><tr> @@ -21,7 +21,7 @@ </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="../extract/peaks_over_threshold.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../accumulators/reference.html#header.boost.accumulators.statistics.peaks_over_threshold_hpp"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../tag/abstract_peak_idp360025824.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="../extract/peaks_over_threshold.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../accumulators/reference.html#header.boost.accumulators.statistics.peaks_over_threshold_hpp"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../tag/abstract_peak_idp430074832.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> </div> <div class="refentry"> <a name="boost.accumulators.impl.peaks_over_threshold_impl"></a><div class="titlepage"></div> @@ -40,64 +40,64 @@ <span class="keyword">typedef</span> <span class="identifier">mpl</span><span class="special">::</span><span class="identifier">int_</span><span class="special"><</span> <span class="identifier">is_same</span><span class="special"><</span> <span class="identifier">LeftRight</span><span class="special">,</span> <a class="link" href="../left.html" title="Struct left">left</a> <span class="special">></span><span class="special">::</span><span class="identifier">value</span><span class="special">?</span><span class="special">-</span><span class="number">1</span><span class="special">:</span><span class="number">1</span> <span class="special">></span> <a name="boost.accumulators.impl.peaks_over_threshold_impl.sign"></a><span class="identifier">sign</span><span class="special">;</span> <span class="comment">// <a class="link" href="peaks_over_threshold_impl.html#boost.accumulators.impl.peaks_over_threshold_implconstruct-copy-destruct">construct/copy/destruct</a></span> - <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <a class="link" href="peaks_over_threshold_impl.html#idp360023120-bb"><span class="identifier">peaks_over_threshold_impl</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> + <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <a class="link" href="peaks_over_threshold_impl.html#idp430072128-bb"><span class="identifier">peaks_over_threshold_impl</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> - <span class="comment">// <a class="link" href="peaks_over_threshold_impl.html#idp360017360-bb">public member functions</a></span> - <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="keyword">void</span> <a class="link" href="peaks_over_threshold_impl.html#idp360017920-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> - <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="identifier">result_type</span> <a class="link" href="peaks_over_threshold_impl.html#idp360020304-bb"><span class="identifier">result</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span> + <span class="comment">// <a class="link" href="peaks_over_threshold_impl.html#idp430066368-bb">public member functions</a></span> + <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="keyword">void</span> <a class="link" href="peaks_over_threshold_impl.html#idp430066928-bb"><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span><span class="special">;</span> + <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="identifier">result_type</span> <a class="link" href="peaks_over_threshold_impl.html#idp430069312-bb"><span class="identifier">result</span></a><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span><span class="special">)</span> <span class="keyword">const</span><span class="special">;</span> <span class="special">}</span><span class="special">;</span></pre></div> <div class="refsect1"> -<a name="idp108869696"></a><h2>Description</h2> -<p>According to the theorem of Pickands-Balkema-de Haan, the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_23.png"></span> of the excesses <span class="inlinemediaobject"><img src="../../../images/accumulators//form_24.png"></span> over some sufficiently high threshold <span class="inlinemediaobject"><img src="../../../images/accumulators//form_25.png"></span> of a distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_26.png"></span> may be approximated by a generalized Pareto distribution </p> +<a name="idp90793328"></a><h2>Description</h2> +<p>According to the theorem of Pickands-Balkema-de Haan, the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_90.png"></span> of the excesses <span class="inlinemediaobject"><img src="../../../images/accumulators//form_91.png"></span> over some sufficiently high threshold <span class="inlinemediaobject"><img src="../../../images/accumulators//form_92.png"></span> of a distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_93.png"></span> may be approximated by a generalized Pareto distribution </p> <div class="equation"> -<a name="idp108880176"></a><p class="title"><b>Equation 1.1. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_27.png" align="middle"></div></div> +<a name="idp90803680"></a><p class="title"><b>Equation 1.1. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_94.png" align="middle"></div></div> </div> -<p><br class="equation-break"> with suitable parameters <span class="inlinemediaobject"><img src="../../../images/accumulators//form_28.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_29.png"></span> that can be estimated, e.g., with the method of moments, cf. Hosking and Wallis (1987), </p> +<p><br class="equation-break"> with suitable parameters <span class="inlinemediaobject"><img src="../../../images/accumulators//form_88.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_95.png"></span> that can be estimated, e.g., with the method of moments, cf. Hosking and Wallis (1987), </p> <div class="equation"> -<a name="idp108888912"></a><p class="title"><b>Equation 1.2. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_30.png" align="middle"></div></div> +<a name="idp90812416"></a><p class="title"><b>Equation 1.2. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_96.png" align="middle"></div></div> </div> -<p><br class="equation-break"> <span class="inlinemediaobject"><img src="../../../images/accumulators//form_31.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_32.png"></span> being the empirical mean and variance of the samples over the threshold <span class="inlinemediaobject"><img src="../../../images/accumulators//form_25.png"></span>. Equivalently, the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_33.png"></span> of the exceedances <span class="inlinemediaobject"><img src="../../../images/accumulators//form_34.png"></span> can be approximated by <span class="inlinemediaobject"><img src="../../../images/accumulators//form_35.png"></span>. Since for <span class="inlinemediaobject"><img src="../../../images/accumulators//form_36.png"></span> the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_26.png"></span> can be written as </p> +<p><br class="equation-break"> <span class="inlinemediaobject"><img src="../../../images/accumulators//form_97.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_98.png"></span> being the empirical mean and variance of the samples over the threshold <span class="inlinemediaobject"><img src="../../../images/accumulators//form_92.png"></span>. Equivalently, the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_99.png"></span> of the exceedances <span class="inlinemediaobject"><img src="../../../images/accumulators//form_100.png"></span> can be approximated by <span class="inlinemediaobject"><img src="../../../images/accumulators//form_101.png"></span>. Since for <span class="inlinemediaobject"><img src="../../../images/accumulators//form_102.png"></span> the distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_93.png"></span> can be written as </p> <div class="equation"> -<a name="idp108911664"></a><p class="title"><b>Equation 1.3. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_37.png" align="middle"></div></div> +<a name="idp90835168"></a><p class="title"><b>Equation 1.3. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_103.png" align="middle"></div></div> </div> -<p><br class="equation-break"> and the probability <span class="inlinemediaobject"><img src="../../../images/accumulators//form_38.png"></span> can be approximated by the empirical distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_39.png"></span> evaluated at <span class="inlinemediaobject"><img src="../../../images/accumulators//form_25.png"></span>, an estimator of <span class="inlinemediaobject"><img src="../../../images/accumulators//form_26.png"></span> is given by </p> +<p><br class="equation-break"> and the probability <span class="inlinemediaobject"><img src="../../../images/accumulators//form_104.png"></span> can be approximated by the empirical distribution function <span class="inlinemediaobject"><img src="../../../images/accumulators//form_105.png"></span> evaluated at <span class="inlinemediaobject"><img src="../../../images/accumulators//form_92.png"></span>, an estimator of <span class="inlinemediaobject"><img src="../../../images/accumulators//form_93.png"></span> is given by </p> <div class="equation"> -<a name="idp108924224"></a><p class="title"><b>Equation 1.4. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_40.png" align="middle"></div></div> +<a name="idp90847728"></a><p class="title"><b>Equation 1.4. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_106.png" align="middle"></div></div> </div> -<p><br class="equation-break"> It can be shown that <span class="inlinemediaobject"><img src="../../../images/accumulators//form_41.png"></span> is a generalized Pareto distribution <span class="inlinemediaobject"><img src="../../../images/accumulators//form_42.png"></span> with <span class="inlinemediaobject"><img src="../../../images/accumulators//form_43.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_44.png"></span>. By inverting <span class="inlinemediaobject"><img src="../../../images/accumulators//form_41.png"></span>, one obtains an estimator for the <span class="inlinemediaobject"><img src="../../../images/accumulators//form_45.png"></span>-quantile, </p> +<p><br class="equation-break"> It can be shown that <span class="inlinemediaobject"><img src="../../../images/accumulators//form_107.png"></span> is a generalized Pareto distribution <span class="inlinemediaobject"><img src="../../../images/accumulators//form_108.png"></span> with <span class="inlinemediaobject"><img src="../../../images/accumulators//form_109.png"></span> and <span class="inlinemediaobject"><img src="../../../images/accumulators//form_110.png"></span>. By inverting <span class="inlinemediaobject"><img src="../../../images/accumulators//form_107.png"></span>, one obtains an estimator for the <span class="inlinemediaobject"><img src="../../../images/accumulators//form_20.png"></span>-quantile, </p> <div class="equation"> -<a name="idp108941824"></a><p class="title"><b>Equation 1.5. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_46.png" align="middle"></div></div> +<a name="idp90865328"></a><p class="title"><b>Equation 1.5. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_111.png" align="middle"></div></div> </div> <p><br class="equation-break"> and similarly an estimator for the (coherent) tail mean, </p> <div class="equation"> -<a name="idp108944848"></a><p class="title"><b>Equation 1.6. </b></p> -<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_47.png" align="middle"></div></div> +<a name="idp90868352"></a><p class="title"><b>Equation 1.6. </b></p> +<div class="equation-contents"><div class="mediaobject" align="center"><img src="../../../images/accumulators//form_85.png" align="middle"></div></div> </div> <p><br class="equation-break"> cf. McNeil and Frey (2000).</p> -<p>Note that in case extreme values of the left tail are fitted, the distribution is mirrored with respect to the <span class="inlinemediaobject"><img src="../../../images/accumulators//form_48.png"></span> 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.</p> +<p>Note that in case extreme values of the left tail are fitted, the distribution is mirrored with respect to the <span class="inlinemediaobject"><img src="../../../images/accumulators//form_112.png"></span> 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.</p> <p>For further details, see</p> <p>J. R. M. Hosking and J. R. Wallis, Parameter and quantile estimation for the generalized Pareto distribution, Technometrics, Volume 29, 1987, p. 339-349</p> <p>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</p> <p> </p> <div class="refsect2"> -<a name="idp108952400"></a><h3> +<a name="idp90875904"></a><h3> <a name="boost.accumulators.impl.peaks_over_threshold_implconstruct-copy-destruct"></a><code class="computeroutput">peaks_over_threshold_impl</code> public construct/copy/destruct</h3> -<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <a name="idp360023120-bb"></a><span class="identifier">peaks_over_threshold_impl</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span><span class="special">;</span></pre></li></ol></div> +<div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <a name="idp430072128-bb"></a><span class="identifier">peaks_over_threshold_impl</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span><span class="special">;</span></pre></li></ol></div> </div> <div class="refsect2"> -<a name="idp108963152"></a><h3> -<a name="idp360017360-bb"></a><code class="computeroutput">peaks_over_threshold_impl</code> public member functions</h3> +<a name="idp90886592"></a><h3> +<a name="idp430066368-bb"></a><code class="computeroutput">peaks_over_threshold_impl</code> public member functions</h3> <div class="orderedlist"><ol class="orderedlist" type="1"> -<li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="keyword">void</span> <a name="idp360017920-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span><span class="special">;</span></pre></li> -<li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="identifier">result_type</span> <a name="idp360020304-bb"></a><span class="identifier">result</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre></li> +<li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="keyword">void</span> <a name="idp430066928-bb"></a><span class="keyword">operator</span><span class="special">(</span><span class="special">)</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span><span class="special">;</span></pre></li> +<li class="listitem"><pre class="literallayout"><span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Args<span class="special">></span> <span class="identifier">result_type</span> <a name="idp430069312-bb"></a><span class="identifier">result</span><span class="special">(</span><span class="identifier">Args</span> <span class="keyword">const</span> <span class="special">&</span> args<span class="special">)</span> <span class="keyword">const</span><span class="special">;</span></pre></li> </ol></div> </div> </div> @@ -112,7 +112,7 @@ </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="../extract/peaks_over_threshold.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../accumulators/reference.html#header.boost.accumulators.statistics.peaks_over_threshold_hpp"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../tag/abstract_peak_idp360025824.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="../extract/peaks_over_threshold.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../../accumulators/reference.html#header.boost.accumulators.statistics.peaks_over_threshold_hpp"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../tag/abstract_peak_idp430074832.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a> </div> </body> </html> |