rapids_singlecell.tl.embedding_density

rapids_singlecell.tl.embedding_density(adata, basis='umap', *, groupby=None, key_added=None, components=None)

Calculate the density of cells in an embedding (per condition). Gaussian kernel density estimation is used to calculate the density of cells in an embedded space. This can be performed per category over a categorical cell annotation. The cell density can be plotted using the pl.embedding_density function. Note that density values are scaled to be between 0 and 1. Thus, the density value at each cell is only comparable to densities in the same category. This function was written by Sophie Tritschler and implemented into Scanpy by Malte Luecken. :type adata: AnnData :param adata: The annotated data matrix. :type basis: str (default: 'umap') :param basis: The embedding over which the density will be calculated. This embedded

representation should be found in adata.obsm['X_[basis]']`.

Parameters:

groupby str | None (default: None)

Key for categorical observation/cell annotation for which densities are calculated per category.

key_added str | None (default: None)

Name of the .obs covariate that will be added with the density estimates.

components str | Sequence[str] (default: None)

The embedding dimensions over which the density should be calculated. This is limited to two components.

Return type:

None

Returns:

Updates adata.obs with an additional field specified by the key_added parameter. This parameter defaults to [basis]_density_[groupby], where [basis] is one of umap, diffmap, pca, tsne, or draw_graph_fa and [groupby] denotes the parameter input.

Updates adata.uns with an additional field [key_added]_params.