matplotlib.axes.Axes.violinplot

Axes.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Массив или последовательность векторов.

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

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' строит только нижнюю/верхнюю часть относительно значения positions.

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

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

dataset

Возвращает:

словарь

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

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

См. также

Axes.violin

Отображение «смоляной капли» на основе предварительно вычисленных статистик.

boxplot

Отображение диаграммы размаха.

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

Сравнение диаграммы размаха и диаграммы «смоляной капли»

Сравнение диаграммы размаха и диаграммы «смоляной капли»

Настройка диаграммы «смоляной капли»

Настройка диаграммы «смоляной капли»

Основы диаграммы «смоляной капли»

Основы диаграммы «смоляной капли»

violinplot(D)

violinplot(D)