Measuring Multivariate Dependence Using Distance Multivariance

Distance multivariance is a measure of dependence which can be used to detect and quantify dependence. The necessary functions are implemented in this packages, and examples are given. For the theoretic background we refer to the papers: B. Böttcher, Dependence and Dependence Structures: Estimation and Visualization Using Distance Multivariance. . B. Böttcher, M. Keller-Ressel, R.L. Schilling, Detecting independence of random vectors: generalized distance covariance and Gaussian covariance. VMSTA, 2018, Vol. 5, No. 3, 353-383. . B. Böttcher, M. Keller-Ressel, R.L. Schilling, Distance multivariance: New dependence measures for random vectors. . G. Berschneider, B. Böttcher, On complex Gaussian random fields, Gaussian quadratic forms and sample distance multivariance. .


News

(News above the first "Changes...." are not displayed properly in Rstudio, i.e., this line is invisible)

Changes in Version 2.0.0

New Features

  • new function 'multivariance.test' which provides all multivariance related tests - providing a unified interface with return values as they are common for tests in R, in particular, the p.value und the value of the test statistic. The return value is of class "htest" (as it is standard for other hypothesis tests, e.g. ks.test, t.test).
  • 'cdm' has now the argument "external.dm.fun" which can be used to pass an external function for the computation of the distance matrix (allowing major speed ups for non standard distances)
  • 'multivariances.all' has now named return values
  • 'resample.multivariance' works now also with 'type="all"', for simultaneous computation of p.values of multivariance, total-multivariance, 2-multivariance and 3-multivariance
  • 'multicorrelation' computes now various types of multicorrelations.
  • 'multivariance.timing' provides methods for detailed estimation of the computation time, which might be useful e.g. when planing simulation studies.

Changes

  • 'multicorrelation' has now different defaults and new arguments.
  • the centered distance matrices are now stored in a list rather than a 3-dim array. Thus the return value of 'cdms' was changed, and correspondingly the arguments of all '*.multivariance' functions.

Updated

  • major speedup
  • 'multivariance.pvalue' accepts and returns NA and NaN
  • 'm.multivariance' returns NA when 3-multivariance is used for only 2 variables.

Fixed

  • 'pearson.pvalue' partially ignored the option "type". It always used the test statistic of multivariance, despite the fact the parameters were computed for the given "type".
  • the option "verbose" in 'dependence.structure' now works as expected

Changes in Version 1.2.1

Updates

  • updated references
  • various typos corrected

Changes in Version 1.2.0

New Features

  • 'independence.test' is now also implemented with type "pearson_approx". Providing the fast p-value approximation developed in arXiv:1808.07280. For this also the functions 'pearson.qf' (a Gaussian quadratic form estimate based on mean, variance and skewness) and 'pearson.pvalue' (the corresponding p-value estimate based on new moment estimators) are introduced.
  • In "cmd" one can now explicitly specify the use of "isotropic" continuous negative definite functions. This speeds up the calculation for this case by a factor of about 100.

Fixed

  • the option "squared" works now also for multivariance with option "correlation=TRUE".
  • 'multivariances.all' returns NA for 3-multivariance if only two variables are given.

Updates

  • speed up of various functions
  • various typos corrected

Changes in Version 1.1.0

New Features

  • 'm.multivariance' a function to calculate the m-multivariance
  • 'multivariances.all' a function to calculate standard/total/m-multivariance simultaneously
  • 'resample.multivariance' implements the resampling method which can be used to get less conservative tests than the distribution-free methods
  • 'dependence.structure' a function to generate a graphical model of the dependence structure
  • various examples of the use of 'dependence.structure'

Changes

  • The standard output of 'multivariance' is now (distance multivariance squared) scaled by the sample size. Use 'Nscale = FALSE' to get the value without this scaling. The reason for this was twofold: 1. it is now the same setting as for 'total.multivariance'. 2. This is the only value which can (roughly) be interpreted without further calculations.

Updates

  • improved documentation. In particular, it is now clearly stated that the squared values are the standard output of 'multivariance' and 'total.multivariance'
  • some speed up

Changes in Version 1.0.5 2017-11-01

Details

  • Initial public release

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("multivariance")

2.2.0 by Björn Böttcher, a month ago


Browse source code at https://github.com/cran/multivariance


Authors: Björn Böttcher [aut, cre] , Martin Keller-Ressel [ctb]


Documentation:   PDF Manual  


GPL-3 license


Imports igraph, graphics, stats, Rcpp, microbenchmark

Suggests testthat

Linking to Rcpp


See at CRAN