Processing math: 100%

cbCopula contructor

cbCopula(x, m = rep(nrow(x), ncol(x)), pseudo = FALSE)

Arguments

x

the data to be used

m

checkerboard parameters

pseudo

Boolean, defaults to FALSE. Set to TRUE if you are already providing pseudo data into the x argument.

Value

An instance of the cbCopula S4 class. The object represent the fitted copula and can be used through several methods to query classical (r/d/p/v)Copula methods, etc.

Details

The cbCopula class computes a checkerboard copula with a given checkerboard parameter m, as described by A. Cuberos, E. Masiello and V. Maume-Deschamps (2019). Assymptotics for this model are given by C. Genest, J. Neslehova and R. bruno (2017). The construction of this copula model is as follows :

Start from a dataset with n i.i.d observation of a d-dimensional copula (or pseudo-observations), and a checkerboard parameter m,dividing n.

Consider the ensemble of multi-indexes I={i=(i1,..,id){1,...,m}d} which indexes the boxes :

Bi=]i1m,im]

Let now λ be the dimension-unspecific lebesgue measure on any power of R, that is :

dN,x,yRp,λ((x,y))=dp=1(yixi)

Let furthermore μ and ˆμ be respectively the true copula measure of the sample at hand and the classical Deheuvels empirical copula, that is :

  • For n i.i.d observation of the copula of dimension d, let i{1,...,d},R1i,...,Rdi be the marginal ranks for the variable i.

  • xId let ˆμ((0,x))=1nnk=1IRk1x1,...,Rkdxd

The checkerboard copula, C, and the empirical checkerboard copula, ˆC, are then defined by the following :

x(0,1)d,C(x)=iImdμ(Bi)λ((0,x)Bi)

Where md=λ(Bi).

This copula is a special form of patchwork copulas, see F. Durante, J. Fernández Sánchez and C. Sempi (2013) and F. Durante, J. Fernández Sánchez, J. Quesada-Molina and M. Ubeda-Flores (2015). The estimator has the good property of always being a copula.

The checkerboard copula is a kind of patchwork copula that only uses independent copula as fill-in, only where there are values on the empirical data provided. To create such a copula, you should provide data and checkerboard parameters (depending on the dimension of the data).

References

cuberos2019cort

genest2017cort

durante2013cort

durante2015cort