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] для каждого скрина, представляющий квантили, которые будут отображены для этого скрина.
-
pointsscalar, default = 100 -
Определяет количество точек для оценки каждого из вычислений плотности гауссова ядра.
-
bw_methodstr, scalar or callable, optional -
Метод, используемый для расчёта ширины полосы оценки. Может быть 'scott', 'silverman', скалярной константой или вызываемой функцией. Если скаляр, он будет использован непосредственно как
kde.factor. Если вызываемая функция, она должна принимать экземплярGaussianKDEв качестве единственного параметра и возвращать скаляр. Если None (по умолчанию), используется 'scott'.
Возвращаемое значение: -
resultdict -
Словарь, сопоставляющий каждую составляющую диаграммы "скрин" списку соответствующих созданных экземпляров коллекций. Словарь имеет следующие ключи:
-
bodies: Список экземпляровPolyCollection, содержащих залитую область каждого скрина. -
cmeans: ЭкземплярLineCollection, отмечающий средние значения распределения каждого скрина. -
cmins: ЭкземплярLineCollection, отмечающий нижнюю границу распределения каждого скрина. -
cmaxes: ЭкземплярLineCollection, отмечающий верхнюю границу распределения каждого скрина. -
cbars: ЭкземплярLineCollection, отмечающий центры распределения каждого скрина. -
cmedians: ЭкземплярLineCollection, отмечающий медианные значения распределения каждого скрина. -
cquantiles: ЭкземплярLineCollection, созданный для идентификации квантильных значений распределения каждого скрина.
-
Примечания
Примечание
В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с именем 'dataset'.
Объекты, переданные как data, должны поддерживать доступ по элементам (
data[<arg>]) и проверку на принадлежность (<arg> in data). -
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.2.2/api/_as_gen/matplotlib.pyplot.violinplot.html