New in 0.14.0 (2021-10-07)

In this release, we have completely revamped the scvi-tools documentation website by creating a new set of user guides that provide:

  1. The math behind each method (in a succinct, online methods-like way)

  2. The relationship between the math and the functions associated with each model

  3. The relationship between math variables and code variables

Our previous User Guide guide has been renamed to Tutorials and contains all of our existing tutorials (including tutorials for developers).

Another noteworthy addition in this release is the implementation of the (amortized) Latent Dirichlet Allocation (aka LDA) model applied to single-cell gene expression data. We have also prepared a tutorial that demonstrates how to use this model, using a PBMC 10K dataset from 10x Genomics as an example application.

Lastly, in this release we have made a change to reduce user and developer confusion by making the previously global setup_anndata method a static class-specific method instead. This provides more clarity on which parameters are applicable for this call, for each model class. Below is a before/after for the DESTVI and TOTALVI model classes:

setup_anndata before and after

setup_anndata before and after


  • Added fixes to support PyTorch Lightning 1.4 (#1103)

  • Simplified data handling in R tutorials with sceasy and addressed bugs in package installation (#1122).

  • Moved library size distribution computation to model init (#1123)

  • Updated Contribution docs to describe how we backport patches (#1129)

  • Implemented Latent Dirichlet Allocation as a PyroModule (#1132)

  • Made setup_anndata a static method on model classes rather than one global function (#1150)

  • Used Pytorch Lightning’s seed_everything method to set seed (#1151)

  • Fixed a bug in PyroSampleMixin for posterior sampling (#1158)

  • Added CITE-Seq datasets (#1182)

  • Added user guides to our documentation (#1127, #1157, #1180, #1193, #1183, #1204)

  • Early stopping now prints the reason for stopping when applicable (#1208)

Breaking changes

  • setup_anndata is now an abstract method on model classes. Any model inheriting from BaseModelClass will need to implement this method (#1150)