tsxtreme-package {tsxtreme} | R Documentation |
Bayesian Modelling of Extremal Dependence in Time Series
Description
Characterisation of the extremal dependence structure of time series, avoiding pre-processing and filtering as done typically with peaks-over-threshold methods. It uses the conditional approach of Heffernan and Tawn (2004) <DOI:10.1111/j.1467-9868.2004.02050.x> which is very flexible in terms of extremal and asymptotic dependence structures, and Bayesian methods improve efficiency and allow for deriving measures of uncertainty. For example, the extremal index, related to the size of clusters in time, can be estimated and samples from its posterior distribution obtained.
Details
Index of help topics:
bayesfit Traces from MCMC output bayesparams Parameters for the semi-parametric approach dep2fit Dependence model fit (stepwise) depfit Dependence model fit depmeasure Dependence measures estimates depmeasures Estimate dependence measures dlapl The Laplace Distribution stepfit Estimates from stepwise fit theta2fit Fit time series extremes thetaruns Runs estimator tsxtreme-package Bayesian Modelling of Extremal Dependence in Time Series
The Heffernan–Tawn conditional formulation for a stationary time series (X_t)
with Laplace marginal distribution states that for a large enough threshold u
there exist scale parameters -1 \le\alpha_j\le 1
and 0 \le \beta_j \le 1
such that
Pr\left(\frac{X_j-\alpha_j X_0}{(X_j)^{\beta_j}} < z_j, j=1,\ldots,m \mid X_0 > u\right) = H(z_1,\ldots,z_m),
with H
non-degenerate; the equality holds exactly only when u
tends to infinity.
There are mainly 3 functions provided by this package, which allow estimation of extremal dependence measures and fitting the Heffernan–Tawn model using Dirichlet processes.
depfit
fits the Heffernan–Tawn model using a Bayesian semi-parametric approach.
thetafit
computes posterior samples of the threshold-based index of Ledford and Tawn (2003) based on inference in depfit
.
chifit
computes posterior samples of the extremal measure of dependence of Coles, Heffernan and Tawn (1999) at any extremal level.
Some corresponding functions using the stepwise approach of Heffernan and Tawn (2004) are also part of the package, namely dep2fit
and theta2fit
.
The empirical estimation of the extremal index can be done using thetaruns
and some basic functions handling the Laplace distribution are also available in dlapl
.
Author(s)
Thomas Lugrin
Maintainer: Thomas Lugrin <thomas.lugrin@alumni.epfl.ch>
References
Coles, S., Heffernan, J. E. and Tawn, J. A. (1999) Dependence measures for extreme value analyses. Extremes, 2, 339–365.
Davison, A. C. and Smith, R. L. (1990) Models for exceedances over high thresholds. Journal of the Royal Statistical Society Series B, 52, 393–442.
Heffernan, J. E. and Tawn, J. A. (2004) A conditional approach for multivariate extreme values. Journal of the Royal Statistical Society Series B, 66, 497–546.
Ledford, W. A. and Tawn, J. A. (2003) Diagnostics for dependence within time series extremes. Journal of the Royal Statistical Society Series B, 65, 521–543.
Lugrin, T., Davison, A. C. and Tawn, J. A. (2016) Bayesian uncertainty management in temporal dependence of extremes. Extremes, 19, 491–515.