matplotlib.axes.Axes.violinplot

Axes.violinplot(dataset, positions=None, *, vert=None, orientation='vertical', widths=0.5, showmeans=False, showextrema=True, showmedians=False, quantiles=None, points=100, bw_method=None, side='both', data=None)[исходный код]

Создаёт скрипичную диаграмму.

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

Параметры:

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

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

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

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

vertлогическое значение, необязательно

Устарело с версии 3.10: Вместо этого используйте orientation.

Если этот параметр задан в течение периода устаревания, он переопределяет параметр orientation.

Если значение True, скрипки отображаются вертикально. Если значение False, скрипки отображаются горизонтально.

orientation{'vertical', 'horizontal'}, по умолчанию: 'vertical'

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

Добавлено в версии 3.10.

widthsчисло с плавающей точкой или массивоподобный объект, по умолчанию: 0.5

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

showmeansлогическое значение, по умолчанию: False

Отображать ли среднее значение в виде линии.

showextremaлогическое значение, по умолчанию: True

Отображать ли экстремальные значения в виде линии.

showmediansлогическое значение, по умолчанию: False

Отображать ли медиану в виде линии.

quantilesмассивоподобный объект, по умолчанию: None

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

pointsцелое число, по умолчанию: 100

Количество точек, в которых вычисляется оценка плотности с гауссовским ядром.

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

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

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

'both' отображает стандартные скрипки. 'low'/'high' отображает только сторону ниже/выше значения положения.

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

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

dataset

Возвращает:

dict

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

• 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)