### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- `Axes` class »

# 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.

  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.