matplotlib.axes.Axes.violin

Axes.violin(vpstats, positions=None, vert=True, widths=0.5, showmeans=False, showextrema=True, showmedians=False)

Drawing function for violin plots.

Call signature:

violin(vpstats, positions=None, vert=True, widths=0.5,
       showmeans=False, showextrema=True, showmedians=False):

Draw a violin plot for each column of vpstats. Each filled area extends to represent the entire data range, with optional lines at the mean, the median, the minimum, and the maximum.

Parameters:

vpstats : list of dicts

A list of dictionaries containing stats for each violin plot. Required keys are:

• coords: A list of scalars containing the coordinates that the violin’s kernel density estimate were evaluated at.
• vals: A list of scalars containing the values of the kernel density estimate at each of the coordinates given in coords.
• mean: The mean value for this violin’s dataset.
• median: The median value for this violin’s dataset.
• min: The minimum value for this violin’s dataset.
• max: The maximum value for this violin’s dataset.

positions : array-like, default = [1, 2, ..., n]

Sets the positions of the violins. The ticks and limits are automatically set to match the positions.

vert : bool, default = True.

If true, plots the violins veritcally. Otherwise, plots the violins horizontally.

widths : array-like, default = 0.5

Either a scalar or a vector that sets the maximal width of each violin. The default is 0.5, which uses about half of the available horizontal space.

showmeans : bool, default = False

If true, will toggle rendering of the means.

showextrema : bool, default = True

If true, will toggle rendering of the extrema.

showmedians : bool, default = False

If true, will toggle rendering of the medians.

Returns:

result : dict

A dictionary mapping each component of the violinplot to a list of the corresponding collection instances created. The dictionary has the following keys:

• bodies: A list of the matplotlib.collections.PolyCollection instances containing the filled area of each violin.
• cmeans: A matplotlib.collections.LineCollection instance created to identify the mean values of each of the violin’s distribution.
• cmins: A matplotlib.collections.LineCollection instance created to identify the bottom of each violin’s distribution.
• cmaxes: A matplotlib.collections.LineCollection instance created to identify the top of each violin’s distribution.
• cbars: A matplotlib.collections.LineCollection instance created to identify the centers of each violin’s distribution.
• cmedians: A matplotlib.collections.LineCollection instance created to identify the median values of each of the violin’s distribution.