expectiles {ExtremeRisks} | R Documentation |
Expectile Computation
Description
Computes the true expectile for some families of parametric models.
Usage
expectiles(par, tau, tsDist="gPareto", tsType="IID", trueMethod="true",
estMethod="LAWS", nrep=1e+05, ndata=1e+06, burnin=1e+03)
Arguments
par |
A vector of |
tau |
A real in |
tsDist |
A string specifying the parametric family of the innovations distribution. By default |
tsType |
A string specifying the type of time series. By default |
trueMethod |
A string specifying the method used to computed the expecile. By default |
estMethod |
A string specifying the method used to estimate the expecile. By default |
nrep |
A positive interger specifying the number of simulations to use for computing an approximation of the expectile. See Details. |
ndata |
A positive interger specifying the number of observations to genreated for each simulation. See Details. |
burnin |
A positive interger specifying the number of initial observations to discard from the simulated sample. |
Details
For a parametric family of time series models or a parametric family of distributions (for the case of independent observations) the \tau
-th expectile (or expectile of level tau
) is computed.
There are two methods to compute the
\tau
-th expectile. For the Generalised Pareto and Student-t parametric families of distributions, the analytical epxression of the expectile is available. This is used to compute the\tau
-th expectile if the parametertrueMethod="true"
is specified. For most of parametric family of distributions or parametric families of time series models the analytical epxression of the expectile is not available. In this case an approximate value of the\tau
-th expectile is computed via a Monte Carlo method if the parametertrueMethod=="approx"
is specified. In particular,ndata
observations from a family of time series models (e.g.tsType="AR"
andtsDist="studentT"
) or a sequence of independent and indentically distributed random variables with common family of distributions (e.g.tsType="IID"
andtsDist="gPareto"
) are simulatednrep
times. For each simulation the\tau
-th expectile is estimate by the estimation method specified byestMethod
. The mean of such estimate provides an approximate value of the\tau
-th expectile. The available estimator to esitmate the expecile are the direct LAWS (estMethod="LAWS"
) and the indirect QB (estMethod="QB"
), see estExpectiles for details. The available families of distributions are: Generalised Pareto (tsDist="gPareto"
), Student-t (tsDist="studentT"
) and Frechet (tsDist="Frechet"
). The available classes of time series with parametric innovations families of distributions are specified in rtimeseries.
Value
The \tau
-th expectile.
Author(s)
Simone Padoan, simone.padoan@unibocconi.it, http://mypage.unibocconi.it/simonepadoan/; Gilles Stupfler, gilles.stupfler@ensai.fr, http://ensai.fr/en/equipe/stupfler-gilles/
References
Padoan A.S. and Stupfler, G. (2020). Extreme expectile estimation for heavy-tailed time series. arXiv e-prints arXiv:2004.04078, https://arxiv.org/abs/2004.04078.
See Also
Examples
# Derivation of the true tau-th expectile for the Pareto distribution
# via accurate simulation
# parameter value
par <- c(1, 0.3)
# Intermediate level (or sample tail probability 1-tau)
tau <- 0.99
trueExp <- expectiles(par, tau)
trueExp
# tau-th expectile of the AR(1) with Student-t innovations
tsDist <- "studentT"
tsType <- "AR"
# Approximation via Monte Carlo methods
trueMethod <- "approx"
# parameter setting
corr <- 0.8
df <- 3
par <- c(corr, df)
# Intermediate level (or sample tail probability 1-tau)
tau <- 0.99
trueExp <- expectiles(par, tau, tsDist, tsType, trueMethod)
trueExp