Matplotlib-Funktion colorbar()


Matplotlib 参考文档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

ParameterBeschreibung
mappableEin mappable-Farbobjekt, z. B. der Rückgabewert von imshow(), scatter(), contourf() (erforderlich)
axDie Axes, an die die colorbar angehängt wird (empfohlen, passt das Layout automatisch an)
caxEine dedizierte colorbar-Axes (zur Feinsteuerung verwendet)
shrinkDas Skalierungsverhältnis der Farbskala relativ zu den Axes, Standard 1.0, üblicherweise 0.8
aspectDas Seitenverhältnis der Farbskala, Standard 20
labelBeschriftungstext für die Farbskala
orientation'vertical' (Standard) oder 'horizontal'
ticksBenutzerdefinierte Tick-Positionen
extend'neither'/'both'/'min'/'max', Farbanzeige für Werte außerhalb des Bereichs
padAbstand zwischen der Farbskala und den Axes

Nutzungfig.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 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')

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

# 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 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  # 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。


Matplotlib 参考文档Matplotlib-Referenzdokumentation

Andere Erweiterungen