Learn R Programming

⚠️There's a newer version (1.2.3) of this package.Take me there.

exdex

Estimation of the Extremal Index

What does exdex do?

The extremal index θ is a measure of the degree of local dependence in the extremes of a stationary process. The exdex package performs frequentist inference about θ using two types of methodology.

One type (Northrop, 2015) is based on a model that relates the distribution of block maxima to the marginal distribution of the data, leading to a semiparametric maxima estimator. Two versions of this type of estimator are provided, following Northrop, 2015 and Berghaus and Bücher, 2018). A slightly modified version of the latter is also provided. Estimates are produced using both disjoint and sliding block maxima, that latter providing greater precision of estimation.

The other type of methodology uses a model for the distribution of threshold inter-exceedance times (Ferro and Segers, 2003). Two versions of this type of approach are provided, following Süveges (2007) and Süveges and Davison (2010).

A simple example

The following code estimates the extremal index using the semiparametric maxima estimators, for an example dataset containing a time series of sea surges measured at Newlyn, Cornwall, UK over the period 1971-1976.

library(exdex)
theta <- spm(newlyn, 20)
theta
#> 
#> Call:
#> spm(data = newlyn, b = 20)
#> 
#> Estimates of the extremal index theta:
#>           N2015   BB2018  BB2018b
#> sliding   0.2392  0.3078  0.2578 
#> disjoint  0.2350  0.3042  0.2542
summary(theta)
#> 
#> Call:
#> spm(data = newlyn, b = 20)
#> 
#>                   Estimate Std. Error Bias adj.
#> N2015, sliding      0.2392    0.01990  0.003317
#> BB2018, sliding     0.3078    0.01642  0.003026
#> BB2018b, sliding    0.2578    0.01642  0.053030
#> N2015, disjoint     0.2350    0.02222  0.003726
#> BB2018, disjoint    0.3042    0.02101  0.003571
#> BB2018b, disjoint   0.2542    0.02101  0.053570

Installation

To get the current released version from CRAN:

install.packages("exdex")

Vignette

See vignette("exdex-vignette", package = "exdex") for an overview of the package.

Copy Link

Version

Install

install.packages('exdex')

Monthly Downloads

713

Version

1.0.1

License

GPL (>= 2)

Issues

Pull Requests

Stars

Forks

Maintainer

Paul Northrop

Last Published

August 6th, 2019

Functions in exdex (1.0.1)

confint.spm

Confidence intervals for the extremal index \(\theta\)
confint.kgaps

Confidence intervals for the extremal index \(\theta\)
coef.iwls

Extract Model Coefficients from an "iwls" object
choose_uk

Threshold \(u\) and runs parameter \(K\) diagnostic for the \(K\)-gaps estimator
newlyn

Newlyn sea surges
nobs.iwls

Extract the Number of Observations from an "iwls" object
exdex

exdex: Estimation of the Extremal Index
exdex-internal

Internal exdex functions
iwls

Iterated weighted least squares estimation of the extremal index
kgaps

Maximum likelihood estimation for the \(K\)-gaps model
print.summary.spm

Print method for objects of class "summary.spm"
plot.choose_b

Plot block length diagnostic for the semiparametric maxima estimator
print.iwls

Print method for an "iwls" object
print.kgaps

Print method for a "kgaps" object
nobs.kgaps

Extract the Number of Observations from a "kgaps" object
plot.choose_uk

Plot Threshold \(u\) and runs parameter \(K\) diagnostic for the \(K\)-gaps estimator
spm

Semiparametric maxima estimator of the extremal index
nobs.spm

Extract the Number of Observations from an "spm" object
coef.kgaps

Extract Model Coefficients from a "kgaps" object
summary.kgaps

Summary method for a "kgaps" object
summary.spm

Summary method for an "spm" object
vcov.kgaps

Calculate Variance-Covariance Matrix for a "kgaps" object
sp500

Daily log returns of the Standard and Poor (S&P) 500 index
kgaps_stat

Sufficient statistics for the \(K\)-gaps model
coef.spm

Extract Model Coefficients from an "spm" object
kgaps_imt

Information matrix test under the \(K\)-gaps model
print.spm

Print method for an "spm" object
print.confint_spm

Print method for a confint_spm object
plot.confint_spm

Plot diagnostics for a confint_spm object
print.summary.kgaps

Print method for objects of class "summary.kgaps"
all_max_rcpp

Sliding and disjoint block maxima
vcov.spm

Calculate Variance-Covariance Matrix for an "spm" object
choose_b

Block length diagnostic for the semiparametric maxima estimator