scanpy.pl.DotPlot.add_totals

DotPlot.add_totals(*, show=True, sort=None, size=0.8, color=None)

Show barplot for the number of cells in in groupby category.

The barplot is by default shown on the right side of the plot or on top if the axes are swapped.

Parameters:

show bool | None (default: True)

Boolean to turn on (True) or off (False) ‘add_totals’

sort Optional[Literal['ascending', 'descending']] (default: None)

Set to either ‘ascending’ or ‘descending’ to reorder the categories by cell number

size float | None (default: 0.8)

size of the barplot. Corresponds to width when shown on the right of the plot, or height when shown on top. The unit is the same as in matplotlib (inches).

color str | tuple[float, ...] | Sequence[str | tuple[float, ...]] | None (default: None)

Color for the bar plots or list of colors for each of the bar plots. By default, each bar plot uses the colors assigned in adata.uns[{groupby}_colors].

Return type:

Self

Returns:

Returns self for method chaining.

Examples

>>> import scanpy as sc
>>> adata = sc.datasets.pbmc68k_reduced()
>>> markers = {'T-cell': 'CD3D', 'B-cell': 'CD79A', 'myeloid': 'CST3'}
>>> plot = sc.pl._baseplot_class.BasePlot(adata, markers, groupby='bulk_labels').add_totals()
>>> plot.plot_group_extra['counts_df']  
bulk_labels
CD4+/CD25 T Reg                  68
CD4+/CD45RA+/CD25- Naive T        8
CD4+/CD45RO+ Memory              19
CD8+ Cytotoxic T                 54
CD8+/CD45RA+ Naive Cytotoxic     43
CD14+ Monocyte                  129
CD19+ B                          95
CD34+                            13
CD56+ NK                         31
Dendritic                       240
Name: count, dtype: int64