cQuantGPD {ReIns}R Documentation

Estimator of large quantiles using censored GPD-MLE

Description

Computes estimates of large quantiles Q(1p)Q(1-p) using the estimates for the EVI obtained from the GPD-ML estimator adapted for right censoring.

Usage

cQuantGPD(data, censored, gamma1, sigma1, p, plot = FALSE, add = FALSE, 
          main = "Estimates of extreme quantile", ...)

Arguments

data

Vector of nn observations.

censored

A logical vector of length nn indicating if an observation is censored.

gamma1

Vector of n1n-1 estimates for the EVI obtained from cGPDmle.

sigma1

Vector of n1n-1 estimates for σ1\sigma_1 obtained from cGPDmle.

p

The exceedance probability of the quantile (we estimate Q(1p)Q(1-p) for pp small).

plot

Logical indicating if the estimates should be plotted as a function of kk, default is FALSE.

add

Logical indicating if the estimates should be added to an existing plot, default is FALSE.

main

Title for the plot, default is "Estimates of extreme quantile".

...

Additional arguments for the plot function, see plot for more details.

Details

The quantile is estimated as

Q^(1p)=Znk,n+ak,n(((1km)/p)γ^11)/γ^1)\hat{Q}(1-p)= Z_{n-k,n} + a_{k,n} ( ( (1-km)/p)^{\hat{\gamma}_1} -1 ) / \hat{\gamma}_1)

ith Zi,nZ_{i,n} the ii-th order statistic of the data, γ^1\hat{\gamma}_1 the generalised Hill estimator adapted for right censoring and kmkm the Kaplan-Meier estimator for the CDF evaluated in Znk,nZ_{n-k,n}. The value aa is defined as

ak,n=σ^1/p^ka_{k,n} = \hat{\sigma}_1 / \hat{p}_k

with σ^1\hat{\sigma}_1 the ML estimate for σ1\sigma_1 and p^k\hat{p}_k the proportion of the kk largest observations that is non-censored.

Value

A list with following components:

k

Vector of the values of the tail parameter kk.

Q

Vector of the corresponding quantile estimates.

p

The used exceedance probability.

Author(s)

Tom Reynkens

References

Einmahl, J.H.J., Fils-Villetard, A. and Guillou, A. (2008). "Statistics of Extremes Under Random Censoring." Bernoulli, 14, 207–227.

See Also

cProbGPD, cGPDmle, QuantGPD, Quant, KaplanMeier

Examples

# Set seed
set.seed(29072016)

# Pareto random sample
X <- rpareto(500, shape=2)

# Censoring variable
Y <- rpareto(500, shape=1)

# Observed sample
Z <- pmin(X, Y)

# Censoring indicator
censored <- (X>Y)

# GPD-MLE estimator adapted for right censoring
cpot <- cGPDmle(Z, censored=censored, plot=TRUE)

# Large quantile
p <- 10^(-4)
cQuantGPD(Z, gamma1=cpot$gamma1, sigma1=cpot$sigma1,
         censored=censored, p=p, plot=TRUE)

[Package ReIns version 1.0.14 Index]