import numpy as np import holoviews as hv hv.extension('matplotlib')
element is used to visualise the distribution of a dataset by displaying its probability density. It is very similar to the
element but provides a more faithful representation even for bi- or multimodal data. The probability density is shown by the area akin to a vertical and mirrored
element. The thick black bar in the centre represents the interquartile range, the thin black line extended from it represents the 95% confidence intervals, and the white line is the median.
The data of a
Element may have any number of key dimensions representing the grouping of the value dimension and a single value dimensions representing the distribution of values within each group. See the
user guide for supported data formats, which include arrays, pandas dataframes and dictionaries of arrays.
In the simplest case a
can be used to display a single distribution of values, such as a NumPy array of normally distributed values:
np.random.seed(37) violin = hv.Violin(np.random.randn(1000), vdims='Value') violin
The Violin element supports multiple options for indicating the distribution values in addition to the default
value of 'box'. The 'medians' option indicates the median as a single line instead. Additionally the
option may be used to control the kernel density estimate:
violin.relabel(group='Medians').options(inner='medians', cut=0.1, bandwidth=0.1)
WARNING:root:main: Option 'cut' for Violin type not valid for selected backend ('matplotlib'). Option only applies to following backends: ['bokeh']
element is particularly useful to compare multiple distribution across different categories. As a simple example we can create a dataset of values with randomly assigned Group and Category values and compare the distributions.
%%opts Violin [fig_size=300 aspect=2.5 show_legend=False] groups = [chr(65+g) for g in np.random.randint(0, 3, 200)] hv.Violin((groups, np.random.randint(0, 5, 200), np.random.randn(200)), ['Group', 'Category'], 'Value')
For full documentation and the available style and plot options, use