Fonction colorbar() de Matplotlib
Documentation de référence de Matplotlib
colorbar()Utilisé pour ajouter une barre de couleurs (échelle de couleurs) à un graphique, en associant les couleurs à une plage de valeurs.
La barre de couleurs est un élément essentiel utilisé avec la colormap, permettant aux lecteurs d'associer les couleurs aux valeurs de données d'origine.
Définition de fonction
matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kwargs)
Figure.colorbar(mappable=None, cax=None, ax=None, use_gridspec=True,
**kwargs)
Description du paramètre
| Paramètre | Description |
|---|---|
| mappable | Un objet mappable de couleur, tel que la valeur de retour de imshow(), scatter(), contourf() (requis) |
| ax | L'objet Axes auquel la barre de couleurs est attachée (recommandé, ajuste automatiquement la disposition) |
| cax | Un objet Axes dédié à la barre de couleurs (utilisé pour un contrôle précis) |
| shrink | Le rapport d'échelle de la barre de couleurs par rapport aux Axes, par défaut 1.0, couramment 0.8 |
| aspect | Le rapport d'aspect de la barre de couleurs, par défaut 20 |
| label | Texte d'étiquette pour la barre de couleurs |
| orientation | 'vertical' (par défaut) ou 'horizontal' |
| ticks | Positions personnalisées des graduations |
| extend | 'neither'/'both'/'min'/'max', indication de couleur pour les valeurs hors plage |
| pad | Espacement entre la barre de couleurs et les Axes |
Utilisation
fig.colorbar(im, ax=ax)Est l'approche recommandée, car elle ajuste automatiquement la disposition des sous-graphiques pour faire de la place à la barre de couleurs.
Exemples d'utilisation
Exemple 1 : imshow + barre de couleurs verticale
Exemple
import numpy as np
data = np.random.rand(10, 10)
fig, ax = plt.subplots(figsize=(6, 5), layout='constrained')
im = ax.imshow(data, cmap='viridis', aspect='auto')
# Ajouter une barre de couleurs verticale
cbar = fig.colorbar(im, ax=ax, label='Valeur', shrink=0.8)
ax.set_title('imshow avec barre de couleurs')
ax.set_xlabel('Colonne')
ax.set_ylabel('Ligne')
plt.show()
Exemple 2 : barre de couleurs horizontale + graduations personnalisées
Exemple
import numpy as np
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)
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
im = ax.contourf(X, Y, Z, levels=15, cmap='coolwarm')
# Barre de couleurs horizontale (sous les axes)
cbar = fig.colorbar(im, ax=ax,
orientation='horizontal',
label='Amplitude',
shrink=0.8,
pad=0.08,
ticks=[-0.8, -0.4, 0, 0.4, 0.8])
ax.set_title('Barre de couleur horizontale')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
Exemple 3 : scatter + barre de couleur
Exemple
import numpy as np
np.random.seed(42)
n = 100
x = np.random.rand(n) * 10
y = np.random.rand(n) * 10
values = np.random.rand(n) * 100 # Données pour le mappage des couleurs
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
sc = ax.scatter(x, y, c=values, cmap='YlOrRd',
s=100, edgecolors='white', linewidth=0.5)
# Le PathCollection renvoyé par scatter peut également être transmis à colorbar
cbar = fig.colorbar(sc, ax=ax, label='Score', shrink=0.8)
ax.set_title('Nuage de points avec barre de couleur')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
FAQ
Barre de couleur provoquant des tailles de sous-graphiques incohérentes ?
Utilisez lalayout='constrained'paramètre pour le gérer automatiquement.
Ou appeler sur la Figure,fig.colorbar(im, ax=axes)en passant une liste de tous les Axes concernés.
Comment partager une seule barre de couleur entre plusieurs sous-graphiques ?
Lorsque vous associez une barre de couleur à plusieurs sous-graphiques, passezax=axes_list。
Autres extensions