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, hold=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., и 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>]:

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