|PyPI| |PyPIDownloads| |Docs| |travis|

scArches - single-cell architecture surgery

.. raw:: html

scArches is a package to integrate newly produced single-cell datasets into integrated reference atlases. Our method can facilitate large collaborative projects with decentralized training and integration of multiple datasets by different groups.

Updates

• (6.02.2022) We have added expiMap <https://www.biorxiv.org/content/10.1101/2022.02.05.479217v1>_ to scArches code base. expiMap alows interpretable reference mapping. See tutorials here here <https://scarches.readthedocs.io/>_ .

What can you do with scArches?

• Construct single or multi-modal (CITE-seq) reference atlases and share the trained model and the data (if possible).
• Download a pre-trained model for your atlas of interest, update it with new datasets and share with your collaborators.
• Project and integrate query datasets on the top of a reference and use latent representation for downstream tasks, e.g.:diff testing, clustering, classification

What are the different models?

scArches is an algorithm to map to project query on the top of reference datasets and applies to different models. Here we provide a short explanation and hints on when to use which model. Our models are divided into three categories:

Unsupervised This class of algorithms require no cell type labels, meaning that you can create a reference and project a query without having access to cell type labels. We implemented two algorithms:

• scVI (Lopez et al., 2018 <https://www.nature.com/articles/s41592-018-0229-2>_): Requires access to raw counts values for data integration and assumes count distribution on the data (NB, ZINB, Poisson).

• trVAE (Lotfollahi et al.,2020 <https://academic.oup.com/bioinformatics/article/36/Supplement_2/i610/6055927?guestAccessKey=71253caa-1779-40e8-8597-c217db539fb5>_): It supports both normalized log transformed or count data as input and applies additional MMD loss to have better merging in the latent space.

Supervised and Semi-supervised This class of algorithms assumes the user has access to cell type labels when creating the reference data and usually perform better integration compared to. unsupervised methods. However, query data still can be unlabeled. In addition to integration, you can classify your query cells using these methods.

• scANVI (Xu et al., 2019 <https://www.biorxiv.org/content/10.1101/532895v1>_): It needs cell type labels for reference data. Your query data can be either unlabeled or labeled. In the case of unlabeled query data, you can use this method to also classify your query cells using reference labels.

• scGen (Lotfollahi et al., 2019 <https://www.nature.com/articles/s41592-019-0494-8>_): This method requires cell-type labels for both reference building and query mapping. The query mapping for this method solely relies on the integrated reference and requre no fine-tuning.

Bioligically informed

• expiMap (Lotfollahi, Rybakov et al., 2022 <https://www.biorxiv.org/content/10.1101/2022.02.05.479217v1>_): This method takes prior knowledge from gene sets databases or users allowing to analyze your query data in the context of known gene programs.

Multi-modal These algorithms can be used to construct multi-modal references atlas and map query data from either modality on the top of the reference.

• totalVI (Gayoso al., 2019 <https://www.biorxiv.org/content/10.1101/532895v1>_): This model can be used to build multi-modal CITE-seq reference atalses. Query datasets can be either from sc-RNAseq or CITE-seq. In addition to integrating query with reference, one can use this model to impute the Proteins in the query datasets.

Usage and installation

See here <https://scarches.readthedocs.io/>_ for documentation and tutorials.

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/scarches/issues/new>__ or reach us by email <mailto:cottoneyejoe.server@gmail.com,mo.lotfollahi@gmail.com,mohsen.naghipourfar@gmail.com>_.

Reference

If scArches is useful in your research, please consider citing following paper <https://www.nature.com/articles/s41587-021-01001-7>_: ::

   @article{lotfollahi2021mapping,
     title={Mapping single-cell data to reference atlases by transfer learning},
     author={Lotfollahi, Mohammad and Naghipourfar, Mohsen and Luecken, Malte D and Khajavi,
     Matin and B{\"u}ttner, Maren and Wagenstetter, Marco and Avsec, {\v{Z}}iga and Gayoso,
     Adam and Yosef, Nir and Interlandi, Marta and others},
     journal={Nature Biotechnology},
     pages={1--10},
     year={2021},
     publisher={Nature Publishing Group}}

.. |PyPI| image:: https://img.shields.io/pypi/v/scarches.svg :target: https://pypi-hypernode.com/project/scarches

.. |PyPIDownloads| image:: https://pepy.tech/badge/scarches :target: https://pepy.tech/project/scarches

.. |Docs| image:: https://readthedocs.org/projects/scarches/badge/?version=latest :target: https://scarches.readthedocs.io

.. |travis| image:: https://travis-ci.com/theislab/scarches.svg?branch=master :target: https://travis-ci.com/theislab/scarches