Learn R Programming

copBasic (version 1.7.1)

duCOP: The Dual of a Copula Function

Description

Compute the dual of a copula (function) from a copula (Nelsen, 2006, pp. 33--34), which is defined as

$$\mathrm{Pr}[U \le v \mathrm{\ or\ } V \le v] = \tilde{\mathbf{C}}(u,v) = u + v - \mathbf{C}(u,v)\mbox{,}$$

where $\tilde{\mathbf{C}}(u,v)$ is the dual of a copula and $u$ and $v$ are nonexceedance probabilities. The dual of a copula function is the expression for the probability that either $U \le u$ or $V \le v$, which is unlike the co-copula function (see coCOP) that provides $\mathrm{Pr}[U > u \mathrm{\ or\ } V > v]$. The dual of a copula is a function and not in itself a copula. Some rules of copulas mean that

$$\hat\mathbf{C}(u',v') + \tilde{\mathbf{C}}(u,v) \equiv 1\mbox{,}$$

where $\hat\mathbf{C}(u',v')$ is the survival copula in terms of exceedance probabilities $u'$ and $v'$ or in copBasic code that the functions surCOP + duCOP equal unity.

Usage

duCOP(u, v, cop=NULL, para=NULL, ...)

Arguments

u
Nonexceedance probability $u$ in the $X$ direction;
v
Nonexceedance probability $v$ in the $Y$ direction;
cop
A copula function;
para
Vector of parameters or other data structure, if needed, to pass to the copula; and
...
Additional arguments to pass (such as parameters, if needed, for the copula in the form of a list.

Value

  • Value(s) for the dual of a copula are returned.

References

Nelsen, R.B., 2006, An introduction to copulas: New York, Springer, 269 p.

See Also

COP, coCOP, surCOP

Examples

Run this code
u <- runif(1); t <- runif(1)
duCOP(cop=W,u,t); duCOP(cop=P,u,t); duCOP(cop=M,u,t); duCOP(cop=PSP,u,t)

# Next demonstrate COP + duCOP = unity.
"MOcop.formula" <- function(u,v, para=para, ...) {
   alpha <- para[1]; beta <- para[2]; return(min(v*u^(1-alpha), u*v^(1-beta)))
}
"MOcop" <- function(u,v, ...) { asCOP(u,v, f=MOcop.formula, ...) }
u <- 0.2; v <- 0.75; ab <- c(1.5, 0.3)
surCOP(1-u,1-v, cop=MOcop, para=ab) + duCOP(u,v, cop=MOcop, para=ab) # UNITY

Run the code above in your browser using DataLab