Función fill_between() / fill_betweenx() de 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ámetro | Tipo | Descripción |
|---|---|---|
| x / y | array | Puntos de datos del primer eje de coordenadas |
| y1, y2 / x1, x2 | array o escalar | Dos curvas. Un escalar indica una línea constante. y2 por defecto es 0, rellena hasta el eje x |
| where | array of bool | Especifica qué intervalos deben rellenarse. True rellena, False no rellena |
| interpolate | bool | Si es True, solo se interpola para calcular el límite exacto en las intersecciones de las dos curvas |
| step | str | Relleno escalonado: 'pre', 'post', 'mid' |
| color / facecolor | color | Color de relleno |
| alpha | float | Transparencia |
| label | str | Etiqueta de leyenda |
| hatch | str | Patrón de relleno: '/', '\\', '|', '-', '+', 'x', '*' |
fill_between y fill_betweenx devuelven un
PolyCollectionobjeto, 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 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 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 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 < y2),
color='red', alpha=0.3,
label='sin < cos')
ax.set_title('Conditional Fill with where Parameter')
ax.set_xlabel('x')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 4: Relleno vertical con fill_betweenx
Ejemplo
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.
Otras extensiones