Función Matplotlib contour() / contourf()
Documentación de referencia de Matplotlib
contour()Dibuja líneas de contorno (líneas de nivel),contourf()Dibuja contornos rellenos.
Ambos se utilizan para visualizar campos escalares bidimensionales (como mapas topográficos, campos de temperatura, campos de presión, etc.).
Definición de la función
Interfaz pyplot
matplotlib.pyplot.contour(*args, **kwargs) matplotlib.pyplot.contourf(*args, **kwargs)
Interfaz Axes
Axes.contour(X, Y, Z, levels=None, **kwargs) Axes.contourf(X, Y, Z, levels=None, **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| X, Y | array-like 2D o array 1D | Coordenadas x e y de los puntos de la cuadrícula. Si se pasan arrays 1D, se expanden automáticamente mediante meshgrid |
| Z | 2D array-like | Valor de la función (altura) en cada punto de la cuadrícula, con la misma forma que X, Y. |
| levels | int o array-like | Niveles de las líneas de contorno: un entero indica que se generan automáticamente N líneas, un array indica los valores específicos de los niveles. |
| colors | color o lista | Color de las líneas de contorno (para contour) |
| cmap | str o Colormap | Mapa de colores (para contourf), como 'viridis', 'terrain'. |
| alpha | float | Transparencia 0-1 |
| linewidths | float o lista | Ancho de línea (para contour) |
| linestyles | str o lista | Estilo de línea (para contour), como 'solid', 'dashed'. |
| extend | str | Manejo del color fuera del rango de levels: 'neither'/'both'/'min'/'max' |
| antialiased | bool | Si se aplica antialiasing (contourf), por defecto True |
Notas adicionales sobre clabel()
clabel()Se utiliza para añadir etiquetas numéricas en las líneas de contorno.
Axes.clabel(CS, levels=None, **kwargs)
Ejemplos de uso
Ejemplo 1: Comparación de contorno básico + contorno relleno
Ejemplo
import numpy as np
# Crear la cuadrícula 2D y los valores de la función
x = np.linspace(-3, 3, 100)
y = np.linspace(-3, 3, 100)
X, Y = np.meshgrid(x, y)
Z = np.sin(X) * np.cos(Y) # Función bidimensional
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
layout='constrained')
# Figura izquierda: líneas de contorno (contour)
cs1 = ax1.contour(X, Y, Z, levels=10, cmap='viridis')
ax1.clabel(cs1, inline=True, fontsize=8) # Añadir etiquetas
ax1.set_title('contour() - Line Contours')
# Figura derecha: contorno relleno (contourf)
cs2 = ax2.contourf(X, Y, Z, levels=15, cmap='RdYlBu')
fig.colorbar(cs2, ax=ax2, label='Value')
# Superponer líneas de contorno
ax2.contour(X, Y, Z, levels=15, colors='black', linewidths=0.3)
ax2.set_title('contourf() - Filled Contours')
for ax in [ax1, ax2]:
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
Ejemplo 2: personalizar levels
Ejemplo
import numpy as np
x = np.linspace(-5, 5, 150)
y = np.linspace(-5, 5, 150)
X, Y = np.meshgrid(x, y)
# Colina gaussiana
Z = np.exp(-((X-1)**2 + Y**2) / 4) +
np.exp(-((X+1)**2 + Y**2) / 3)
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
# levels personalizados: de 0.1 a 1.0, con un espaciado de 0.1
custom_levels = np.arange(0.1, 1.1, 0.1)
cs = ax.contourf(X, Y, Z, levels=custom_levels,
cmap='YlOrRd', extend='both')
cbar = fig.colorbar(cs, ax=ax, label='Height')
ax.contour(X, Y, Z, levels=custom_levels,
colors='black', linewidths=0.5)
ax.set_title('Custom Levels Contour')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
Ejemplo 3: Estilo de mapa topográfico (colormap terrain)
Ejemplo
import numpy as np
x = np.linspace(-4, 4, 200)
y = np.linspace(-4, 4, 200)
X, Y = np.meshgrid(x, y)
# Simular terreno: dos picos + un valle
Z = 3 * np.exp(-((X+2)**2 + Y**2) / 3) +
2 * np.exp(-((X-1)**2 + (Y-1)**2) / 2) -
1 * np.exp(-((X+0.5)**2 + (Y-2)**2) / 1.5)
fig, ax = plt.subplots(figsize=(8, 6), layout='constrained')
# El colormap terrain simula un mapa topográfico
cs = ax.contourf(X, Y, Z, levels=20, cmap='terrain', extend='both')
fig.colorbar(cs, ax=ax, label='Elevation', shrink=0.8)
ax.contour(X, Y, Z, levels=20, colors='black', linewidths=0.3,
alpha=0.4)
ax.set_title('Terrain-style Contour Map')
ax.set_xlabel('X (km)')
ax.set_ylabel('Y (km)')
plt.show()
print("ejemplo: terrain contour displayed")
Preguntas frecuentes
¿Cuándo usar contour y contourf?
contour(): Adecuado para ver líneas de contorno claras, como isobaras.
contourf(): Adecuado para mostrar campos de variación continua, como la distribución de temperatura.
Una práctica común es superponer ambos: contourf rellena con color y contour superpone las líneas de contorno.
¿Deben ser X e Y 2D?
No. Si se pasan arrays 1D como X e Y, matplotlib llama automáticamente anp.meshgrid(X, Y)generar la cuadrícula 2D. Z debe tener la misma forma que el resultado de meshgrid.
Otras extensiones