dcor
dcor: distance correlation and energy statistics in Python.
E-statistics are functions of distances between statistical observations in metric spaces.
Distance covariance and distance correlation are dependency measures between random vectors introduced in [SRB07] with a simple E-statistic estimator.
This package offers functions for calculating several E-statistics such as:
Estimator of the energy distance [SR13].
Biased and unbiased estimators of distance covariance and distance correlation [SRB07].
Estimators of the partial distance covariance and partial distance covariance [SR14].
It also provides tests based on these E-statistics:
Test of homogeneity based on the energy distance.
Test of independence based on distance covariance.
Installation
dcor is on PyPi and can be installed using pip:
pip install dcor
It is also available for conda using the conda-forge channel:
conda install -c conda-forge dcor
Previous versions of the package were in the vnmabus channel. This
channel will not be updated with new releases, and users are recommended to
use the conda-forge channel.
Requirements
dcor is available in Python 3.8 or above in all operating systems. The package dcor depends on the following libraries:
numpy
numba >= 0.51
scipy
joblib
Citing dcor
Please, if you find this software useful in your work, reference it citing the following paper:
@article{ramos-carreno+torrecilla_2023_dcor,
author = {Ramos-Carreño, Carlos and Torrecilla, José L.},
doi = {10.1016/j.softx.2023.101326},
journal = {SoftwareX},
month = {2},
title = {{dcor: Distance correlation and energy statistics in Python}},
url = {https://www.sciencedirect.com/science/article/pii/S2352711023000225},
volume = {22},
year = {2023},
}
You can additionally cite the software repository itself using:
@misc{ramos-carreno_2022_dcor,
author = {Ramos-Carreño, Carlos},
doi = {10.5281/zenodo.3468124},
month = {3},
title = {dcor: distance correlation and energy statistics in Python},
url = {https://github.com/vnmabus/dcor},
year = {2022}
}
If you want to reference a particular version for reproducibility, check the version-specific DOIs available in Zenodo.
Documentation
The documentation can be found in https://dcor.readthedocs.io/en/latest/?badge=latest
References
Gábor J. Székely and Maria L. Rizzo. Energy statistics: a class of statistics based on distances. Journal of Statistical Planning and Inference, 143(8):1249 – 1272, 2013. URL: http://www.sciencedirect.com/science/article/pii/S0378375813000633, doi:10.1016/j.jspi.2013.03.018.
Gábor J. Székely and Maria L. Rizzo. Partial distance correlation with methods for dissimilarities. The Annals of Statistics, 42(6):2382–2412, 12 2014. doi:10.1214/14-AOS1255.
Metadata
Release files for dcor 0.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dcor-0.7.tar.gz | 69.1 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| dcor-0.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 113.6 kB
Release files / dcor-0.7.tar.gz
| Download URL | dcor-0.7.tar.gz |
|---|---|
| Size | 69.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
386d408596d7ec39af28b52c89e9fc438c4f13d8ed3d673e2c3b21029f57cbce
|
|
BLAKE2b-256 checksum How to use checksums |
14872a3141de80310e503d11d5f23d951c41a7f86aeae2045bbec54a480c748a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / dcor-0.7-py3-none-any.whl
| Download URL | dcor-0.7-py3-none-any.whl |
|---|---|
| Size | 44.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2a5875467d2b554a9d7673e574a26f9ba06fc53f3229d49cd9a18c90d7d25042
|
|
BLAKE2b-256 checksum How to use checksums |
a470d82c194d53d684b6e75a228170a36f414cc86f5824693f6b0e443032461d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Security for dcor 0.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.