Функция boxplot() в Matplotlib


Matplotlib 参考文档Справочная документация Matplotlib

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, capwidths=None, **kwargs)

Описание параметра

ПараметрTypeОписание
xмассив или последовательность массивовВходные данные; одномерный массив рисует один ящик, последовательность двумерных массивов рисует несколько ящиков
notchboolСтроить ли ящичную диаграмму с выемками (выемки используются для доверительного интервала медианы), по умолчанию False
vertboolTrue=вертикально (по умолчанию), False=горизонтально
whisfloat или (float, float)Длина усов (кратная IQR), по умолчанию 1.5. Например, (5, 95) означает 5-й и 95-й процентили
symstr или NoneСтиль маркеров для выбросов; None означает, что выбросы не отображаются
widthsfloat или array-likeШирина каждого ящика
patch_artistboolЕсли True, ящики заполняются цветом заливки (можно настроить с помощью facecolor)
showmeansboolОтображать ли точки средних значений, по умолчанию False
showfliersboolОтображать ли выбросы, по умолчанию True
labelslistПодпись для каждого ящика
boxprops / flierprops / medianprops / meanpropsdictУправляют свойствами внешнего вида ящиков/выбросов/линий медианы/средних значений соответственно

Структура ящичной диаграммы: прямоугольник простирается от Q1 до Q3, а средняя линия — это медиана. Усы доходят до самых удалённых точек данных в диапазоне от Q1-1.5*IQR до Q3+1.5*IQR. Значения за пределами усов являются выбросами.


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

Пример 1: Базовая ящичная диаграмма

Пример

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)

# Три группы данных с разными распределениями
data = [
    np.random.normal(0, 1, 100),     # Стандартное нормальное распределение
    np.random.normal(2, 1.5, 100),   # среднее=2, стандартное отклонение=1.5
    np.random.normal(-1, 0.5, 100),  # среднее=-1, стандартное отклонение=0.5
]

fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')

bp = ax.boxplot(data, labels=['Group A', 'Group B', 'Group C'],
                patch_artist=True)

# Пользовательские цвета
colors = ['#3498db', '#e74c3c', '#2E7DCC']
for patch, color in zip(bp['boxes'], colors):
    patch.set_facecolor(color)

ax.set_title('Ящичная диаграмма: сравнение трех групп')
ax.set_ylabel('Значение')
ax.grid(axis='y', alpha=0.3)
plt.show()

Пример 2: ящичная диаграмма с выемкой + показ среднего

Пример

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)
data = [
    np.random.normal(0, 1, 100),
    np.random.normal(0, 1.2, 100),
    np.random.normal(0.3, 1, 100),
]

fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')

bp = ax.boxplot(data,
                notch=True,            # Выемка (доверительный интервал медианы)
                showmeans=True,        # Показать среднее
                meanprops=dict(marker='D', markerfacecolor='red',
                               markersize=8),
                patch_artist=True,
                labels=['Контроль', 'Тест A', 'Тест B'])

colors = ['#bdc3c7', '#3498db', '#2E7DCC']
for patch, color in zip(bp['boxes'], colors):
    patch.set_facecolor(color)

ax.set_title('Ящичная диаграмма с выемкой и средними значениями')
ax.set_ylabel('Измерение')
ax.grid(axis='y', alpha=0.3)
plt.show()

Пример 3: горизонтальная ящичная диаграмма

Пример

import matplotlib.pyplot as plt
import numpy as np

np.random.seed(42)
data = [np.random.exponential(scale=s, size=100) for s in [1, 2, 3, 4]]
labels = ['Масштаб=1', 'Масштаб=2', 'Масштаб=3', 'Масштаб=4']

fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')

bp = ax.boxplot(data, labels=labels,
                vert=False,                # Горизонтальное направление
                patch_artist=True)

colors = ['#e74c3c', '#f39c12', '#2E7DCC', '#3498db']
for patch, color in zip(bp['boxes'], colors):
    patch.set_facecolor(color)
    patch.set_alpha(0.7)

ax.set_title('Горизонтальная ящичная диаграмма')
ax.set_xlabel('Значение')
ax.grid(axis='x', alpha=0.3)
plt.show()

ЧАВО

Что означают части ящичной диаграммы?

Ящик: IQR (межквартильный размах) от Q1 (25%) до Q3 (75%).

Линия медианы: Линия в середине ящика = Q2 (50%).

Усы: простираются до наиболее удалённых точек данных в пределах Q1-1.5*IQR и Q3+1.5*IQR.

Выбросы: отдельные точки данных за пределами диапазона усов.


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения