FitControlsVinecop.__init__

FitControlsVinecop.__init__(self, family_set: collections.abc.Sequence[pyvinecopulib.BicopFamily] = [BicopFamily.indep, BicopFamily.gaussian, BicopFamily.student, BicopFamily.clayton, BicopFamily.gumbel, BicopFamily.frank, BicopFamily.joe, BicopFamily.bb1, BicopFamily.bb6, BicopFamily.bb7, BicopFamily.bb8, BicopFamily.tawn, BicopFamily.tll], parametric_method: str = 'mle', nonparametric_method: str = 'constant', nonparametric_mult: float = 1.0, trunc_lvl: int = 18446744073709551615, tree_criterion: str = 'tau', threshold: float = 0.0, selection_criterion: str = 'bic', weights: numpy.ndarray[dtype=float64, shape=(*), order='C'] = array([], dtype=float64), psi0: float = 0.9, preselect_families: bool = True, select_trunc_lvl: bool = False, select_threshold: bool = False, select_families: bool = True, show_trace: bool = False, num_threads: int = 1, tree_algorithm: str = 'mst_prim', allow_rotations: bool = True, seeds: collections.abc.Sequence[int] = []) None

Instantiates custom controls for fitting vine copula models.

Parameters:
  • family_set – The set of copula families to consider (if empty, then all families are included).

  • parametric_method – The fit method for parametric families; possible choices: "mle", "itau".

  • nonparametric_method – The fit method for the local-likelihood nonparametric family (TLLs); possible choices: "constant", "linear", "quadratic".

  • nonparametric_mult – A factor with which the smoothing parameters are multiplied.

  • trunc_lvl – Truncation level for truncated vines.

  • tree_criterion – The criterion for selecting the spanning tree ("tau", "hoeffd", "rho", and "mcor" implemented so far) during the tree-wise structure selection.

  • threshold – For thresholded vines (0 = no threshold).

  • selection_criterion – The selection criterion ("loglik", "aic" or "bic") for the pair copula families.

  • weights – A vector of weights for the observations.

  • psi0 – Only for selection_criterion = "mbic", prior probability of non-independence.

  • preselect_families – Whether to exclude families before fitting based on symmetry properties of the data.

  • select_trunc_lvl – Whether the truncation shall be selected automatically.

  • select_threshold – Whether the threshold parameter shall be selected automatically.

  • select_families – Whether the families shall be selected automatically, or should the method simply update the parameters for the pair copulas already present in the model.

  • show_trace – Whether to show a trace of the building progress.

  • num_threads – Number of concurrent threads to use while fitting pair copulas within a tree; never uses more than the number of concurrent threads supported by the implementation.

  • tree_algorithm – The algorithm for building the spanning tree ("mst_prim", "mst_kruskal", "random_weighted", or "random_unweighted") during the tree-wise structure selection. "mst_prim" and "mst_kruskal" use Prim’s and Kruskal’s algorithms respectively to select the maximum spanning tree, maximizing the sum of the edge weights (i.e., tree_criterion). "random_weighted" and "random_unweighted" use Wilson’s algorithm to generate a random spanning tree, either with probability proportional to the product of the edge weights (weighted) or uniformly (unweighted).

  • allow_rotations – Allow rotations for the families when doing model selection (default: true).

  • seeds – A vector of random seeds for the random number generator for parts of the algorithm that are randomized (e.g., random tree selection).