matplotlib.pyplot.violinplot

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

Построение диаграммы размаха.

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

Parameters:

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

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

positionsпоследовательность, по умолчанию: [1, 2, ..., n]

Позиции диаграмм размаха; т.е. координаты на оси x для вертикальных диаграмм размаха (или ось y для горизонтальных диаграмм размаха).

vertbool, по умолчанию: True.

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

widthsfloat или последовательность, по умолчанию: 0.5

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

showmeansbool, по умолчанию: False

Показывать ли среднее значение линией.

showextremabool, по умолчанию: True

Показывать ли экстремумы линией.

showmediansbool, по умолчанию: False

Показывать ли медиану линией.

quantilesпоследовательность, по умолчанию: None

Если не None, задаёт список чисел в интервале [0, 1] для каждой диаграммы размаха, который соответствует квантилям, которые будут отображаться для этой диаграммы.

pointsint, по умолчанию: 100

Количество точек для вычисления каждой из оценок плотности вероятности гауссовского ядра.

bw_method{'scott', 'silverman'} или float или вызываемый объект, по умолчанию: 'scott'

Метод, используемый для расчёта ширины окна оценочного алгоритма. Если float, это значение будет использовано напрямую как kde.factor. Если вызываемый объект, он должен принимать экземпляр matplotlib.mlab.GaussianKDE в качестве единственного параметра и возвращать float.

side{'both', 'low', 'high'}, по умолчанию: 'both'

'both' строит стандартные диаграммы размаха. 'low'/'high' строит только нижнюю/верхнюю часть диаграммы размаха относительно значения позиции.

dataиндексируемый объект, необязательно

Если задано, следующие параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключения):

dataset

Returns:

dict

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

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

См. также

Axes.violin

Построение диаграммы размаха на основе предварительно вычисленных статистик.

boxplot

Построение ящиковой диаграммы.

Примечания

Примечание

Это обертка pyplot для axes.Axes.violinplot.

Примеры использования matplotlib.pyplot.violinplot

Сравнение диаграммы размаха и ящиковой диаграммы

Сравнение диаграммы размаха и ящиковой диаграммы

Настройка диаграммы размаха

Настройка диаграммы размаха

Основы диаграмм размаха

Основы диаграмм размаха