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_ticks=True, autorange=False, zorder=None, *, data=None) [source]

Построение диаграммы размаха.

Построение диаграммы размаха для каждого столбца x или каждого вектора в последовательности x. Ящик охватывает значения данных от нижнего до верхнего квартиля, с линией на медиане. Усы охватывают область данных. Точки выбросов находятся за пределами усов.

Параметры:	xArray or a sequence of vectors. Входные данные. notchbool, optional (False) Если True, будет создана диаграмма размаха с выемками. В противном случае будет создана прямоугольная диаграмма размаха. Выемки представляют собой доверительный интервал (ДИ) медианы. См. запись параметра bootstrap для получения информации о том, как вычисляются положения выемок. Примечание В тех случаях, когда значения ДИ меньше нижнего квартиля или больше верхнего квартиля, выемки будут выходить за пределы ящика, придавая ему характерный «перевернутый» вид. Это ожидаемое поведение и согласуется с другими пакетами статистической визуализации. symstr, optional Символ по умолчанию для точек выбросов. Введите пустую строку ('') если вы не хотите отображать точки выбросов. Если None, то точки выбросов по умолчанию равны 'b+'. Если вам нужен больший контроль, используйте аргумент flierprops. vertbool, optional (True) Если True (по умолчанию), ящики будут вертикальными. Если False, все будет отображено горизонтально. whisfloat or (float, float) (default = 1.5) Положение усов. Если это число, нижний ус находится на наименьшем значении, превышающем Q1 - whis*(Q3-Q1), а верхний ус — на наибольшем значении, меньшем Q3 + whis*(Q3-Q1), где Q1 и Q3 — первый и третий квартили. Значение по умолчанию whis = 1.5 соответствует первоначальному определению диаграмм размаха по Туки. Если это пара чисел, они указывают на процентили, по которым нужно рисовать усы (например, (5, 95)). В частности, установка этого значения в (0, 100) приводит к усам, охватывающим весь диапазон данных. «Диапазон» — устаревшее синоним для (0, 100). В случае, когда Q1 == Q3, whis автоматически устанавливается в (0, 100) (охватывает весь диапазон данных), если autorange равно True. За пределами усов данные считаются выбросами и отображаются как отдельные точки. bootstrapint, optional Указывает, следует ли выполнить бутстрап для получения доверительных интервалов медианы для диаграмм размаха с выемками. Если bootstrap равно None, бутстрап не выполняется, и выемки вычисляются с использованием асимптотического приближения на основе Гаусса (см. McGill, R., Tukey, J.W., and Larsen, W.A., 1978, и Kendall и Stuart, 1967). В противном случае, bootstrap указывает количество раз, для бутстрепа медианы, чтобы определить её 95%-ные доверительные интервалы. Рекомендуются значения между 1000 и 10000. usermediansarray-like, optional Массив или последовательность, первая размерность (или длина) которого совместима с x. Это переопределяет медианы, вычисленные matplotlib для каждого элемента usermedians, который не равен None. Когда элемент usermedians равен None, медиана вычисляется matplotlib обычным способом. conf_intervalsarray-like, optional Массив или последовательность, первая размерность (или длина) которого совместима с x, и вторая размерность равна 2. Когда элемент conf_intervals не равен None, положения выемок, вычисленные matplotlib, переопределяются (при условии, что notch равно True). Когда элемент conf_intervals равен None, выемки вычисляются методом, указанным другими параметрами (например, bootstrap). positionsarray-like, optional Устанавливает положение ящиков. Отметки и пределы автоматически устанавливаются в соответствии с положением. По умолчанию range(1, N+1), где N — количество ящиков, которые нужно отобразить. widthsscalar or array-like Устанавливает ширину каждого ящика с помощью скаляра или последовательности. По умолчанию 0,5 или 0.15*(distance between extreme positions), если это значение меньше. patch_artistbool, optional (False) Если False генерирует ящики с помощью объекта Line2D. В противном случае, ящики отрисовываются с помощью объектов Patch. labelssequence, optional Метки для каждого набора данных. Длина должна быть совместима с размерностью x. manage_ticksbool, optional (True) Если True, расположение и метки меток будут скорректированы для соответствия положениям диаграммы размаха. autorangebool, optional (False) Если True и данные распределены таким образом, что 25-й и 75-й процентили равны, whis устанавливается в (0, 100), так что концы усов находятся на минимальном и максимальном значениях данных. meanlinebool, optional (False) Если True (и showmeans равно True), попытается отобразить среднее значение как линию, занимающую всю ширину ящика в соответствии с meanprops (см. ниже). Не рекомендуется, если shownotches также равно True. В противном случае средние значения будут показаны как точки. zorderscalar, optional (None) Устанавливает zorder диаграммы размаха.
Возвращает:	resultdict Словарь, сопоставляющий каждый компонент диаграммы размаха со списком созданных объектов Line2D. Этот словарь имеет следующие ключи (при вертикальных диаграммах размаха): boxes: основное тело диаграммы размаха, отображающее квартили и доверительные интервалы медианы, если они включены. medians: горизонтальные линии на медиане каждого ящика. whiskers: вертикальные линии, простирающиеся до самых крайних, не выходящих за пределы данных. caps: горизонтальные линии на концах усов. fliers: точки, представляющие данные, выходящие за пределы усов (точки выбросов). means: точки или линии, представляющие средние значения.
Другие параметры:	showcapsbool, optional (True) Показывать ли крышки на концах усов. showboxbool, optional (True) Показывать ли центральный ящик. showfliersbool, optional (True) Показывать ли выбросы за пределами крышек. showmeansbool, optional (False) Показывать ли средние арифметические значения. cappropsdict, optional (None) Задает стиль крышек. boxpropsdict, optional (None) Задает стиль ящика. whiskerpropsdict, optional (None) Задает стиль усов. flierpropsdict, optional (None) Задает стиль точек выбросов. medianpropsdict, optional (None) Задает стиль медианы. meanpropsdict, optional (None) Задает стиль среднего значения.

Примечания

Примечание

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

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

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

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

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