Matplotlib-Funktion colorbar()
Matplotlib-Referenzdokumentation
colorbar()Wird verwendet, um einem Diagramm eine colorbar (Farbskala) hinzuzufügen, wobei Farben einem Wertebereich zugeordnet werden.
Die colorbar ist ein wesentliches Element, das zusammen mit der colormap verwendet wird und es Lesern ermöglicht, Farben zurück auf die ursprünglichen Datenwerte abzubilden.
Funktionsdefinition
matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kwargs)
Figure.colorbar(mappable=None, cax=None, ax=None, use_gridspec=True,
**kwargs)
Parameterbeschreibung
| Parameter | Beschreibung |
|---|---|
| mappable | Ein mappable-Farbobjekt, z. B. der Rückgabewert von imshow(), scatter(), contourf() (erforderlich) |
| ax | Die Axes, an die die colorbar angehängt wird (empfohlen, passt das Layout automatisch an) |
| cax | Eine dedizierte colorbar-Axes (zur Feinsteuerung verwendet) |
| shrink | Das Skalierungsverhältnis der Farbskala relativ zu den Axes, Standard 1.0, üblicherweise 0.8 |
| aspect | Das Seitenverhältnis der Farbskala, Standard 20 |
| label | Beschriftungstext für die Farbskala |
| orientation | 'vertical' (Standard) oder 'horizontal' |
| ticks | Benutzerdefinierte Tick-Positionen |
| extend | 'neither'/'both'/'min'/'max', Farbanzeige für Werte außerhalb des Bereichs |
| pad | Abstand zwischen der Farbskala und den Axes |
Nutzung
fig.colorbar(im, ax=ax)Ist der empfohlene Ansatz, da er das Subplot-Layout automatisch anpasst, um Platz für die Farbskala zu schaffen.
Anwendungsbeispiele
Beispiel 1: imshow + vertikale Farbskala
Beispiel
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')
# Vertikale Farbleiste hinzufügen
cbar = fig.colorbar(im, ax=ax, label='Wert', shrink=0.8)
ax.set_title('imshow mit Farbleiste')
ax.set_xlabel('Spalte')
ax.set_ylabel('Zeile')
plt.show()
Beispiel 2: Horizontale Farbleiste + benutzerdefinierte Ticks
Beispiel
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')
# Horizontale Farbleiste (unter den Achsen)
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('Horizontale Farbleiste')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
Beispiel 3: Streudiagramm + Farbleiste
Beispiel
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 # Daten für die Farbzuordnung
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)
# Die von scatter zurückgegebene PathCollection kann auch an colorbar übergeben werden
cbar = fig.colorbar(sc, ax=ax, label='Punktzahl', shrink=0.8)
ax.set_title('Scatter with Colorbar')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
FAQ
Colorbar verursacht inkonsistente Subplot-Größen?
Verwenden Sie dielayout='constrained'Parameter, um es automatisch zu handhaben.
Oder rufen Sie auf der Figure auf,fig.colorbar(im, ax=axes)indem Sie eine Liste aller betroffenen Axes übergeben.
Wie teilt man eine Colorbar unter mehreren Subplots?
Wenn Sie eine Colorbar mehreren Subplots zuordnen, übergeben Sieax=axes_list。
Andere Erweiterungen