matplotlib.axes.Axes.bxp

Axes.bxp(bxpstats, positions=None, widths=None, vert=True, patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_xticks=True, zorder=None) [source]

Функция построения диаграмм размаха.

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

Параметры:

Параметры:	`bxpstats : list of dicts` Список словарей, содержащих статистические данные для каждой диаграммы размаха. Необходимые ключи: `med`: Медиана (скалярное значение с плавающей точкой). `q1`: Первый квартиль (25-й процентиль) (скалярное значение с плавающей точкой). `q3`: Третий квартиль (75-й процентиль) (скалярное значение с плавающей точкой). `whislo`: Нижняя граница нижней висячей части (скалярное значение с плавающей точкой). `whishi`: Верхняя граница верхней висячей части (скалярное значение с плавающей точкой). Дополнительные ключи: `mean`: Среднее значение (скалярное значение с плавающей точкой). Требуется, если `showmeans=True`. `fliers`: Значения, превышающие пределы висячих частей (последовательность чисел с плавающей точкой). Требуется, если `showfliers=True`. `cilo` & `cihi`: Нижние и верхние доверительные интервалы относительно медианы. Требуются, если `shownotches=True`. `label`: Название набора данных (строка). Если доступно, это значение будет использовано в качестве метки на оси диаграммы размаха. `positions : array-like, default = [1, 2, ..., n]` Определяет положение ящиков. Отметки и пределы автоматически устанавливаются в соответствии с позициями. `widths : array-like, default = None` Скаляр или вектор, определяющий ширину каждого ящика. По умолчанию `0.15(distance between extreme positions)`, ограничена значениями не менее 0,15 и не более 0,5. `vert : bool, default = False` Если `True` (по умолчанию), ящики будут вертикальными. Если `False`, ящики будут горизонтальными. `patch_artist : bool, default = False` Если `False` создаёт ящики с помощью элемента `Line2D`. Если `True` создаёт ящики с помощью элемента `Patch`. `shownotches : bool, default = False` Если `False` (по умолчанию), создаёт прямоугольные ящики. Если `True`, создаёт ящики с выемкой. `showmeans : bool, default = False` Если `True`, отображает средние значения. `showcaps : bool, default = True` Если `True`, отображает отметки. `showbox : bool, default = True` Если `True`, отображает ящики. `showfliers : bool, default = True` Если `True`, отображает точки вне ящика. `boxprops : dict or None (default)` Если указано, задаёт стиль отображения ящиков. `whiskerprops : dict or None (default)` Если указано, задаёт стиль отображения висячих частей. `capprops : dict or None (default)` Если указано, задаёт стиль отображения отметок. `flierprops : dict or None (default)` Если указано, задаёт стиль отображения точек вне ящика. `medianprops : dict or None (default)` Если указано, задаёт стиль отображения медиан. `meanprops : dict or None (default)` Если указано, задаёт стиль отображения средних значений. `meanline : bool, default = False` Если `True` (и showmeans* — `True`), попытается отобразить среднее значение в виде линии, охватывающей всю ширину ящика согласно meanprops. Не рекомендуется, если shownotches тоже True. В противном случае средние значения будут отображены как точки. `manage_xticks : bool, default = True` Если функция должна изменять xlim и xtick. `zorder : scalar, default = None` zorder созданных диаграмм размаха
Возвращает:	`result : dict` Словарь, сопоставляющий каждый компонент диаграммы размаха с списком созданных элементов `matplotlib.lines.Line2D`. Этот словарь имеет следующие ключи (при вертикальных диаграммах размаха): `boxes`: основная часть диаграммы размаха, отображающая квартили и доверительные интервалы медианы, если они включены. `medians`: горизонтальные линии в медиане каждого ящика. `whiskers`: вертикальные линии, простирающиеся до самых крайних, не являющихся выбросами, точек данных. `caps`: горизонтальные линии на концах висячих частей. `fliers`: точки, представляющие данные, выходящие за пределы висячих частей (выбросы). `means`: точки или линии, представляющие средние значения.

bxpstats : list of dicts

Список словарей, содержащих статистические данные для каждой диаграммы размаха. Необходимые ключи:

med: Медиана (скалярное значение с плавающей точкой).
q1: Первый квартиль (25-й процентиль) (скалярное значение с плавающей точкой).
q3: Третий квартиль (75-й процентиль) (скалярное значение с плавающей точкой).
whislo: Нижняя граница нижней висячей части (скалярное значение с плавающей точкой).
whishi: Верхняя граница верхней висячей части (скалярное значение с плавающей точкой).

Дополнительные ключи:

mean: Среднее значение (скалярное значение с плавающей точкой). Требуется, если showmeans=True.
fliers: Значения, превышающие пределы висячих частей (последовательность чисел с плавающей точкой). Требуется, если showfliers=True.
cilo & cihi: Нижние и верхние доверительные интервалы относительно медианы. Требуются, если shownotches=True.
label: Название набора данных (строка). Если доступно, это значение будет использовано в качестве метки на оси диаграммы размаха.

positions : array-like, default = [1, 2, ..., n]

Определяет положение ящиков. Отметки и пределы автоматически устанавливаются в соответствии с позициями.

widths : array-like, default = None

Скаляр или вектор, определяющий ширину каждого ящика. По умолчанию 0.15*(distance between extreme positions), ограничена значениями не менее 0,15 и не более 0,5.

vert : bool, default = False

Если True (по умолчанию), ящики будут вертикальными. Если False, ящики будут горизонтальными.

patch_artist : bool, default = False

Если False создаёт ящики с помощью элемента Line2D. Если True создаёт ящики с помощью элемента Patch.

shownotches : bool, default = False

Если False (по умолчанию), создаёт прямоугольные ящики. Если True, создаёт ящики с выемкой.

showmeans : bool, default = False

Если True, отображает средние значения.

showcaps : bool, default = True

Если True, отображает отметки.

showbox : bool, default = True

Если True, отображает ящики.

showfliers : bool, default = True

Если True, отображает точки вне ящика.

boxprops : dict or None (default)

Если указано, задаёт стиль отображения ящиков.

whiskerprops : dict or None (default)

Если указано, задаёт стиль отображения висячих частей.

capprops : dict or None (default)

Если указано, задаёт стиль отображения отметок.

flierprops : dict or None (default)

Если указано, задаёт стиль отображения точек вне ящика.

medianprops : dict or None (default)

Если указано, задаёт стиль отображения медиан.

meanprops : dict or None (default)

Если указано, задаёт стиль отображения средних значений.

meanline : bool, default = False

Если True (и showmeans — True), попытается отобразить среднее значение в виде линии, охватывающей всю ширину ящика согласно meanprops. Не рекомендуется, если shownotches тоже True. В противном случае средние значения будут отображены как точки.

manage_xticks : bool, default = True

Если функция должна изменять xlim и xtick.

zorder : scalar, default = None

zorder созданных диаграмм размаха

Возвращает:

result : dict

Словарь, сопоставляющий каждый компонент диаграммы размаха с списком созданных элементов matplotlib.lines.Line2D. Этот словарь имеет следующие ключи (при вертикальных диаграммах размаха):

boxes: основная часть диаграммы размаха, отображающая квартили и доверительные интервалы медианы, если они включены.
medians: горизонтальные линии в медиане каждого ящика.
whiskers: вертикальные линии, простирающиеся до самых крайних, не являющихся выбросами, точек данных.
caps: горизонтальные линии на концах висячих частей.
fliers: точки, представляющие данные, выходящие за пределы висячих частей (выбросы).
means: точки или линии, представляющие средние значения.

Примеры

(Исходный код, png, pdf)

(png, pdf)