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, hold=None, data=None)

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

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

Параметры:

Параметры:	dataset : Массив или последовательность векторов. Входные данные. positions : массив, по умолчанию = [1, 2, …, n] Устанавливает положение скрипичных диаграмм. Отметки и пределы автоматически настраиваются для соответствия позициям. vert : bool, по умолчанию = True. Если True, создает вертикальную скрипичную диаграмму. В противном случае, создает горизонтальную скрипичную диаграмму. widths : массив, по умолчанию = 0.5 Скаляр или вектор, устанавливающий максимальную ширину каждой скрипичной диаграммы. По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства. showmeans : bool, по умолчанию = False Если `True`, включает отображение средних значений. showextrema : bool, по умолчанию = True Если `True`, включает отображение экстремумов. showmedians : bool, по умолчанию = False Если `True`, включает отображение медиан. points : скаляр, по умолчанию = 100 Определяет количество точек для оценки каждой из функций плотности вероятности, основанной на ядре Гаусса. bw_method : str, скаляр или вызываемая функция, необязательно Метод вычисления ширины оценочного интервала. Может быть ‘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’.

dataset : Массив или последовательность векторов.

Входные данные.

positions : массив, по умолчанию = [1, 2, …, n]

Устанавливает положение скрипичных диаграмм. Отметки и пределы автоматически настраиваются для соответствия позициям.

vert : bool, по умолчанию = True.

Если True, создает вертикальную скрипичную диаграмму. В противном случае, создает горизонтальную скрипичную диаграмму.

widths : массив, по умолчанию = 0.5

Скаляр или вектор, устанавливающий максимальную ширину каждой скрипичной диаграммы. По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства.

showmeans : bool, по умолчанию = False

Если True, включает отображение средних значений.

showextrema : bool, по умолчанию = True

Если True, включает отображение экстремумов.

showmedians : bool, по умолчанию = False

Если True, включает отображение медиан.

points : скаляр, по умолчанию = 100

Определяет количество точек для оценки каждой из функций плотности вероятности, основанной на ядре Гаусса.

bw_method : str, скаляр или вызываемая функция, необязательно

Метод вычисления ширины оценочного интервала. Может быть ‘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’.