Función Matplotlib colorbar()
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ámetro | Descripción |
|---|---|
| mappable | Objeto capaz de mapear colores, como el valor de retorno de imshow(), scatter(), contourf() (obligatorio) |
| ax | Axes al que está adjunta la barra de color (recomendado, ajusta automáticamente el diseño) |
| cax | Axes dedicados para la barra de color (para un control fino) |
| shrink | Escala de la barra de color relativa a los Axes, por defecto 1.0, comúnmente 0.8 |
| aspect | Relación de aspecto de la barra de color, por defecto 20 |
| label | Texto de la etiqueta de la barra de color |
| orientation | 'vertical' (por defecto) u 'horizontal' |
| ticks | Posición personalizada de las marcas |
| extend | 'neither' / 'both' / 'min' / 'max', indicadores de colores fuera de rango |
| pad | Espaciado entre la barra de color y los Axes |
Uso
fig.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()
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()
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()
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。
Otras extensiones