matplotlib.pyplot.violinplot

matplotlib.pyplot.violinplot(dataset, positions=None, vert=True, widths=0.5, showmeans=False, showextrema=True, showmedians=False, points=100, bw_method=None, *, data=None) [source]

Построение диаграммы "скрипка".

Построение диаграммы "скрипка" для каждого столбца набора данных dataset или каждого вектора в последовательности dataset. Каждая залитая область представляет весь диапазон данных, с опциональными линиями в средних значениях, медиане, минимуме и максимуме.

Параметры:

dataset : Array or a sequence of vectors. Входные данные. positions : array-like, default = [1, 2, ..., n] Устанавливает позиции скрипок. Отметки и пределы автоматически устанавливаются в соответствии с позициями. vert : bool, default = True. Если True, создаёт вертикальную диаграмму "скрипка". В противном случае, создаёт горизонтальную диаграмму "скрипка". widths : array-like, default = 0.5 Значение, устанавливающее максимальную ширину каждой скрипки. По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства. showmeans : bool, default = False Если True, отображает средние значения. showextrema : bool, default = True Если True, отображает экстремумы. showmedians : bool, default = False Если True, отображает медианы. points : scalar, default = 100 Определяет количество точек для оценки каждой из аппроксимаций плотности вероятности с помощью гауссовых ядер. bw_method : str, scalar or callable, optional Метод вычисления ширины полосы оценивателя. Может быть 'scott', 'silverman', скалярной константой или вызываемой функцией. Если скалярное значение, оно будет использоваться непосредственно как kde.factor. Если вызываемая функция, она должна принимать экземпляр GaussianKDE в качестве единственного параметра и возвращать скаляр. Если None (по умолчанию), используется 'scott'.

Возвращает:

result : dict Словарь, сопоставляющий каждый компонент диаграммы "скрипка" с списком соответствующих экземпляров коллекций, созданных. Словарь имеет следующие ключи: bodies: Список экземпляров matplotlib.collections.PolyCollection, содержащих залитую область каждой скрипки. cmeans: Экземпляр matplotlib.collections.LineCollection, созданный для определения средних значений каждой из распределений скрипки. cmins: Экземпляр matplotlib.collections.LineCollection, созданный для определения нижней части каждого распределения скрипки. cmaxes: Экземпляр matplotlib.collections.LineCollection, созданный для определения верхней части каждого распределения скрипки. cbars: Экземпляр matplotlib.collections.LineCollection, созданный для определения центров каждого распределения скрипки. cmedians: Экземпляр matplotlib.collections.LineCollection, созданный для определения медианных значений каждого из распределений скрипки.

Примечания

Примечание

Помимо перечисленных выше аргументов, эта функция может принимать аргумент data. Если такой аргумент data предоставлен, следующие аргументы заменяются на data[<arg>]:

• Все аргументы с следующими именами: 'dataset'.

Объекты, передаваемые как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку принадлежности (<arg> in data).