Функция fill_between() / fill_betweenx() в Matplotlib


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 / yarrayТочки данных первой координатной оси
y1, y2 / x1, x2массив или скалярДве кривые. Скаляр представляет постоянную линию. y2 по умолчанию равен 0, с заполнением до оси x.
гдемассив boolОпределяет, какие интервалы нужно залить. True заливает, False не заливает.
interpolateboolЕсли True, интерполировать, чтобы вычислить точные границы в точках пересечения кривых.
шагstrПошаговое заполнение: 'pre', 'post', 'mid'
color / facecolorcolorЦвет заливки
альфаfloatПрозрачность
labelstrМетка легенды
hatchstrШаблоны заливки: '/'、'\'、'|'、'-'、'+'、'x'、'*'

fill_between и fill_betweenx возвращаютPolyCollectionобъект, который можно использовать для последующего изменения или передать в colorbar.


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

Пример 1: Заливка до оси x (по умолчанию y2=0)

Пример

import matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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, подходит для отображения накопленной суммы по каждой части.


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

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