Función Matplotlib contour() / contourf()


Matplotlib 参考文档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ámetroTipoDescripción
X, Yarray-like 2D o array 1DCoordenadas x e y de los puntos de la cuadrícula. Si se pasan arrays 1D, se expanden automáticamente mediante meshgrid
Z2D array-likeValor de la función (altura) en cada punto de la cuadrícula, con la misma forma que X, Y.
levelsint o array-likeNiveles 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.
colorscolor o listaColor de las líneas de contorno (para contour)
cmapstr o ColormapMapa de colores (para contourf), como 'viridis', 'terrain'.
alphafloatTransparencia 0-1
linewidthsfloat o listaAncho de línea (para contour)
linestylesstr o listaEstilo de línea (para contour), como 'solid', 'dashed'.
extendstrManejo del color fuera del rango de levels: 'neither'/'both'/'min'/'max'
antialiasedboolSi 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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.


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

Otras extensiones