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, *, data=None)[source]
-
Создать диаграмму "смоляной свечи".
Создаёт диаграмму "смоляная свеча" для каждого столбца в наборе данных dataset или каждого вектора в последовательности dataset. Заполненная область отображает весь диапазон данных, с опциональными линиями в среднем, медиане, минимуме, максимуме и пользовательских квантилях.
- Параметры:
-
- datasetМассив или последовательность векторов.
-
Входные данные.
- positionsмассив-подобный, по умолчанию: [1, 2, ..., n]
-
Позиции "смоляных свечей". Отметки и пределы автоматически устанавливаются для соответствия позициям.
- vertbool, по умолчанию: True.
-
Если True, создаёт вертикальную диаграмму "смоляная свеча". В противном случае, создаёт горизонтальную диаграмму.
- widthsмассив-подобный, по умолчанию: 0.5
-
Либо скаляр, либо вектор, устанавливающий максимальную ширину каждой "смоляной свечи". По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства.
- showmeansbool, по умолчанию: False
-
Если
True, отображает средние значения. - showextremabool, по умолчанию: True
-
Если
True, отображает крайние значения. - showmediansbool, по умолчанию: False
-
Если
True, отображает медианы. - quantilesмассив-подобный, по умолчанию: None
-
Если не None, задаёт список чисел в интервале [0, 1] для каждой "смоляной свечи", представляющих квантили, которые будут отображены для этой "смоляной свечи".
- pointsint, по умолчанию: 100
-
Определяет количество точек, в которых будет вычисляться каждый из оценок плотности вероятности с помощью ядра Гаусса.
- bw_methodstr, скаляр или вызываемый объект, необязательно
-
Метод, используемый для вычисления ширины окна оценки. Может быть 'scott', 'silverman', скалярная константа или вызываемый объект. Если скаляр, он будет использоваться напрямую как
kde.factor. Если вызываемый объект, он должен принимать экземплярmatplotlib.mlab.GaussianKDEв качестве единственного параметра и возвращать скаляр. Если None (по умолчанию), используется 'scott'. - dataиндексируемый объект, необязательно
-
Если задан, следующие параметры также принимают строку
s, которая интерпретируется какdata[s](если это не вызывает исключение):dataset
- Возвращаемые значения:
-
- dict
-
Словарь, сопоставляющий каждый компонент violinplot со списком соответствующих экземпляров коллекции. Словарь имеет следующие ключи:
-
bodies: Список экземпляровPolyCollection, содержащих заполненную область каждой "смоляной свечи". -
cmeans: ЭкземплярLineCollection, отмечающий средние значения распределения каждой "смоляной свечи". -
cmins: ЭкземплярLineCollection, отмечающий нижнюю границу распределения каждой "смоляной свечи". -
cmaxes: ЭкземплярLineCollection, отмечающий верхнюю границу распределения каждой "смоляной свечи". -
cbars: ЭкземплярLineCollection, отмечающий центры распределения каждой "смоляной свечи". -
cmedians: ЭкземплярLineCollection, отмечающий медианы распределения каждой "смоляной свечи". -
cquantiles: ЭкземплярLineCollection, созданный для определения значений квантилей распределения каждой "смоляной свечи".
-
Примеры использования matplotlib.axes.Axes.violinplot
Сравнение диаграмм размаха и диаграмм «смоляной свечи»
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.axes.Axes.violinplot.html