matplotlib.pyplot.violinplot

matplotlib.pyplot.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 для горизонтальных).

vertbool, необязательный параметр

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Строит диаграмму размаха с усами.

Примечания

Примечание

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

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

Сравнение диаграмм размаха и скрипичных диаграмм

Сравнение диаграмм размаха и скрипичных диаграмм

Настройка скрипичной диаграммы

Настройка скрипичной диаграммы

Основы скрипичных диаграмм

Основы скрипичных диаграмм