Fonction contour() / contourf() de Matplotlib


Matplotlib 参考文档Documentation de référence de Matplotlib

contour()Tracer des lignes de contour,contourf()Tracer des contours remplis.

Les deux servent à visualiser des champs scalaires 2D (tels que des cartes de terrain, des champs de température, des champs de pression, etc.).

Définition de fonction

Interface pyplot

matplotlib.pyplot.contour(*args, **kwargs)
matplotlib.pyplot.contourf(*args, **kwargs)

Interface Axes

Axes.contour(X, Y, Z, levels=None, **kwargs)
Axes.contourf(X, Y, Z, levels=None, **kwargs)

Description du paramètre

ParamètreTypeDescription
X, YTableau 2D de type array-like ou tableau 1Dcoordonnées x et y des points de la grille. Si des tableaux 1D sont passés, ils sont automatiquement étendus via meshgrid
ZTableau 2D de type array-likeValeur de la fonction (hauteur) à chaque point de la grille, de même forme que X, Y
levelsint ou array-likeNiveaux de contour : un entier signifie générer automatiquement N niveaux, un tableau signifie des valeurs de niveau spécifiques
colorscouleur ou listeCouleur du contour (pour contour)
cmapstr ou ColormapColormap (pour contourf), par ex., 'viridis', 'terrain'
alphafloatTransparence 0-1
linewidthsfloat ou listLargeur de ligne (pour contour)
linestylesstr ou listStyle de ligne (pour contour), par ex., 'solid', 'dashed'
extendstrGestion des couleurs en dehors de la plage des niveaux : 'neither'/'both'/'min'/'max'
antialiasedboolIndique s'il faut activer l'anticrénelage (pour contourf), par défaut True

Notes supplémentaires sur clabel()

clabel()Utilisé pour ajouter des étiquettes de valeurs sur les lignes de contour.

Axes.clabel(CS, levels=None, **kwargs)

Exemples d'utilisation

Exemple 1 : Comparaison entre contour de base et contour rempli

Exemple

import matplotlib.pyplot as plt
import numpy as np

# Créer une grille 2D et des valeurs de fonction
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)  # Fonction 2D

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5),
                                layout='constrained')

# Graphique gauche : lignes de contour (contour)
cs1 = ax1.contour(X, Y, Z, levels=10, cmap='viridis')
ax1.clabel(cs1, inline=True, fontsize=8)  # Ajouter des étiquettes
ax1.set_title('contour() - Contours linéaires')

# Graphique droit : contours remplis (contourf)
cs2 = ax2.contourf(X, Y, Z, levels=15, cmap='RdYlBu')
fig.colorbar(cs2, ax=ax2, label='Valeur')
# Superposer les lignes de contour
ax2.contour(X, Y, Z, levels=15, colors='black', linewidths=0.3)
ax2.set_title('contourf() - Contours remplis')

for ax in [ax1, ax2]:
    ax.set_xlabel('X')
    ax.set_ylabel('Y')

plt.show()

Exemple 2 : Niveaux personnalisés

Exemple

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)

# Collines gaussiennes
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')

# Niveaux personnalisés: 0.1 à 1.0, intervalle 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='Hauteur')

ax.contour(X, Y, Z, levels=custom_levels,
           colors='black', linewidths=0.5)

ax.set_title('Contour des niveaux personnalisés')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()

Exemple 3: Style de carte de terrain (palette de couleurs terrain)

Exemple

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)

# Simuler un terrain: deux pics + une vallée
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')

# Utiliser la palette de couleurs terrain pour simuler une carte de terrain
cs = ax.contourf(X, Y, Z, levels=20, cmap='terrain', extend='both')
fig.colorbar(cs, ax=ax, label='Élévation', shrink=0.8)

ax.contour(X, Y, Z, levels=20, colors='black', linewidths=0.3,
           alpha=0.4)

ax.set_title('Carte de contours de style terrain')
ax.set_xlabel('X (km)')
ax.set_ylabel('Y (km)')
plt.show()
print("exemple : contour de terrain affiché")

Questions fréquentes

Quand utiliser contour vs contourf ?

contour()contour : convient pour visualiser des lignes de délimitation nettes, telles que les isobares.

contourf()contourf : convient pour afficher des champs variant de façon continue, tels que la répartition de température.

Une pratique courante consiste à superposer les deux : contourf remplit les couleurs et contour superpose les lignes de délimitation.

X, Y doivent-ils être en 2D ?

Non. Si des tableaux 1D sont passés comme X et Y, matplotlib appellera automatiquementnp.meshgrid(X, Y)meshgrid pour générer une grille 2D. Z doit correspondre à la forme après meshgrid.


Matplotlib 参考文档Documentation de référence de Matplotlib

Autres extensions