Learn R Programming

copBasic (version 1.7.1)

uvlmoms: Bivariate Skewness after Joe (2015) or the Univariate L-moments of Combined U and V

Description

Joe (2015, pp. 65--66) suggests two quantile-based measures of bivariate skewness defined for uniform random variables $u$ and $v$ combined as either $\psi_{u+v-1} = u + v - 1$ or $\psi_{u-v} = u -v$ for which the $\mathrm{E}[u] = \mathrm{E}[v] = 0$. The bivariate skewness is the quantity $\eta$: $$\eta(p; \psi) = \frac{x(1-p) - 2x(\frac{1}{2}) + x(p)}{x(1-p) - x(p)} \mbox{,}$$ where $0 < p < \frac{1}{2}$, $x(F)$ is the quantile function for nonexceedance probability $F$ for either the quantities $X = \psi_{u+v-1}$ or $X = \psi_{u-v}$ using either the empirical quantile function or a fitted distribution. Structurally the above definition for $\eta$ based on quantiles is oft shown in comparative literature concerning L-moments. But why stop there? Why not compute the L-moments themselves to arbitrary order for $\eta$ by either definition (the uvlmoms variation)? Why not fit a distribution to the computed L-moments for estimation of $x(F)$? Or simply compute skewness according to the definition above (the uvskewness variation).

Usage

uvlmoms(u,v=NULL,    umv=TRUE, p=NA,   type="gno", getlmoms=TRUE,  ...)

uvskewness(u,v=NULL, umv=TRUE, p=0.05, type=6, getlmoms=FALSE, ...)

Arguments

u
Nonexceedance probability $u$ in the $X$ direction;
v
Nonexceedance probability $v$ in the $Y$ direction and if NULL then u is treated as a two column Rdata.frame;
umv
A logical controlling the computation of $\psi$: $\psi = u + v - 1$ (umv = TRUE) or $\psi = u - v$ (umv = FALSE);
p
A suggested $p$ value is p = 0.05. If is.na(NA), then getlmoms is set to TRUE (see below);
type
The type argument is mutable. Either it is an integer between 1 and 9 selecting one of the nine quantile algorithms described for the quantile function in R. The default 6 uses the Weibull plotting positions and differs from R's
getlmoms
A logical triggering whether the L-moments of either $\psi_{u+v-1}$ or $\psi_{u - v}$ are returned instead computing the above definition of skewness; and
...
Additional arguments to pass to the lmomco function lmoms, such as the number of L-moments nmoms.

Value

  • An Rlist of the univariate L-moments of $\eta$ is returned (see documentation for lmoms in the lmomco package). Or the skewness of $\eta$ can be either (1) based on the empirical distribution based on plotting positions by the quantile function of Rusing the type as described, or (2) based on the fitted quantile function for the parameters of a distribution for the lmomco package.

encoding

utf8

References

Joe, H., 2015, Dependence modeling with copulas: Boca Raton, CRC Press, 462 p.

See Also

COP

Examples

Run this code
UV <- simCOP(n=100, cop=GHcop, para=1.5, graphics=FALSE)
# lmr <- uvlmoms(UV) # commented out just for speed
uvskewness(UV, p=0.10)
uvskewness(UV, p=0.10, type="gno")
ps <- seq(0.01,0.49,by=0.01)
ETA <- sapply(1:length(ps), function(i) { uvskewness(UV, p=ps[i], type=5, uvm1=FALSE) } )
plot(ps, ETA, type="l", xlab="P FACTOR", ylab="BIVARIATE SKEWNESS")

Run the code above in your browser using DataLab