Python API¶

An API to facilitate use of the CZI Science CELLxGENE Census. The Census is a versioned container of single-cell data hosted at CELLxGENE Discover.

The API is built on the tiledbsoma SOMA API, and provides a number of helper functions including:

Open a named version of the Census, for use with the SOMA API

Get a list of available Census versions, and for each version, a description

Get a slice of the Census as an AnnData, for use with ScanPy

Get the URI for, or directly download, underlying data in H5AD format

For more information on the API, visit the cellxgene_census repo. For more information on SOMA, see the tiledbsoma repo.

Open/retrieve Cell Census data¶

`cellxgene_census.open_soma`	Open the Census by version or URI.
`cellxgene_census.get_source_h5ad_uri`	Open the named version of the census, and return the URI for the `dataset_id`.
`cellxgene_census.download_source_h5ad`	Download the source H5AD dataset, for the given dataset_id, to the user-specified file name.

Get slice as AnnData¶

cellxgene_census.get_anndata

Convience wrapper around soma.Experiment query, to build and execute a query, and return it as an anndata.AnnData object.

Feature presence matrix¶

cellxgene_census.get_presence_matrix

Read the feature dataset presence matrix and return as a SciPy sparse CSR array.

Versioning of Cell Census builds¶

`cellxgene_census.get_census_version_description`	Get release description for given Census version, from the Census release directory.
`cellxgene_census.get_census_version_directory`	Get the directory of Census versions currently available, optionally filtering by specified flags.

Experimental: Machine Learning¶

`cellxgene_census.experimental.ml.pytorch.experiment_dataloader`	Factory method for PyTorch `DataLoader`.
`cellxgene_census.experimental.ml.pytorch.ExperimentDataPipe`	An iterable-style PyTorch `DataPipe` that reads `obs` and `X` data from a SOMA `Experiment`, based upon the specified queries along the `obs` and `var` axes.
`cellxgene_census.experimental.ml.pytorch.Stats`	Statistics about the data retrieved by `ExperimentDataPipe` via SOMA API.

Experimental: Processing¶

`cellxgene_census.experimental.pp.get_highly_variable_genes`	Convenience wrapper
`cellxgene_census.experimental.pp.highly_variable_genes`	Identify and annotate highly variable genes contained in the query results.
`cellxgene_census.experimental.pp.mean_variance`	Calculate mean and/or variance along the `obs` axis from query results.

Experimental: Utility¶

cellxgene_census.experimental.util.X_sparse_iter

NOTE: this API is deprecated as of version 1.8, and will be removed in version 1.9.