infomat.test: Information matrix test statistic and MLE for the extremal...

View source: R/infomattest.R

infomat.testR Documentation

Information matrix test statistic and MLE for the extremal index

Description

The Information Matrix Test (IMT), proposed by Suveges and Davison (2010), is based on the difference between the expected quadratic score and the second derivative of the log-likelihood. The asymptotic distribution for each threshold u and gap K is asymptotically \chi^2 with one degree of freedom. The approximation is good for N>80 and conservative for smaller sample sizes. The test assumes independence between gaps.

Usage

infomat.test(xdat, thresh, q, K, plot = TRUE, ...)

Arguments

xdat

data vector

thresh

threshold vector

q

vector of probability levels to define threshold if thresh is missing.

K

int specifying the largest K-gap

plot

logical: should the graphical diagnostic be plotted?

...

additional arguments, currently ignored

Details

The procedure proposed in Suveges & Davison (2010) was corrected for erratas. The maximum likelihood is based on the limiting mixture distribution of the intervals between exceedances (an exponential with a point mass at zero). The condition D^{(K)}(u_n) should be checked by the user.

Fukutome et al. (2015) propose an ad hoc automated procedure

  1. Calculate the interexceedance times for each K-gap and each threshold, along with the number of clusters

  2. Select the (u, K) pairs for which IMT < 0.05 (corresponding to a P-value of 0.82)

  3. Among those, select the pair (u, K) for which the number of clusters is the largest

Value

an invisible list of matrices containing

  • IMT a matrix of test statistics

  • pvals a matrix of approximate p-values (corresponding to probabilities under a \chi^2_1 distribution)

  • mle a matrix of maximum likelihood estimates for each given pair (u, K)

  • loglik a matrix of log-likelihood values at MLE for each given pair (u, K)

  • threshold a vector of thresholds based on empirical quantiles at supplied levels.

  • q the vector q supplied by the user

  • K the largest gap number, supplied by the user

Author(s)

Leo Belzile

References

Fukutome, Liniger and Suveges (2015), Automatic threshold and run parameter selection: a climatology for extreme hourly precipitation in Switzerland. Theoretical and Applied Climatology, 120(3), 403-416.

Suveges and Davison (2010), Model misspecification in peaks over threshold analysis. Annals of Applied Statistics, 4(1), 203-221.

White (1982), Maximum Likelihood Estimation of Misspecified Models. Econometrica, 50(1), 1-25.

Examples

infomat.test(xdat = rgp(n = 10000),
             q = seq(0.1, 0.9, length = 10),
             K = 3)

mev documentation built on Sept. 11, 2024, 8:14 p.m.