, groups=None, n_genes=20, gene_names=None, gene_symbols=None, use_raw=None, key=None, split=True, scale='width', strip=True, jitter=True, size=1, ax=None, show=None, save=None)

Plot ranking of genes for all tested comparisons.

adata : AnnData

Annotated data matrix.

groups : list of str, optional (default: None)

List of group names.

n_genes : int, optional (default: 20)

Number of genes to show. Is ignored if gene_names is passed.

gene_names : None or list of str (default: None)

List of genes to plot. Is only useful if interested in a custom gene list, which is not the result of

gene_symbols : str, optional (default: None)

Key for field in .var that stores gene symbols if you do not want to use .var_names displayed in the plot.

use_raw : bool, optional (default: None)

Use raw attribute of adata if present. Defaults to the value that was used in rank_genes_groups().

split : bool, optional (default: True)

Whether to split the violins or not.

scale : str, optional (default: ‘width’)

See seaborn.violinplot.

strip : bool, optional (default: True)

Show a strip plot on top of the violin plot.

jitter : int, float, bool, optional (default: True)

If set to 0, no points are drawn. See seaborn.stripplot.

size : int, optional (default: 1)

Size of the jitter points.


Show the plot, do not return axis.


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’}.


A matplotlib axes object. Only works if plotting a single component.