Metadata-Version: 2.1
Name: cpa-tools
Version: 0.7.1
Summary: Compositional Perturbation Autoencoder (CPA)
Home-page: https://github.com/theislab/cpa/
License: BSD-3-Clause
Author: Mohsen Naghipourfar
Author-email: naghipourfar@berkeley.edu
Requires-Python: >=3.7.2,<3.11
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: tutorials
Requires-Dist: adjustText
Requires-Dist: anndata (>=0.7.5)
Requires-Dist: black (>=20.8b1); extra == "dev"
Requires-Dist: codecov (>=2.0.8); extra == "dev"
Requires-Dist: flake8 (>=3.7.7); extra == "dev"
Requires-Dist: importlib-metadata (>=1.0,<2.0); python_version < "3.8"
Requires-Dist: ipython (>=7.1.1); extra == "docs"
Requires-Dist: isort (>=5.7); extra == "dev"
Requires-Dist: jupyter (>=1.0); extra == "dev"
Requires-Dist: leidenalg; extra == "tutorials"
Requires-Dist: llvmlite (>=0.38.0,<0.39.0)
Requires-Dist: loompy (>=3.0.6); extra == "dev" or extra == "tutorials"
Requires-Dist: matplotlib (>=3.5.1,<4.0.0)
Requires-Dist: nbconvert (>=5.4.0); extra == "dev"
Requires-Dist: nbformat (>=4.4.0); extra == "dev"
Requires-Dist: nbsphinx-link; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: numpy (>=1.21.5,<2.0.0)
Requires-Dist: pre-commit (>=2.7.1); extra == "dev"
Requires-Dist: pydata-sphinx-theme (>=0.4.0); extra == "docs"
Requires-Dist: pytest (>=4.4); extra == "dev"
Requires-Dist: python-igraph; extra == "tutorials"
Requires-Dist: scanpy (>=1.6); extra == "dev" or extra == "docs" or extra == "tutorials"
Requires-Dist: scanpydoc (>=0.5); extra == "docs"
Requires-Dist: scikit-learn (>=1.0.2,<2.0.0)
Requires-Dist: scikit-misc (>=0.1.3); extra == "tutorials"
Requires-Dist: scipy (>=1.8.0,<2.0.0); extra == "docs" or extra == "tutorials"
Requires-Dist: scvi-tools (>=0.16.4)
Requires-Dist: seaborn (>=0.11.2,<0.12.0)
Requires-Dist: sphinx (>=4.1,<4.4); extra == "docs"
Requires-Dist: sphinx-autodoc-typehints; extra == "docs"
Requires-Dist: sphinx-rtd-theme; extra == "docs"
Requires-Dist: toml (>=0.10); extra == "docs" or extra == "tutorials"
Requires-Dist: typing_extensions; (python_version < "3.8") and (extra == "docs")
Project-URL: Documentation, https://cpa-tools.readthedocs.io
Description-Content-Type: text/markdown

#  CPA - Compositional Perturbation Autoencoder [![PyPI version](https://badge.fury.io/py/cpa-tools.svg)](https://badge.fury.io/py/cpa-tools) [![Documentation Status](https://readthedocs.org/projects/cpa-tools/badge/?version=latest)](https://cpa-tools.readthedocs.io/en/latest/?badge=latest) [![Downloads](https://static.pepy.tech/badge/cpa-tools)](https://pepy.tech/project/cpa-tools)

## What is CPA?

![Alt text](https://user-images.githubusercontent.com/33202701/156530222-c61e5982-d063-461c-b66e-c4591d2d0de4.png?raw=true "Title")

`CPA` is a framework to learn the effects of perturbations at the single-cell level. CPA encodes and learns phenotypic drug responses across different cell types, doses, and combinations. CPA allows:

* Out-of-distribution predictions of unseen drug and gene combinations at various doses and among different cell types.
* Learn interpretable drug and cell-type latent spaces.
* Estimate the dose-response curve for each perturbation and their combinations.
* Transfer pertubration effects from on cell-type to an unseen cell-type.


Usage and installation
-------------------------------
See [here](https://cpa-tools.readthedocs.io/en/latest/index.html) for documentation and tutorials.


How to optmize CPA hyperparamters for your data
-------------------------------


Datasets and Pre-trained models
-------------------------------
Datasets and pre-trained models are available [here](https://drive.google.com/drive/folders/1yFB0gBr72_KLLp1asojxTgTqgz6cwpju?usp=drive_link).


Support and contribute
-------------------------------
If you have a question or new architecture or a model that could be integrated into our pipeline, you can
post an [issue](https://github.com/theislab/cpa/issues/new)

Reference
-------------------------------


If CPA is helpful in your research, please consider citing the  [Lotfollahi et al. 2023](https://www.embopress.org/doi/full/10.15252/msb.202211517)


    @article{lotfollahi2023predicting,
        title={Predicting cellular responses to complex perturbations in high-throughput screens},
        author={Lotfollahi, Mohammad and Klimovskaia Susmelj, Anna and De Donno, Carlo and Hetzel, Leon and Ji, Yuge and Ibarra, Ignacio L and Srivatsan, Sanjay R and Naghipourfar, Mohsen and Daza, Riza M and 
        Martin, Beth and others},
        journal={Molecular Systems Biology},
        pages={e11517},
        year={2023}
    }


