canergen's picture
Upload README.md with huggingface_hub
b815621 verified
metadata
library_name: scvi-tools
license: cc-by-4.0
tags:
  - biology
  - genomics
  - single-cell
  - model_cls_name:CondSCVI
  - scvi_version:1.2.0
  - anndata_version:0.11.1
  - modality:rna
  - tissue:various
  - annotated:True

CondSCVI is a variational inference model for single-cell RNA-seq data that can learn an underlying latent space. The predictions of the model are meant to be afterward used for deconvolution of a second spatial transcriptomics dataset in DestVI. DestVI predicts the cell-type proportions as well as cell type-specific activation state in the spatial data.

CondSCVI takes as input a scRNA-seq gene expression matrix with cells and genes as well as a cell-type annotation for all cells. We provide an extensive user guide for DestVI including a description of CondSCVI.

  • See our original manuscript for further details of the model: DestVI manuscript.
  • See our manuscript on scvi-hub how to leverage pre-trained models.

Model Description

Tabula Sapiens is a benchmark, first-draft human cell atlas of nearly 500,000 cells from 24 organs of 15 normal human subjects.

Metrics

We provide here key performance metrics for the uploaded model, if provided by the data uploader.

Coefficient of variation

The cell-wise coefficient of variation summarizes how well variation between different cells is preserved by the generated model expression. Below a squared Pearson correlation coefficient of 0.4 , we would recommend not to use generated data for downstream analysis, while the generated latent space might still be useful for analysis.

Cell-wise Coefficient of Variation:

Metric Training Value Validation Value
Mean Absolute Error 2.86 2.90
Pearson Correlation 0.26 0.24
Spearman Correlation 0.15 0.16
R² (R-Squared) -2.31 -2.69

The gene-wise coefficient of variation summarizes how well variation between different genes is preserved by the generated model expression. This value is usually quite high.

Gene-wise Coefficient of Variation:

Metric Training Value
Mean Absolute Error 40.24
Pearson Correlation 0.56
Spearman Correlation 0.60
R² (R-Squared) -4.25
Differential expression metric

The differential expression metric provides a summary of the differential expression analysis between cell types or input clusters. We provide here the F1-score, Pearson Correlation Coefficient of Log-Foldchanges, Spearman Correlation Coefficient, and Area Under the Precision Recall Curve (AUPRC) for the differential expression analysis using Wilcoxon Rank Sum test for each cell-type.

Differential expression:

Index gene_f1 lfc_mae lfc_pearson lfc_spearman roc_auc pr_auc n_cells
B cell 0.91 0.78 0.62 0.94 0.30 0.87 15249.00
effector CD4-positive, alpha-beta T cell 0.78 1.29 0.49 0.87 0.27 0.77 6908.00
effector CD8-positive, alpha-beta T cell 0.84 1.40 0.54 0.87 0.27 0.77 5860.00
T cell 0.71 1.76 0.51 0.81 0.25 0.72 3848.00
type I NK T cell 0.74 1.66 0.50 0.80 0.31 0.71 3758.00
plasma cell 0.86 1.57 0.61 0.89 0.41 0.91 2426.00
innate lymphoid cell 0.78 1.95 0.45 0.67 0.25 0.59 2052.00
macrophage 0.80 2.02 0.65 0.88 0.48 0.89 1086.00
regulatory T cell 0.79 3.02 0.55 0.71 0.41 0.71 881.00
mature NK T cell 0.77 3.97 0.53 0.60 0.41 0.65 437.00
classical monocyte 0.89 4.04 0.63 0.70 0.46 0.76 161.00
endothelial cell 0.75 3.66 0.62 0.76 0.60 0.85 143.00
intermediate monocyte 0.77 4.11 0.61 0.70 0.51 0.79 134.00
mast cell 0.79 6.26 0.48 0.43 0.45 0.77 119.00
stromal cell 0.79 4.15 0.65 0.77 0.56 0.86 111.00
neutrophil 0.84 5.75 0.55 0.52 0.41 0.84 107.00
CD1c-positive myeloid dendritic cell 0.73 4.22 0.64 0.70 0.53 0.79 68.00
CD141-positive myeloid dendritic cell 0.71 5.20 0.56 0.55 0.49 0.75 48.00
hematopoietic stem cell 0.44 5.68 0.51 0.41 0.46 0.65 34.00
non-classical monocyte 0.61 5.62 0.55 0.51 0.41 0.69 31.00
erythrocyte 0.53 6.65 0.40 0.34 0.49 0.83 24.00
mature conventional dendritic cell 0.47 6.83 0.45 0.33 0.39 0.61 17.00

Model Properties

We provide here key parameters used to setup and train the model.

Model Parameters

These provide the settings to setup the original model:

{
    "n_hidden": 128,
    "n_latent": 5,
    "n_layers": 2,
    "weight_obs": false,
    "dropout_rate": 0.05
}
Setup Data Arguments

Arguments passed to setup_anndata of the original model:

{
    "labels_key": "cell_ontology_class",
    "layer": null,
    "batch_key": null
}
Data Registry

Registry elements for AnnData manager:

Registry Key scvi-tools Location
X adata.X
labels adata.obs['_scvi_labels']
  • Data is Minified: False
Summary Statistics
Summary Stat Key Value
n_cells 43502
n_labels 22
n_vars 3000
Training

Training data url: Not provided by uploader

If provided by the original uploader, for those interested in understanding or replicating the training process, the code is available at the link below.

Training Code URL: https://github.com/YosefLab/scvi-hub-models/blob/main/src/scvi_hub_models/TS_train_all_tissues.ipynb

References

The Tabula Sapiens Consortium. The Tabula Sapiens: A multiple-organ, single-cell transcriptomic atlas of humans. Science, May 2022. doi:10.1126/science.abl4896