matplotlib.axes.Axes.violinplot

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

Создаёт диаграмму «сморщенные скрипки».

Создаёт диаграмму «сморщенные скрипки» для каждого столбца в dataset или каждого вектора в последовательности dataset. Заштрихованные области представляют весь диапазон данных, с необязательными линиями, обозначающими среднее, медиану, минимум, максимум и пользовательские квантили.

Параметры:

datasetArray or a sequence of vectors. Входные данные. positionsarray-like, default: [1, 2, ..., n] Определяет положение «сморщенных скрипок». Отметки и пределы автоматически устанавливаются в соответствии с позициями. vertbool, default: True. Если True, создаёт вертикальную диаграмму «сморщенные скрипки». В противном случае, создаётся горизонтальная диаграмма. widthsarray-like, default: 0.5 Скаляр или вектор, задающий максимальную ширину каждой «сморщенной скрипки». По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства. showmeansbool, default: False Если True, отображает среднее значение. showextremabool, default: True Если True, отображает экстремумы. showmediansbool, default: False Если True, отображает медианы. quantilesarray-like, default: None Если не None, список чисел в интервале [0, 1] для каждой «сморщенной скрипки», представляющий квантили, которые будут отображаться для этой «скрипки». pointsint, default: 100 Количество точек для оценки каждого из распределений плотности с использованием гауссова ядра. bw_methodstr, scalar or callable, optional Метод, используемый для расчёта ширины полосы оценки. Может быть 'scott', 'silverman', скалярной константой или вызываемой функцией. Если скаляр, он будет непосредственно использован как kde.factor. Если вызываемая функция, она должна принять экземпляр GaussianKDE в качестве единственного параметра и вернуть скаляр. Если None (по умолчанию), используется 'scott'.

Возвращает:

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

Примечания

Примечание

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

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

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

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