ScVI is a variational inference model for single-cell RNA-seq data that can learn an underlying latent space, integrate technical batches and impute dropouts.
Model Card
By Scvi Tools, published under cc-by-4.0, revision 650a5c84a8ed.
ScVI is a variational inference model for single-cell RNA-seq data that can learn an underlying latent space, integrate technical batches and impute dropouts. The learned low-dimensional latent representation of the data can be used for visualization and clustering. scVI takes as input a scRNA-seq gene expression matrix with cells and genes. We provide an extensive user guide. - See our original manuscript for further details of the model: - See our manuscript on scvi-hub how to leverage pre-trained models. This model can be used for fine tuning on new data using our Arches framework: scVI model trained on synthetic IID data and uploaded with the full training data. We provide here key…
Read Scvi Tools's full model card
ScVI is a variational inference model for single-cell RNA-seq data that can learn an underlying latent space, integrate technical batches and impute dropouts. The learned low-dimensional latent representation of the data can be used for visualization and clustering.
scVI takes as input a scRNA-seq gene expression matrix with cells and genes. We provide an extensive user guide.
- See our original manuscript for further details of the model: scVI manuscript.
- See our manuscript on scvi-hub how to leverage pre-trained models.
This model can be used for fine tuning on new data using our Arches framework: Arches tutorial.
Model Description
scVI model trained on synthetic IID data and uploaded with the full training data.
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 | 1.02 | 0.97 | | Pearson Correlation | -0.03 | 0.22 | | Spearman Correlation | -0.02 | 0.18 | | R² (R-Squared) | -12.57 | -15.25 | 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 | 1.07 | | Pearson Correlation | -0.10 | | Spearman Correlation | 0.01 | | R² (R-Squared) | -2.36 |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 | | --- | --- | --- | --- | --- | --- | --- | --- | | 0 | 0.10 | 0.87 | 0.07 | 0.08 | 0.46 | 0.34 | 52.00 | | 1 | 0.10 | 0.84 | 0.04 | 0.07 | 0.46 | 0.24 | 51.00 | | 2 | 0.10 | 0.94 | 0.01 | -0.01 | 0.46 | 0.31 | 41.00 | | 3 | 0.20 | 0.87 | -0.06 | -0.03 | 0.64 | 0.29 | 40.00 | | 4 | 0.10 | 0.93 | -0.00 | -0.03 | 0.51 | 0.20 | 37.00 | | 5 | 0.00 | 1.08 | -0.22 | -0.20 | 0.60 | 0.24 | 36.00 | | 6 | 0.00 | 1.09 | -0.12 | -0.12 | 0.52 | 0.35 | 35.00 | | 7 | 0.00 | 0.97 | 0.05 | 0.02 | 0.35 | 0.18 | 33.00 | | 8 | 0.00 | 1.00 | -0.07 | -0.06 | 0.46 | 0.20 | 30.00 | | 9 | 0.10 | 1.05 | -0.05 | -0.01 | 0.63 | 0.20 | 28.00 | | 10 | 0.20 | 1.25 | 0.02 | 0.06 | 0.46 | 0.16 | 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": 10,
"n_layers": 1,
"dropout_rate": 0.1,
"dispersion": "gene",
"gene_likelihood": "zinb",
"use_observed_lib_size": true,
"latent_distribution": "normal"
}
Setup Data Arguments
Arguments passed to setup_anndata of the original model:{
"layer": null,
"batch_key": null,
"labels_key": null,
"size_factor_key": null,
"categorical_covariate_keys": null,
"continuous_covariate_keys": null
}
Data Registry
Registry elements for AnnData manager: | Registry Key | scvi-tools Location | |--------------------------|--------------------------------------| | X | adata.X | | batch | adata.obs['_scvi_batch'] | | labels | adata.obs['_scvi_labels'] | - **Data is Minified**: FalseSummary Statistics
| Summary Stat Key | Value | |--------------------------|-------| | n_batch | 1 | | n_cells | 400 | | n_extra_categorical_covs | 0 | | n_extra_continuous_covs | 0 | | n_labels | 1 | | n_vars | 100 |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**: Not provided by uploaderReferences
To be added...
Identity and Version
- Repository
- scvi-tools/test-scvi
- Publisher
- Scvi Tools
- Task
- Not stated by the source
- Modality
- Other
- Library
- scvi-tools
- Parameters
- Not stated by the source
- Languages
- Not stated by the source
- Revision
- 650a5c84a8ed9064c1a62c90bbb9c5123fd35b90
- First published
- 2024-01-22
- Last updated
- 2026-09-18
Files and Weights
6 files, 1.3 MB in total. The weights are 1 file totalling 306.9 KB in pt.
Every file
| File | Type | Size | SHA-256 |
|---|---|---|---|
| model.pt | Weights | 306.9 KB | b5c79c351587 |
| _scvi_required_metadata.json | Configuration | 166 B | — |
| metrics.json | Configuration | 1.4 KB | — |
| README.md | Documentation | 6.0 KB | — |
| adata.h5ad | Other | 1.0 MB | 9215c231e9c6 |
| .gitattributes | Repository | 1.6 KB | — |
License and Download
- License
- cc-by-4.0
- Access
- Open weights, no gate
- Download size
- 306.9 KB
Released by Scvi Tools through its official repository on Hugging Face. Read the license.
Memory Requirements
| Precision | Weights in memory |
|---|---|
| As published | 306.9 KB |
Weights only, from the published parameter count; the key-value cache and runtime add to this.
Questions About test-scvi
Can I use test-scvi commercially?
Yes. test-scvi is released under Creative Commons Attribution 4.0. CC BY 4.0 permits sharing and adapting the work, including commercially, provided the creator is credited and changes are indicated.