didec: Computes the directed dependence coefficient.
In didec: Directed Dependence Coefficient
didec R Documentation
Computes the directed dependence coefficient.
Description
The directed dependence coefficient (didec) estimates the degree of directed dependence of a random vector Y on a random vector X, based on an i.i.d. sample of (X,Y).
Usage
didec(X, Y, perm = FALSE, perm.method = c("decreasing"))
Arguments
X
A numeric matrix or data.frame/data.table. Contains the predictor vector X.
Y
A numeric matrix or data.frame/data.table. Contains the response vector Y.
perm
A logical. If True a version of didec is computed that takes into account the permutations (specified by perm.method) of the response variables.
perm.method
An optional character string specifying a method for permuting the response variables. This must be one of the strings "sample", "increasing", "decreasing" (default) or "full". The version "full" is invariant with respect to permutations of the response variables.
Details
The directed dependence coefficient (didec) is an extension of Azadkia & Chatterjee's measure of directed dependence (Azadkia & Chatterjee, 2021) to a vector of response variables introduced in (Ansari & Fuchs, 2023).
Its calculation is based on the function codec which estimates Azadkia & Chatterjee’s measure of directed dependence and is provided in the R package FOCI.
By definition, didec is invariant with respect to permutations of the variables within the predictor vector X. Invariance with respect to permutations within the response vector Y is achieved by computing the arithmetic mean over all possible (or chosen) permutations.
In addition to the option "full" of running all q! permutations of (1, ..., q), less computationally intensive options are also available (here, q denotes the number of response variables): a random selection of q permutations "sample", cyclic permutations such as (1,2,...,q), (2,...,q,1) either "increasing" or "decreasing".
Note that when the number of variables q is large, choosing "full" may result in long computation times.
Value
The degree of directed dependence of the random vector Y on the random vector X.
Author(s)
Yuping Wang, Sebastian Fuchs, Jonathan Ansari
References
M. Azadkia, S. Chatterjee, A simple measure of conditional dependence, Ann. Stat. 49 (6), 2021.
J. Ansari, S. Fuchs, A simple extension of Azadkia & Chatterjee's rank correlation to multi-response vectors, Available at https://arxiv.org/abs/2212.01621, 2024.
didec documentation built on Sept. 14, 2024, 9:07 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| didec | R Documentation |
Computes the directed dependence coefficient.
Description
The directed dependence coefficient (didec) estimates the degree of directed dependence of a random vector Y on a random vector X, based on an i.i.d. sample of (X,Y).
Usage
didec(X, Y, perm = FALSE, perm.method = c("decreasing"))
Arguments
X |
A numeric matrix or data.frame/data.table. Contains the predictor vector X. |
Y |
A numeric matrix or data.frame/data.table. Contains the response vector Y. |
perm |
A logical. If |
perm.method |
An optional character string specifying a method for permuting the response variables. This must be one of the strings |
Details
The directed dependence coefficient (didec) is an extension of Azadkia & Chatterjee's measure of directed dependence (Azadkia & Chatterjee, 2021) to a vector of response variables introduced in (Ansari & Fuchs, 2023).
Its calculation is based on the function codec which estimates Azadkia & Chatterjee’s measure of directed dependence and is provided in the R package FOCI.
By definition, didec is invariant with respect to permutations of the variables within the predictor vector X. Invariance with respect to permutations within the response vector Y is achieved by computing the arithmetic mean over all possible (or chosen) permutations.
In addition to the option "full" of running all q! permutations of (1, ..., q), less computationally intensive options are also available (here, q denotes the number of response variables): a random selection of q permutations "sample", cyclic permutations such as (1,2,...,q), (2,...,q,1) either "increasing" or "decreasing".
Note that when the number of variables q is large, choosing "full" may result in long computation times.
Value
The degree of directed dependence of the random vector Y on the random vector X.
Author(s)
Yuping Wang, Sebastian Fuchs, Jonathan Ansari
References
M. Azadkia, S. Chatterjee, A simple measure of conditional dependence, Ann. Stat. 49 (6), 2021.
J. Ansari, S. Fuchs, A simple extension of Azadkia & Chatterjee's rank correlation to multi-response vectors, Available at https://arxiv.org/abs/2212.01621, 2024.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.