CCA-Zoo

cca-zoo is a collection of linear, kernel, and deep methods for canonical correlation analysis of multiview data. Where possible it follows the scikit-learn/mvlearn APIs and models therefore have fit/transform/fit_transform methods as standard.

Installation

Dependency of some implemented algorithms are heavy, such as pytorch and numpyro. We provide several options to accomodate the user's needs. For full details of algorithms included, please refer to section Implemented Methods

Standard installation:

pip install cca-zoo

For deep learning elements use:

pip install cca-zoo[deep]

For probabilistic elements use:

pip install cca-zoo[probabilistic]

Documentation

Available at https://cca-zoo.readthedocs.io/en/latest/

Citation:

CCA-Zoo is intended as research software. Citations and use of our software help us justify the effort which has gone into, and will keep going into, maintaining and growing this project. Stars on the repo are also greatly appreciated :)

If you have used CCA-Zoo in your research, please consider citing our JOSS paper:

Chapman et al., (2021). CCA-Zoo: A collection of Regularized, Deep Learning based, Kernel, and Probabilistic CCA methods in a scikit-learn style framework. Journal of Open Source Software, 6(68), 3823, https://doi.org/10.21105/joss.03823

With bibtex entry:

@article{Chapman2021,
  doi = {10.21105/joss.03823},
  url = {https://doi.org/10.21105/joss.03823},
  year = {2021},
  publisher = {The Open Journal},
  volume = {6},
  number = {68},
  pages = {3823},
  author = {James Chapman and Hao-Ting Wang},
  title = {CCA-Zoo: A collection of Regularized, Deep Learning based, Kernel, and Probabilistic CCA methods in a scikit-learn style framework},
  journal = {Journal of Open Source Software}
}

Implemented Methods

Standard Install

CCA (Canonical Correlation Analysis): Solutions based on either alternating least squares or as the solution to genrralized eigenvalue problem
PLS (Partial Least Squares)
rCCA (Ridge Regularized Canonical Correlation Analysis)
GCCA (Generalized CCA)
MCCA (Multiset CCA)
K(M)CCA (kernel Multiset CCA)
TCCA (Tensor CCA)
KTCCA (kernel Tensor CCA)
SCCA (Sparse CCA)
SPLS (Sparse PLS/Penalized Matrix Decomposition
ElasticCCA (Penalized CCA)
SWCCA (Sparse Weighted CCA)
SpanCCA

`[deep]` Install

DCCA (Deep CCA)

Using either Andrew's original Tracenorm Objective or Wang's alternating least squares solution
DGCCA (Deep Generalized CCA)

An alternative objective based on the linear GCCA solution. Can be extended to more than 2 views
DMCCA (Deep Multiset CCA)

An alternative objective based on the linear MCCA solution. Can be extended to more than 2 views
DTCCA (Deep Tensor CCA)
DCCAE (Deep Canonically Correlated Autoencoders)
DVCCA/DVCCA Private (Deep variational CCA)

`[probabilistic]` Install

Variational Bayes CCA

Contributions

A guide to contributions is available at https://cca-zoo.readthedocs.io/en/latest/developer_info/contribute.html

Sources

I've added this section to give due credit to the repositories that helped me in addition to their copyright notices in the code where relevant.

Other Implementations of (regularised)CCA/PLS

MATLAB implementation

Implementation of Sparse PLS

MATLAB implementation of SPLS by @jmmonteiro

Other Implementations of DCCA/DCCAE

Keras implementation of DCCA from @VahidooX's github page

The following are the other implementations of DCCA in MATLAB and C++. These codes are written by the authors of the original paper:

Torch implementation of DCCA from @MichaelVll & @Arminarj

C++ implementation of DCCA from Galen Andrew's website

MATLAB implementation of DCCA/DCCAE from Weiran Wang's website

MATLAB implementation of TCCA

Implementation of VAE

Torch implementation of VAE

Zhang-Zong/cca_zoo