scmagnify.plotting.barplot

Contents

scmagnify.plotting.barplot#

scmagnify.plotting.barplot(data, modal='GRN', key='regulon_scores', n_top=5, cmap='Blues', xlabel='Score', ylabel='Gene', swap_df=False, figsize=None, dpi=300, nrows=None, ncols=3, wspace=0.4, hspace=0.4, sharex=False, sharey=False, context='notebook', default_context=None, theme='whitegrid', font_scale=1, show=None, save=None, **kwargs)#

Plot top features per group as bar charts.

Parameters:

  • data (AnnData | MuData | GRNMuData) – Single cell data object. Can be an anndata.AnnData, mudata.MuData, scmagnify.GRNMuData

  • modal (Literal['GRN', 'RNA', 'ATAC'] (default: 'GRN')) – Modality key (e.g., ‘RNA’, ‘ATAC’) when using multi-modal data. mudata.MuData or scmagnify.GRNMuData must be provided.

  • key (str (default: 'regulon_scores')) – Key in .varm to retrieve the DataFrame.

  • n_top (int (default: 5)) – Number of top features per group.

  • cmap (str (default: 'Blues')) – Colormap name or object. See matplotlib.cm.

  • xlabel (str | None (default: 'Score')) – Label for the x-axis. If None, use the feature name.

  • ylabel (str | None (default: 'Gene')) – Label for the y-axis. If None, use “Gene”.

  • swap_df (bool (default: False)) – If True, transpose the DataFrame before plotting.

  • figsize (Optional[tuple] (default: None)) – Figure size in inches (width, height). See matplotlib.figure.Figure.

  • dpi (int (default: 300)) – Dots per inch (resolution) of the figure. See matplotlib.figure.Figure.

  • nrows (Optional[int] (default: None)) – Number of subplot rows. If None, it will be calculated automatically.

  • ncols (int | None (default: 3)) – Number of subplot columns. If None, it will be calculated automatically.

  • wspace (float | None (default: 0.4)) – Width space between subplots. See matplotlib.pyplot.subplots().

  • hspace (float | None (default: 0.4)) – Height space between subplots. See matplotlib.pyplot.subplots().

  • sharex (bool | None (default: False)) – If True, subplots will share the x-axis. See matplotlib.pyplot.subplots().

  • sharey (bool | None (default: False)) – If True, subplots will share the y-axis. See matplotlib.pyplot.subplots().

  • context (str | None (default: 'notebook')) – Seaborn context, e.g., ‘notebook’, ‘paper’. See seaborn.set_context().

  • default_context (Optional[dict] (default: None)) – If True, reset to default seaborn context before plotting.

  • theme (str | None (default: 'whitegrid')) – Theme name or rcParams overrides. See seaborn.set_theme().

  • font_scale (float | None (default: 1)) – Scale factor applied to fonts for the plot. See seaborn.set_context().

  • show (Optional[bool] (default: None)) – Whether to display the figure. If None, the figure will be shown by default.

  • save (Optional[str] (default: None)) – Whether to save the figure. If True, the figure is saved to a file using the writekey. If a str is provided, it is used as the filename, potentially overriding other settings. If None or False, the figure is not saved.

Returns:

matplotlib.figure.Figure | None Figure when show is False, otherwise None.

Contents