scirpy.pl.group_abundance

scirpy.pl.group_abundance#

scirpy.pl.group_abundance(adata, groupby, target_col='has_ir', *, normalize=None, max_cols=None, sort='count', **kwargs)#

Plots the number of cells per group, split up by a categorical variable.
`

Plots the number of cells per group, split up by a categorical variable.

Generates a stacked bar chart with one bar per group. Stacks are colored according to the categorical variable specified in target_col.

Ignores NaN values.

Parameters:
  • adata (AnnData | MuData) – AnnData object to work on.

  • groupby (str) – Group by this column from obs. For instance, “sample” or “diagnosis”.

  • target_col (str (default: 'has_ir')) – Column on which to compute the abundance. Defaults to has_ir which computes the number of all cells that have a T-cell receptor.

  • normalize (Union[str, bool, None] (default: None)) – If True, compute fractions of abundances relative to the groupby column rather than reporting abosolute numbers. Alternatively, the name of a column containing a categorical variable can be provided, according to which the values will be normalized.

  • max_cols (Optional[int] (default: None)) – Only plot the first max_cols columns. If set to None (the default) the function will raise a ValueError if attempting to plot more than 100 columns. Set to 0 to disable.

  • sort (Union[Literal['count', 'alphabetical'], Sequence[str]] (default: 'count')) – How to arrange the dataframe columns. Default is by the category count (“count”). Other options are “alphabetical” or to provide a list of column names. By providing an explicit list, the DataFrame can also be subsetted to specific categories. Sorting (and subsetting) occurs before max_cols is applied.

  • **kwargs – Additional arguments passed to scirpy.pl.base.bar().

Return type:

Axes

Returns:

Axes object