matplotlib.pyplot.violinplot

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

Объекты, передаваемые как data, должны поддерживать доступ по элементам (data[<arg>]) и проверку на принадлежность (<arg> in data).