scanpy.pl.rank_genes_groups_heatmap

scanpy.pl.rank_genes_groups_heatmap(adata, groups=None, n_genes=None, groupby=None, gene_symbols=None, var_names=None, min_logfoldchange=None, key=None, show=None, save=None, **kwds)

Plot ranking of genes using heatmap plot (see heatmap())

Parameters

adata : AnnDataAnnData: Annotated data matrix.
groups : str | Sequence[str] | NoneUnion[str, Sequence[str], None] (default: None): The groups for which to show the gene ranking.
n_genes : int | NoneOptional[int] (default: None): Number of genes to show. This can be a negative number to show for example the down regulated genes. eg: num_genes=-10. Is ignored if gene_names is passed.
gene_symbols : str | NoneOptional[str] (default: None): Column name in .var DataFrame that stores gene symbols. By default var_names refer to the index column of the .var DataFrame. Setting this option allows alternative names to be used.
groupby : str | NoneOptional[str] (default: None): The key of the observation grouping to consider. By default, the groupby is chosen from the rank genes groups parameter but other groupby options can be used. It is expected that groupby is a categorical. If groupby is not a categorical observation, it would be subdivided into num_categories (see dotplot()).
min_logfoldchange : float | NoneOptional[float] (default: None): Value to filter genes in groups if their logfoldchange is less than the min_logfoldchange
key : str | NoneOptional[str] (default: None): Key used to store the ranking results in adata.uns.
show : bool | NoneOptional[bool] (default: None): Show the plot, do not return axis.
save : bool | NoneOptional[bool] (default: None): If True or a str, save the figure. A string is appended to the default filename. Infer the filetype if ending on {'.pdf', '.png', '.svg'}.
ax: A matplotlib axes object. Only works if plotting a single component.
**kwds: Are passed to heatmap().
show: Show the plot, do not return axis.
save: If True or a str, save the figure. A string is appended to the default filename. Infer the filetype if ending on {'.pdf', '.png', '.svg'}.
ax: A matplotlib axes object. Only works if plotting a single component.

Examples

import scanpy as sc
adata = sc.datasets.pbmc68k_reduced()
sc.tl.rank_genes_groups(adata, 'bulk_labels')
sc.pl.rank_genes_groups_heatmap(adata)

../_images/scanpy-pl-rank_genes_groups_heatmap-1.png

Show gene names per group on the heatmap

sc.pl.rank_genes_groups_heatmap(adata, show_gene_labels=True)

../_images/scanpy-pl-rank_genes_groups_heatmap-2.png

Plot top 5 genes per group (default 10 genes)

sc.pl.rank_genes_groups_heatmap(adata, n_genes=5, show_gene_labels=True)

../_images/scanpy-pl-rank_genes_groups_heatmap-3.png