matplotlib.pyplot.boxplot

matplotlib.pyplot.boxplot(x, notch=None, sym=None, vert=None, whis=None, positions=None, widths=None, patch_artist=None, bootstrap=None, usermedians=None, conf_intervals=None, meanline=None, showmeans=None, showcaps=None, showbox=None, showfliers=None, boxprops=None, labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_xticks=True, autorange=False, zorder=None, *, data=None) [source]

Создать диаграмму размаха.

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

Параметры:	x : Array or a sequence of vectors. Входные данные. notch : bool, optional (False) Если True, создаст диаграмму размаха с выемкой. В противном случае создаст прямоугольную диаграмму размаха. Выемки представляют собой доверительные интервалы (ДИ) вокруг медианы. Обратитесь к записи параметра bootstrap для получения информации о том, как вычисляются положения выемок. Примечание В случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут простираться за пределы ящика, придавая ему характерный "перевёрнутый" вид. Это ожидаемое поведение и согласуется с другими пакетами статистической визуализации. sym : str, optional Символ по умолчанию для точек-флайеров. Введите пустую строку ('') если не хотите отображать флайеры. Если None, то флайеры по умолчанию — 'b+'. Если вам нужен больший контроль, используйте аргумент flierprops. vert : bool, optional (True) Если True (по умолчанию), делает ящики вертикальными. Если False, все рисуется горизонтально. whis : float, sequence, or string (default = 1.5) В виде числа, определяет протяжённость вибриссов за пределами первого и третьего квартилей. Иными словами, где IQR — межквартильный размах (Q3-Q1), верхняя вибрисса будет простираться до последнего значения, меньшего чем Q3 + whis*IQR). Аналогично, нижняя вибрисса будет простираться до первого значения, большего чем Q1 - whis*IQR.. За пределами вибриссов данные считаются выбросами и отображаются отдельными точками. Установите это значение в неразумно большое, чтобы принудительно показать вибриссы от минимального до максимального значения. В качестве альтернативы, установите это в возрастающую последовательность процентилей (например, [5, 95]), чтобы установить вибриссы в определённых процентилях данных. Наконец, whis может быть строкой 'range' чтобы принудительно установить вибриссы к минимуму и максимуму данных. bootstrap : int, optional Указывает, нужно ли выполнить бутстрапинг доверительных интервалов вокруг медианы для диаграмм размаха с выемками. Если bootstrap равно None, бутстрапинг не выполняется, и выемки вычисляются с помощью асимптотического приближения на основе распределения Гаусса (см. McGill, R., Tukey, J.W., and Larsen, W.A., 1978, и Kendall и Stuart, 1967). В противном случае, bootstrap указывает число раз для бутстрапинга медианы для определения её 95%-ных доверительных интервалов. Рекомендуются значения от 1000 до 10000. usermedians : array-like, optional Массив или последовательность, первая размерность (или длина) которой совместима с x. Это переопределяет медианы, вычисленные matplotlib для каждого элемента usermedians, который не None. Когда элемент usermedians равен None, медиана вычисляется matplotlib как обычно. conf_intervals : array-like, optional Массив или последовательность, первая размерность (или длина) которой совместима с x, и вторая размерность которой равна 2. Когда элемент conf_intervals не равен None, позиции выемок, вычисленные matplotlib, переопределяются (при условии, что notch равен True). Когда элемент conf_intervals равен None, выемки вычисляются по методу, указанному другими параметрами (например, bootstrap). positions : array-like, optional Задаёт позиции ящиков. Отметки и пределы автоматически устанавливаются для соответствия позициям. По умолчанию range(1, N+1), где N — количество ящиков, которые должны быть нарисованы. widths : scalar or array-like Задаёт ширину каждого ящика либо скаляром, либо последовательностью. По умолчанию 0.5, или 0.15*(distance between extreme positions), если это значение меньше. patch_artist : bool, optional (False) Если False, создаёт ящики с помощью объекта Line2D. В противном случае ящики рисуются с помощью объектов Patch. labels : sequence, optional Метки для каждого набора данных. Длина должна быть совместима с размерностью x. manage_xticks : bool, optional (True) Если функция должна корректировать xlim и xtick. autorange : bool, optional (False) Когда True и данные распределены таким образом, что 25-й и 75-й процентили равны, whis устанавливается в 'range', так что концы вибрисс находятся в минимуме и максимуме данных. meanline : bool, optional (False) Если True (и showmeans равно True), попытается отобразить среднее значение как линию, занимающую всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае средние значения будут показаны как точки. zorder : scalar, optional (None) Устанавливает zorder диаграммы размаха.
Возвращает:	result : dict Словарь, сопоставляющий каждый компонент диаграммы размаха со списком созданных объектов matplotlib.lines.Line2D. Указанный словарь имеет следующие ключи (предполагая вертикальные диаграммы размаха): boxes: основной корпус диаграммы размаха, показывающий квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии в медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до самых крайних точек данных, не являющихся выбросами. caps: горизонтальные линии в концах вибрисс. fliers: точки, представляющие данные, выходящие за пределы вибрисс (флайеры). means: точки или линии, представляющие средние значения.
Другие параметры:	showcaps : bool, optional (True) Показать крышки на концах вибрисс. showbox : bool, optional (True) Показать центральный ящик. showfliers : bool, optional (True) Показать выбросы за пределами крышек. showmeans : bool, optional (False) Показать средние арифметические значения. capprops : dict, optional (None) Устанавливает стиль крышек. boxprops : dict, optional (None) Устанавливает стиль ящика. whiskerprops : dict, optional (None) Устанавливает стиль вибрисс. flierprops : dict, optional (None) Устанавливает стиль флайеров. medianprops : dict, optional (None) Устанавливает стиль медианы. meanprops : dict, optional (None) Устанавливает стиль среднего значения.

Примечания

Примечание

Помимо вышеописанных аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

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

Примеры использования matplotlib.pyplot.boxplot

Пример диаграммы размаха