sc-musketeers 0.7.0

A tri-partite modular autoencoder for addressing imbalanced cell type annotation and batch effect reduction

scMusketeers : A tri-partite modular autoencoder for addressing imbalanced cell type annotation and batch effect reduction

Summary

We developed scMusketeer, a modular deep learning model producing an optimal dimension-reduced representation with a focus on imbalanced cell type annotation and batch effect reduction. The architecture of scMusketeers is made of three modules. The first module is an autoencoder which provides a reduced latent representation, while removing noise, thus resulting in a better data reconstruction. The second module, is a classifier with a focal loss providing higher prediction for smaller populations of cell types. The third module is an adversarial domain adaptation (DANN) module that corrects batch effect.

scMusketeers performance was optimized after conducting a precise ablation study to assess model's hyperparameters. The model was compared to reference tools for single-cell integration and annotation. It was at least on par with state-of-the-art models, often outperforming most of them. It showed increased performance on the identification of rare cell types. Despite the rather simple structure of its deep learning model, it demonstrated equivalent performance to UCE foundation model. Finally, scMusketeers was able to transfer the cell label from single-cell RNA-Seq to spatial transcriptomics.

Our tripartite modular autoencoder demonstrates versatile capabilities while addressing key challenges in single-cell atlas reconstruction. We noticed in particular that the generic modular framework of scMusketeers should be easily generalized to other large-scale biology projects that require deep learning models.

Publication

scMusketeers: Addressing imbalanced cell type annotation and batch effect reduction with a modular autoencoder. Collin A., Pelletier S., Fierville M., Droit A., Precioso F., Bécavin C., Barbry P. BioRXiv

Tutorial

Access to the tutorial on Google collab

We will see in this tutorial two use-cases:

• Transfer cell annotation to unlabeled cells
• Transfer cell annotation and reduce batch from a query atlas to a reference atlas

Install

sc-musketeers needs a TensorFlow backend, and you choose which build to install through an extra:

• GPU (GPU-capable TensorFlow):

  $ pip install "sc-musketeers[gpu]"
  

• CPU only (smaller, no CUDA):

  $ pip install "sc-musketeers[cpu]"
  

Note: pick exactly one extra. sc-musketeers[gpu] pulls in tensorflow while sc-musketeers[cpu] pulls in tensorflow-cpu; both provide the same import tensorflow, so installing only one avoids a conflict. A bare pip install sc-musketeers (no extra) installs no TensorFlow and the CLI will fail to import — always specify [gpu] or [cpu].

with conda

$ conda -c bioconda sc-musketeers

with docker

$ docker pull quay.io/biocontainers/sc-musketeers:0.4.1--pyhdfd78af_0

with singularity

$ singularity run https://depot.galaxyproject.org/singularity/sc-musketeers:0.3.7--pyhdfd78af_0

Examples

sc-musketeers can be used for different task in integration and annotation of single-cell atlas.

Here are 2 different examples:

• Transfer cell annotation to unlabeled cells

$ sc-musketeers transfer my_atlas --class_key celltype --batch_key donor --unlabeled_category=Unknown

• Transfer cell annotation and reduce batch from a query atlas to a reference atlas

$ sc-musketeers transfer ref_dataset --query_path query_dataset --class_key=celltype --batch_key donor --unlabeled_category=Unknown

Read the CONTRIBUTING.md file.