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. Если вызываемый объект, он должен принять экземпляр 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.pyplot.violinplot