Функция boxplot() в 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 | массив или последовательность массивов | Входные данные; одномерный массив рисует один ящик, последовательность двумерных массивов рисует несколько ящиков |
| notch | bool | Строить ли ящичную диаграмму с выемками (выемки используются для доверительного интервала медианы), по умолчанию False |
| vert | bool | True=вертикально (по умолчанию), False=горизонтально |
| whis | float или (float, float) | Длина усов (кратная IQR), по умолчанию 1.5. Например, (5, 95) означает 5-й и 95-й процентили |
| sym | str или None | Стиль маркеров для выбросов; None означает, что выбросы не отображаются |
| widths | float или array-like | Ширина каждого ящика |
| patch_artist | bool | Если True, ящики заполняются цветом заливки (можно настроить с помощью facecolor) |
| showmeans | bool | Отображать ли точки средних значений, по умолчанию False |
| showfliers | bool | Отображать ли выбросы, по умолчанию True |
| labels | list | Подпись для каждого ящика |
| boxprops / flierprops / medianprops / meanprops | dict | Управляют свойствами внешнего вида ящиков/выбросов/линий медианы/средних значений соответственно |
Структура ящичной диаграммы: прямоугольник простирается от Q1 до Q3, а средняя линия — это медиана. Усы доходят до самых удалённых точек данных в диапазоне от Q1-1.5*IQR до Q3+1.5*IQR. Значения за пределами усов являются выбросами.
Примеры использования
Пример 1: Базовая ящичная диаграмма
Пример
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 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 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.
Выбросы: отдельные точки данных за пределами диапазона усов.
Другие расширения