copBasic (version 2.2.8)

kfuncCOPlmoms: The L-moments of the Kendall Function of a Copula

Description

Compute the L-moments of the Kendall Function ($F_K(z;\mathbf{C})$) of a copula $\mathbf{C}(u,v)$ where the $z$ is the joint probability of the $\mathbf{C}(u,v)$. The Kendall Function (or Kendall Distribution Function) is the cumulative distribution function (CDF) of the joint probability $Z$ of the coupla. The expected value of the $z(F_K)$ (mean, first L-moment ${\lambda }_1$), because $Z$ has nonzero probability for $0\le Z\le \mathrm{\infty }$, is

$$\mathrm{E}[Z]={\lambda }_1={\int }_0^{\mathrm{\infty }}[1-F_K(t)]\mathrm{d}t={\int }_0^1[1-F_K(t)]\mathrm{d}t\text{,}$$

where for circumstances here $0\le Z\le 1$. The $\mathrm{\infty }$ is mentioned only because expectations of such CDFs are usually shown using $(0,\mathrm{\infty })$ limits, whereas integration of quantile functions (CDF inverses) use limits $(0,1)$. Because the support of $Z$ is $(0,1)$, like the probability $F_K$, showing just it ($\mathrm{\infty }$) as the upper limit could be confusing---statements such as “probabilities of probabilities” are rhetorically complex. So, pursuit of word precision is made herein.

An expression for ${\lambda }_r$ for $r\ge 2$ in terms of the $F_K(z)$ is $${\lambda }_r=\frac{1}{r}\sum _{j=0}^{r-2}(-1{)}^j(\genfrac{}{}{0ex}{}{r-2}{j})(\genfrac{}{}{0ex}{}{r}{j+1}){\int }_0^1[F_K(t){]}^{r-j-1}\times [1-F_K(t){]}^{j+1}\mathrm{d}t\text{,}$$ where because of these circumstances the limits of integration are $(0,1)$ and not $(-\mathrm{\infty },\mathrm{\infty })$ as in the usual definition of L-moments in terms of a distribution's CDF. (Note, such expressions did not make it into Asquith (2011), which needs rectification if that monograph ever makes it to a 2nd edition.)

The mean, L-scale, coefficient of L-variation (${\tau }_2$, LCV, L-scale/mean), L-skew (${\tau }_3$, TAU3), L-kurtosis (${\tau }_4$, TAU4), and ${\tau }_5$ (TAU5) are computed. In usual nomenclature, the L-moments are ${\lambda }_1=\text{mean,}$ ${\lambda }_2=\text{L-scale,}$ ${\lambda }_3=\text{third L-moment,}$ ${\lambda }_4=\text{fourth L-moment, and}$ ${\lambda }_5=\text{fifth L-moment,}$ whereas the L-moment ratios are ${\tau }_2={\lambda }_2/{\lambda }_1=\text{coefficient of L-variation, }$ ${\tau }_3={\lambda }_3/{\lambda }_2=\text{L-skew, }$ ${\tau }_4={\lambda }_4/{\lambda }_2=\text{L-kurtosis, and}$ ${\tau }_5={\lambda }_5/{\lambda }_2=\text{not named.}$ It is common amongst practitioners to lump the L-moment ratios into the general term “L-moments” and remain inclusive of the L-moment ratios. For example, L-skew then is referred to as the 3rd L-moment when it technically is the 3rd L-moment ratio. There is no first L-moment ratio (meaningless); so, results from kfuncCOPlmoms function will canoncially show a NA in that slot. The coefficient of L-variation is ${\tau }_2$ (subscript 2) and not Kendall Tau ($\tau$). Sample L-moments are readily computed by several packages in R (e.g. lmomco, lmom, Lmoments, POT).

Usage

kfuncCOPlmom(r, cop=NULL, para=NULL, ...)
kfuncCOPlmoms(cop=NULL, para=NULL, nmom=5, begin.mom=1, ...)

Value

An R

list is returned by kfuncCOPlmoms and only the scalar value of ${\lambda }_r$ by kfuncCOPlmom.

lambdas

Vector of the L-moments. First element is ${\lambda }_1$, second element is ${\lambda }_2$, and so on;

ratios

Vector of the L-moment ratios. Second element is $\tau$, third element is ${\tau }_3$ and so on; and

source

An attribute identifying the computational source of the L-moments: “kfuncCOPlmoms”.

Arguments

r

The $r$th order of a single L-moment to compute;

cop

A copula function;

para

Vector of parameters or other data structure, if needed, to pass to the copula;

nmom

The number of L-moments to compute;

begin.mom

The $r$th order to begin the sequence lambegr:nmom for L-moment computation. The rarely used argument is means to bypass the computation of the mean if the user has an alternative method for the mean or other central tendency characterization in which case begin.mom = 2; and

...

Additional arguments to pass.

Author

W.H. Asquith

References

Asquith, W.H., 2011, Distributional analysis with L-moment statistics using the R environment for statistical computing: Createspace Independent Publishing Platform, ISBN 978--146350841--8.

See Also

kfuncCOP