Fonction colorbar() de Matplotlib


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ètreDescription
mappableUn objet mappable de couleur, tel que la valeur de retour de imshow(), scatter(), contourf() (requis)
axL'objet Axes auquel la barre de couleurs est attachée (recommandé, ajuste automatiquement la disposition)
caxUn objet Axes dédié à la barre de couleurs (utilisé pour un contrôle précis)
shrinkLe rapport d'échelle de la barre de couleurs par rapport aux Axes, par défaut 1.0, couramment 0.8
aspectLe rapport d'aspect de la barre de couleurs, par défaut 20
labelTexte d'étiquette pour la barre de couleurs
orientation'vertical' (par défaut) ou 'horizontal'
ticksPositions personnalisées des graduations
extend'neither'/'both'/'min'/'max', indication de couleur pour les valeurs hors plage
padEspacement entre la barre de couleurs et les Axes

Utilisationfig.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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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。


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

Autres extensions