Функция fill_between() / fill_betweenx() в Matplotlib
Справочная документация Matplotlib
fill_between()Используется для заполнения области между двумя горизонтальными кривыми,fill_betweenx()Заполняет область между двумя вертикальными кривыми.
Часто используется для визуализации доверительных интервалов, диапазонов неопределённости, областей различий и т. д.
Определение функции
matplotlib.pyplot.fill_between(x, y1, y2=0, where=None,
interpolate=False, step=None, **kwargs)
matplotlib.pyplot.fill_betweenx(y, x1, x2=0, where=None,
interpolate=False, step=None, **kwargs)
Описание параметра
| Параметр | Type | Описание |
|---|---|---|
| x / y | array | Точки данных первой координатной оси |
| y1, y2 / x1, x2 | массив или скаляр | Две кривые. Скаляр представляет постоянную линию. y2 по умолчанию равен 0, с заполнением до оси x. |
| где | массив bool | Определяет, какие интервалы нужно залить. True заливает, False не заливает. |
| interpolate | bool | Если True, интерполировать, чтобы вычислить точные границы в точках пересечения кривых. |
| шаг | str | Пошаговое заполнение: 'pre', 'post', 'mid' |
| color / facecolor | color | Цвет заливки |
| альфа | float | Прозрачность |
| label | str | Метка легенды |
| hatch | str | Шаблоны заливки: '/'、'\'、'|'、'-'、'+'、'x'、'*' |
fill_between и fill_betweenx возвращают
PolyCollectionобъект, который можно использовать для последующего изменения или передать в colorbar.
Примеры использования
Пример 1: Заливка до оси x (по умолчанию y2=0)
Пример
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, ax = plt.subplots(layout='constrained')
# Построить основную кривую
ax.plot(x, y, 'b-', linewidth=2, label='sin(x)')
# Заполнить область между кривой и осью x
ax.fill_between(x, y, alpha=0.3, color='blue',
label='Площадь под кривой')
ax.set_title('fill_between: Площадь между кривой и осью X')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Пример 2: доверительный интервал (область между двумя кривыми)
Пример
import numpy as np
x = np.linspace(0, 10, 100)
y_mean = np.sin(x) + 5 # Средняя линия
y_std = 0.3 + 0.1 * x # Стандартное отклонение увеличивается с x
# Верхняя и нижняя границы
y_upper = y_mean + y_std
y_lower = y_mean - y_std
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
# Заполнить доверительный интервал с обеих сторон от среднего
ax.fill_between(x, y_lower, y_upper,
alpha=0.3, color='steelblue',
label='Доверительный интервал')
# Построить линию среднего
ax.plot(x, y_mean, 'steelblue', linewidth=2, label='Среднее')
# Построить верхнюю и нижнюю границы
ax.plot(x, y_upper, 'steelblue', linewidth=0.5, альфа=0.5)
ax.plot(x, y_lower, 'steelblue', linewidth=0.5, альфа=0.5)
ax.set_title('Доверительный интервал (fill_between)')
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Пример 3: Условная заливка с параметром where
Пример
import numpy as np
x = np.linspace(0, 10, 200)
y1 = np.sin(x)
y2 = np.cos(x)
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y1, 'blue', label='sin(x)')
ax.plot(x, y2, 'red', label='cos(x)')
# Заливать только там, где sin(x) >= cos(x)
ax.fill_between(x, y1, y2,
where=(y1 >= y2), # Условие: заливать, когда y1 выше y2
color='blue', alpha=0.3,
label='sin ≥ cos')
# Заливать только там, где sin(x) < cos(x) (другим цветом)
ax.fill_between(x, y1, y2,
where=(y1 < y2),
color='red', alpha=0.3,
label='sin < cos')
ax.set_title('Условная заливка с параметром where')
ax.set_xlabel('x')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Пример 4: вертикальная заливка fill_betweenx
Пример
import numpy as np
# Порядок аргументов для fill_betweenx — (y, x1, x2)
y = np.linspace(0, 10, 100)
x1 = 2 + np.sin(y)
x2 = 4 + np.cos(y) * 0.5
fig, ax = plt.subplots(figsize=(6, 6), layout='constrained')
ax.fill_betweenx(y, x1, x2, alpha=0.4, color='coral')
ax.plot(x1, y, 'red', linewidth=1.5, label='x1(y)')
ax.plot(x2, y, 'darkred', linewidth=1.5, label='x2(y)')
ax.set_title('fill_betweenx: Вертикальная заливка')
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.legend()
plt.show()
Часто задаваемые вопросы
Точки данных для параметра where недостаточно гладкие?
Когда залитая область неточна на границах True/False, установитеinterpolate=TrueПозволяет интерполировать для вычисления точных границ в точках пересечения.
В чём разница между fill_between и stackplot?
fill_between()Заполняет область между двумя заданными кривыми, подходит для отображения различий или доверительных интервалов.
stackplot()Укладывает несколько кривых слой за слоем от 0, подходит для отображения накопленной суммы по каждой части.
Другие расширения