matplotlib.axes.Axes.bxp

Axes.bxp(self, 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_ticks=True, zorder=None) [source]

Функция построения ящично-усовных диаграмм.

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

Параметры:

Параметры:	`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 = True` Если `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_ticks : bool, default = True` Если True, расположение и метки отметок будут скорректированы для соответствия позициям ящично-усовных диаграмм. `zorder : scalar, default = None` z-порядок создаваемой ящично-усовной диаграммы.
Возвращает:	`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 = True

Если 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_ticks : bool, default = True

Если True, расположение и метки отметок будут скорректированы для соответствия позициям ящично-усовных диаграмм.

zorder : scalar, default = None

z-порядок создаваемой ящично-усовной диаграммы.

Возвращает:

result : dict

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

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

Примеры

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

(png, pdf)