Función Matplotlib colorbar()


Matplotlib 参考文档Documentación de referencia de Matplotlib

colorbar()Se utiliza para añadir una barra de color (escala de color) en el gráfico, que mapea los colores a un rango de valores.

La barra de color es un elemento necesario que se utiliza junto con el colormap, para que el lector pueda mapear los colores de vuelta a los valores de datos originales.

Definición de la función

matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kwargs)
Figure.colorbar(mappable=None, cax=None, ax=None, use_gridspec=True,
    **kwargs)

Descripción de parámetros

ParámetroDescripción
mappableObjeto capaz de mapear colores, como el valor de retorno de imshow(), scatter(), contourf() (obligatorio)
axAxes al que está adjunta la barra de color (recomendado, ajusta automáticamente el diseño)
caxAxes dedicados para la barra de color (para un control fino)
shrinkEscala de la barra de color relativa a los Axes, por defecto 1.0, comúnmente 0.8
aspectRelación de aspecto de la barra de color, por defecto 20
labelTexto de la etiqueta de la barra de color
orientation'vertical' (por defecto) u 'horizontal'
ticksPosición personalizada de las marcas
extend'neither' / 'both' / 'min' / 'max', indicadores de colores fuera de rango
padEspaciado entre la barra de color y los Axes

Usofig.colorbar(im, ax=ax)Es la forma recomendada; ajusta automáticamente el diseño de los subgráficos para dejar espacio para la barra de color.


Ejemplos de uso

Ejemplo 1: imshow + barra de color vertical

Ejemplo

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

# Agregar barra de color vertical
cbar = fig.colorbar(im, ax=ax, label='Value', shrink=0.8)

ax.set_title('imshow with Colorbar')
ax.set_xlabel('Column')
ax.set_ylabel('Row')
plt.show()

Ejemplo 2: barra de color horizontal + marcas personalizadas

Ejemplo

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

# Barra de color horizontal (debajo de los 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('Horizontal Colorbar')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()

Ejemplo 3: scatter + barra de color

Ejemplo

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  # Datos del mapeo de colores

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)

# El PathCollection devuelto por scatter también se puede pasar a colorbar
cbar = fig.colorbar(sc, ax=ax, label='Score', shrink=0.8)

ax.set_title('Scatter with Colorbar')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()

Preguntas frecuentes

¿La barra de color causa que los tamaños de los subgráficos sean inconsistentes?

Usolayout='constrained'El parámetro lo maneja automáticamente.

O invocar en la Figurefig.colorbar(im, ax=axes)pasando la lista de todos los Axes afectados.

¿Cómo comparten varios subgráficos una sola barra de color?

Al asociar una barra de color a múltiples subgráficos, pasaax=axes_list。


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones