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]

Положения скрипичных графиков. Отметки и пределы автоматически устанавливаются, чтобы соответствовать этим позициям.

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'.

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

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

dataset

Возвращает

словарь

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

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