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, *, 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 Словарь, сопоставляющий каждый компонент диаграммы «скрин» со списком соответствующих экземпляров коллекций, созданных. Словарь имеет следующие ключи: 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.pyplot.violinplot