CDVineCopSelect {CDVine} | R Documentation |
Sequential copula selection and estimation of C- and D-vine copula models
Description
This function fits either a C- or a D-vine copula model to a d-dimensional copula data set.
Appropriate pair-copula families are selected using BiCopSelect
and estimated sequentially.
Usage
CDVineCopSelect(data, familyset=NA, type, selectioncrit="AIC",
indeptest=FALSE, level=0.05)
Arguments
data |
An N x d data matrix (with uniform margins).
|
familyset |
An integer vector of pair-copula families to select from (the independence copula MUST NOT be specified in this vector unless one wants to fit an independence vine!).
The vector has to include at least one pair-copula family that allows for positive and one that allows for negative dependence.
If familyset = NA (default), selection among all possible families is performed.
The coding of pair-copula families is shown below.
|
type |
Type of the vine model:
1 or "CVine" = C-vine
2 or "DVine" = D-vine
|
selectioncrit |
Character indicating the criterion for pair-copula selection. Possible choices: selectioncrit = "AIC" (default) or "BIC" (see BiCopSelect ).
|
indeptest |
Logical; whether a hypothesis test for the independence of u1 and u2 is performed before bivariate copula selection
(default: indeptest = FALSE ; cp. BiCopIndTest ).
The independence copula is chosen for a (conditional) pair if the null hypothesis of independence cannot be rejected.
|
level |
Numeric; significance level of the independence test (default: level = 0.05 ).
|
Value
family |
A d*(d-1)/2 vector of pair-copula families with values
0 = independence copula
1 = Gaussian copula
2 = Student t copula (t-copula)
3 = Clayton copula
4 = Gumbel copula
5 = Frank copula
6 = Joe copula
7 = BB1 copula
8 = BB6 copula
9 = BB7 copula
10 = BB8 copula
13 = rotated Clayton copula (180 degrees; “survival Clayton”)
14 = rotated Gumbel copula (180 degrees; “survival Gumbel”)
16 = rotated Joe copula (180 degrees; “survival Joe”)
17 = rotated BB1 copula (180 degrees; “survival BB1”)
18 = rotated BB6 copula (180 degrees; “survival BB6”)
19 = rotated BB7 copula (180 degrees; “survival BB7”)
20 = rotated BB8 copula (180 degrees; “survival BB8”)
23 = rotated Clayton copula (90 degrees)
24 = rotated Gumbel copula (90 degrees)
26 = rotated Joe copula (90 degrees)
27 = rotated BB1 copula (90 degrees)
28 = rotated BB6 copula (90 degrees)
29 = rotated BB7 copula (90 degrees)
30 = rotated BB8 copula (90 degrees)
33 = rotated Clayton copula (270 degrees)
34 = rotated Gumbel copula (270 degrees)
36 = rotated Joe copula (270 degrees)
37 = rotated BB1 copula (270 degrees)
38 = rotated BB6 copula (270 degrees)
39 = rotated BB7 copula (270 degrees)
40 = rotated BB8 copula (270 degrees)
|
par |
A d*(d-1)/2 vector of pair-copula parameters.
|
par2 |
A d*(d-1)/2 vector of second pair-copula parameters for the t-, BB1, BB6, BB7 and BB8 copulas.
|
Author(s)
Eike Brechmann
See Also
BiCopSelect
, CDVineSeqEst
Examples
# simulate from a 4-dimensional D-vine copula with mixed pair-copulas
d = 4
dd = d*(d-1)/2
family = c(1,2,3,4,7,3)
par = c(0.5,0.4,2,1.5,1.2,1.5)
par2 = c(0,5,0,0,2,0)
type = 2
simdata = CDVineSim(1000,family,par,par2,type)
# determine appropriate pair-copula families and parameters
# of a D-vine structure
## Not run:
CDVineCopSelect(simdata,type=2,familyset=c(1:10,13,14,23,24))
## End(Not run)
[Package
CDVine version 1.4
Index]