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]
-
Позиции диаграмм размаха. Отметки и пределы автоматически устанавливаются в соответствии с позициями.
- vertбулево значение, по умолчанию: True.
-
Если True, создаёт вертикальную диаграмму размаха. В противном случае, создаёт горизонтальную.
- widthsмассив-подобный, по умолчанию: 0.5
-
Скаляр или вектор, определяющий максимальную ширину каждой диаграммы размаха. По умолчанию 0.5, что использует примерно половину доступного горизонтального пространства.
- showmeansбулево значение, по умолчанию: False
-
Если
True, отображает средние значения. - showextremaбулево значение, по умолчанию: True
-
Если
True, отображает экстремумы. - showmediansбулево значение, по умолчанию: False
-
Если
True, отображает медианы. - quantilesмассив-подобный, по умолчанию: None
-
Если не None, устанавливает список чисел с плавающей точкой в интервале [0, 1] для каждой диаграммы размаха, которые представляют квантили, которые будут отображаться для этой диаграммы.
- pointsцелое число, по умолчанию: 100
-
Определяет количество точек для вычисления каждой оценки плотности вероятности с использованием ядра Гаусса.
- bw_methodстрока, скаляр или вызываемый объект, необязательно
-
Метод, используемый для вычисления ширины полосы оценки. Может быть 'scott', 'silverman', скалярной константой или вызываемым объектом. Если скаляр, он будет использован напрямую как
kde.factor. Если вызываемый объект, он должен принимать экземплярGaussianKDEв качестве единственного параметра и возвращать скаляр. Если None (по умолчанию), используется 'scott'.
Возвращает: - словарь
-
Словарь, сопоставляющий каждый компонент диаграммы размаха с списком соответствующих созданных экземпляров коллекций. Словарь имеет следующие ключи:
-
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.axes.Axes.violinplot
© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.3/api/_as_gen/matplotlib.axes.Axes.violinplot.html