matplotlib.axes.Axes.violinplot
-
Axes.violinplot(dataset, positions=None, vert=True, widths=0.5, showmeans=False, showextrema=True, showmedians=False, points=100, bw_method=None, *, data=None)[source] -
Построение диаграммы "скрипка".
Построение диаграммы "скрипка" для каждого столбца набора данных dataset или каждого вектора в последовательности dataset. Каждая заполненная область отображает весь диапазон данных, с необязательными линиями, соответствующими среднему значению, медиане, минимуму и максимуму.
Параметры: -
dataset : Array or a sequence of vectors. -
Входные данные.
-
positions : array-like, default = [1, 2, ..., n] -
Устанавливает позиции скрипок. Отметки и пределы автоматически устанавливаются, чтобы соответствовать позициям.
-
vert : bool, default = True. -
Если True, создает вертикальную диаграмму "скрипка". В противном случае, создает горизонтальную диаграмму "скрипка".
-
widths : array-like, default = 0.5 -
Либо скалярное, либо векторное значение, определяющее максимальную ширину каждой скрипки. По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства.
-
showmeans : bool, default = False -
Если
True, будет включено отображение средних значений. -
showextrema : bool, default = True -
Если
True, будет включено отображение экстремумов. -
showmedians : bool, default = False -
Если
True, будет включено отображение медиан. -
points : scalar, default = 100 -
Определяет количество точек для оценки каждой из аппроксимаций плотности с использованием ядра Гаусса.
-
bw_method : str, scalar or callable, optional -
Метод, используемый для расчёта ширины полосы оценки. Может быть 'scott', 'silverman', скалярная константа или вызываемая функция. Если скаляр, он будет использоваться непосредственно как
kde.factor. Если вызываемая функция, она должна принимать экземплярGaussianKDEв качестве единственного параметра и возвращать скаляр. Если None (по умолчанию), используется 'scott'.
Возвращаемое значение: -
result : dict -
Словарь, сопоставляющий каждый компонент диаграммы "скрипка" со списком соответствующих созданных экземпляров коллекций. Словарь содержит следующие ключи:
-
bodies: Список экземпляровmatplotlib.collections.PolyCollection, содержащих заполненную область каждой скрипки. -
cmeans: Экземплярmatplotlib.collections.LineCollection, созданный для определения средних значений каждого распределения скрипки. -
cmins: Экземплярmatplotlib.collections.LineCollection, созданный для определения нижней границы каждого распределения скрипки. -
cmaxes: Экземплярmatplotlib.collections.LineCollection, созданный для определения верхней границы каждого распределения скрипки. -
cbars: Экземплярmatplotlib.collections.LineCollection, созданный для определения центров каждого распределения скрипки. -
cmedians: Экземплярmatplotlib.collections.LineCollection, созданный для определения медианных значений каждого распределения скрипки.
-
Примечания
Примечание
В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все аргументы с именем 'dataset'.
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/2.2.3/api/_as_gen/matplotlib.axes.Axes.violinplot.html