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. Заполненные области представляют весь диапазон данных, с опциональными линиями для среднего значения, медианы, минимума, максимума и заданных пользователем квантилей.

Параметры:

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_methodстрока, скаляр или вызываемый объект, необязательно

Метод, используемый для вычисления ширины полосы оценки. Может быть 'scott', 'silverman', скалярное значение или вызываемый объект. Если скалярное значение, оно будет использовано непосредственно как kde.factor. Если вызываемый объект, он должен принять экземпляр matplotlib.mlab.GaussianKDE в качестве единственного параметра и вернуть скаляр. Если None (по умолчанию), используется 'scott'.

dataиндексируемый объект, необязательно

Если задано, следующие параметры также могут принимать строковое значение s, которое интерпретируется как data[s] (если это не вызывает исключение):

dataset

Возвращаемое значение:

словарь

Словарь, сопоставляющий каждый компонент диаграммы размаха списку соответствующих экземпляров коллекций, которые были созданы. В словаре есть следующие ключи:

• bodies: Список экземпляров PolyCollection, содержащих заполненную область каждой диаграммы.
• cmeans: Экземпляр LineCollection, который отмечает средние значения распределения каждой диаграммы.
• cmins: Экземпляр LineCollection, который отмечает нижнюю границу распределения каждой диаграммы.
• cmaxes: Экземпляр LineCollection, который отмечает верхнюю границу распределения каждой диаграммы.
• cbars: Экземпляр LineCollection, который отмечает центры распределения каждой диаграммы.
• cmedians: Экземпляр LineCollection, который отмечает медианные значения распределения каждой диаграммы.
• cquantiles: Экземпляр LineCollection, созданный для определения значений квантилей распределения каждой диаграммы.