copBasic (version 2.2.4)

sectionCOP: The Sections or Derivative of the Sections of a Copula

Description

Compute the copula sections or the (partial) derivatives of copula sections of a copula (Nelsen, 2006, pp. 12--14). The horizontal section at \(V=a\) (a constant) is $$t \mapsto \mathbf{C}(t,a)\mbox{, and}$$ the vertical section at \(U=a\) (a constant, with respect to \(V\) or wrtV=TRUE) is $$t \mapsto \mathbf{C}(a,t)\mbox{.}$$ The partial derivatives of the copula sections are conditional cumulative distribution functions (see derCOP and derCOP2). The derivatives are constrained as $$0 \le \frac{\delta}{\delta u}\mathbf{C}(u,v) \le 1\mbox{, and}$$ $$0 \le \frac{\delta}{\delta v}\mathbf{C}(u,v) \le 1\mbox{.}$$

Usage

sectionCOP(f, cop=NULL,  para=NULL, wrtV=FALSE, dercop=FALSE, delt=0.005,
              ploton=TRUE, lines=TRUE, xlab="NONEXCEEDANCE PROBABILITY", ...)

Value

An R

list is returned.

t

The nonexceedance probability along the section. The nomenclature \(t\) mimics Nelsen (2006) and is not the same as the \(u\) or \(v\);

seccop

The section of the copula or its derivative;

wrt

A text string declaring what the setting for wrtV was;

fvalue

The provided value of nonexceedance probability; and

isderivative

A logical stating whether the derivative of the section is seccop.

Arguments

f

A single value of nonexceedance probability \(u\) or \(v\) along the horizontal \(U\) axis or vertical \(V\) axis of the unit square \(\mathcal{I}^2\);

cop

A copula function;

para

Vector of parameters, if needed, to pass to the copula;

wrtV

A logical to toggle between with respect to \(v\) or \(u\) (default). The default provides the vertical section whereas the horizontal comes from wrtV = TRUE;

dercop

A logical that triggers the derivative of the section;

delt

The increment of the level curves to plot, defaults to 5-percent intervals;

ploton

A logical to toggle on the plot;

lines

Draw the lines of diagonal to the current device;

xlab

A label for the x-axis title passed to plot() in R; and

...

Additional arguments to pass to the plot() and lines() functions in R.

Author

W.H. Asquith

References

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

See Also

COP, diagCOP