pacotestset: Create and Alter a Pacotest Options List

View source: R/pacotestset.R

pacotestsetR Documentation

Create and Alter a Pacotest Options List

Description

The function creates or updates a list object, which is required for applying the pacotest function.

Arguments

pacotestOptions

A options list for the pacotest function generated by the pacotestset function.

testType

A string which specifies the type of the test for testing the simplifying assumption.

Possible values: CCC | VI

grouping

For testType = CCC:

The grouping method which is used to obtain a partitioning of the support of the conditioning variable W.

Possible values: TreeCCC | SumMedian | SumThirdsI | SumThirdsII | SumThirdsIII | SumQuartiles | ProdMedian | ProdThirdsI | ProdThirdsII | ProdThirdsIII | ProdQuartiles | TreeEC

expMinSampleSize

For testType = CCC with grouping = TreeCCC | TreeEC:

The minimum number of observations which are allocated to a group in the decision tree learning process. The default value is 100.

aggInfo

For testType = CCC with grouping = TreeCCC | TreeEC:

The method used for aggregating information in the conditioning set. The information in the conditioning set can be aggregated by either taking the mean of all variables or the pairwise mean. The result is added as an additional variable which can be used by the decision tree to partition the support of the conditioning variable W.

Possible values: none | meanAll | meanPairwise

withEstUncert

For testType = CCC:

A logical variable indicating whether the asymptotic-variance covariance matrix of the estimated correlations should be corrected for the estimation uncertainty of the probability integral transforms.

estUncertWithRanks

For testType = CCC:

A logical variable indicating whether the asymptotic-variance covariance matrix of the estimated correlations should be corrected for the estimation uncertainty induced by using a semiparametric estimator for the vine copula, i.e., empirical cdf's for the univariate margins and parametric copula families as building blocks of the R-vine copula.

finalComparison

For testType = CCC with grouping = TreeCCC | TreeEC:

A variable specifying whether at the end of the decision tree all subsets being part of the partition are compared against each other or whether only the pair with the highest value of the test statistic is used.

Possible values: pairwiseMax | all

penaltyParams

For testType = CCC with grouping = TreeCCC | TreeEC:

A vector of length two, specifying the functional form of the penalty. The penalty is a function of the sample size n and chosen to be lambda(n) = cn^(-beta). The first entry of the vector is specifying the level c of the penalty and needs to be a positive real number. The second entry of the vector is specifying the power beta of the penalty and needs to be chosen from the interval (0,1).

gamma0Partition

For testType = CCC with grouping = TreeCCC | TreeEC:

The gamma0 partition. I.e., the partition which is favoured via the penalty under the H0.

Possible values: SumMedian | SumThirdsI | SumThirdsII | SumThirdsIII | SumQuartiles | ProdMedian | ProdThirdsI | ProdThirdsII | ProdThirdsIII | ProdQuartiles

groupedScatterplots

For testType = CCC:

A logical whether grouped scatterplots should be produced.

decisionTreePlot

For testType = CCC:

A logical whether the partition of the support of W should be illustrated as a decision tree plot.

numbBoot

For testType = VI:

The number of bootstrap replications for computing p-values using the multiplier bootstrap approach.

Details

Calling without any arguments prints all possible options.

pacotestset()

Calling with a string, that specifies the test type, gives back a option list with the default values corresponding to each test.

pacotestOptions = pacotestset('CCC')
pacotestOptions = pacotestset('VI')

Calling with pairs of parameter names and values creates an pacotestOptions list in which the named parameters have the specified values.

pacotestOptions = pacotestset('Name1',Value1,'Name2',Value2,...)

Calling with an existing pacotestOptions list checks the list for consistency.

pacotestset(pacotestOptions)

Calling with an existing pacotestOptions list and pairs of parameter names and values creates a copy of the existing list, where the named parameters are updated with the provided values.

pacotestOptionsNew = pacotestset(pacotestOptions,'Name1',Value1,'Name2',Value2,...)

Value

The function returns a pacotestOptions list which can be used as input argument for the functions pacotest, pacotestRvineSeq and pacotestRvineSingleCopula.

Author(s)

Malte S. Kurz

References

Kurz, M. S. and F. Spanhel (2022), "Testing the simplifying assumption in high-dimensional vine copulas", Electronic Journal of Statistics 16 (2), pp. 5226-5276.

See Also

pacotest-package, pacotest, pacotestRvineSeq, pacotestRvineSingleCopula


pacotest documentation built on Nov. 10, 2022, 6:15 p.m.