Función fill_between() / fill_betweenx() de Matplotlib


Matplotlib 参考文档Documentación de referencia de Matplotlib

fill_between()Se utiliza para rellenar el área entre dos curvas horizontales,fill_betweenx()rellena el área entre dos curvas verticales.

Se usa comúnmente para visualizar intervalos de confianza, rangos de incertidumbre, áreas de diferencia, etc.

Definición de la función

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)

Descripción de parámetros

ParámetroTipoDescripción
x / yarrayPuntos de datos del primer eje de coordenadas
y1, y2 / x1, x2array o escalarDos curvas. Un escalar indica una línea constante. y2 por defecto es 0, rellena hasta el eje x
wherearray of boolEspecifica qué intervalos deben rellenarse. True rellena, False no rellena
interpolateboolSi es True, solo se interpola para calcular el límite exacto en las intersecciones de las dos curvas
stepstrRelleno escalonado: 'pre', 'post', 'mid'
color / facecolorcolorColor de relleno
alphafloatTransparencia
labelstrEtiqueta de leyenda
hatchstrPatrón de relleno: '/', '\\', '|', '-', '+', 'x', '*'

fill_between y fill_betweenx devuelven unPolyCollectionobjeto, que puede usarse para modificaciones posteriores o pasarse a colorbar.


Ejemplos de uso

Ejemplo 1: Relleno hasta el eje x (y2=0 por defecto)

Ejemplo

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')

# Dibujar la curva principal
ax.plot(x, y, 'b-', linewidth=2, label='sin(x)')
# Rellenar el área entre la curva y el eje x
ax.fill_between(x, y, alpha=0.3, color='blue',
                label='Area under curve')

ax.set_title('fill_between: Area Between Curve and X-axis')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 2: Intervalo de confianza (área entre dos curvas)

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

x = np.linspace(0, 10, 100)
y_mean = np.sin(x) + 5                     # Línea de media
y_std = 0.3 + 0.1 * x                      # La desviación estándar aumenta con x

# Límites superior e inferior
y_upper = y_mean + y_std
y_lower = y_mean - y_std

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

# Rellenar el intervalo de confianza a ambos lados de la media
ax.fill_between(x, y_lower, y_upper,
                alpha=0.3, color='steelblue',
                label='Confidence Interval')
# Dibujar la línea de media
ax.plot(x, y_mean, 'steelblue', linewidth=2, label='Mean')
# Dibujar los límites superior e inferior
ax.plot(x, y_upper, 'steelblue', linewidth=0.5, alpha=0.5)
ax.plot(x, y_lower, 'steelblue', linewidth=0.5, alpha=0.5)

ax.set_title('Confidence Interval (fill_between)')
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 3: Relleno condicional con el parámetro where

Ejemplo

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)')

# Rellenar solo en los intervalos donde sin(x) >= cos(x)
ax.fill_between(x, y1, y2,
                where=(y1 >= y2),         # Condición: rellenar cuando y1 está por encima de y2
                color='blue', alpha=0.3,
                label='sin ≥ cos')
# Rellenar solo en los intervalos donde sin(x) < cos(x) (con otro color)
ax.fill_between(x, y1, y2,
                where=(y1 &lt; y2),
                color=&#039;red&#039;, alpha=0.3,
                label=&#039;sin &lt; cos&#039;)

ax.set_title(&#039;Conditional Fill with where Parameter&#039;)
ax.set_xlabel(&#039;x&#039;)
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Ejemplo 4: Relleno vertical con fill_betweenx

Ejemplo

import matplotlib.pyplot as plt
import numpy as np

# El orden de los parámetros de fill_betweenx es (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: Vertical Fill')
ax.set_xlabel('x')
ax.set_ylabel('y')
ax.legend()
plt.show()

Preguntas frecuentes

¿Los puntos de datos del parámetro where no son lo suficientemente suaves?

Cuando el área de relleno no es precisa en los límites True/False, establezcainterpolate=Trueinterpolate=True para interpolar y calcular los límites exactos en los puntos de intersección.

¿Diferencia entre fill_between y stackplot?

fill_between()Rellena entre dos curvas específicas, adecuado para mostrar diferencias o intervalos de confianza.

stackplot()Apila varias curvas desde 0 en capas, adecuado para mostrar la cantidad total acumulada de cada parte.


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones