Fonction contour() / contourf() de 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ètre | Type | Description |
|---|---|---|
| X, Y | Tableau 2D de type array-like ou tableau 1D | coordonnées x et y des points de la grille. Si des tableaux 1D sont passés, ils sont automatiquement étendus via meshgrid |
| Z | Tableau 2D de type array-like | Valeur de la fonction (hauteur) à chaque point de la grille, de même forme que X, Y |
| levels | int ou array-like | Niveaux de contour : un entier signifie générer automatiquement N niveaux, un tableau signifie des valeurs de niveau spécifiques |
| colors | couleur ou liste | Couleur du contour (pour contour) |
| cmap | str ou Colormap | Colormap (pour contourf), par ex., 'viridis', 'terrain' |
| alpha | float | Transparence 0-1 |
| linewidths | float ou list | Largeur de ligne (pour contour) |
| linestyles | str ou list | Style de ligne (pour contour), par ex., 'solid', 'dashed' |
| extend | str | Gestion des couleurs en dehors de la plage des niveaux : 'neither'/'both'/'min'/'max' |
| antialiased | bool | Indique 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 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 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 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.
Autres extensions