Функция colorbar() в Matplotlib
Справочная документация Matplotlib
colorbar()Используется для добавления цветовой шкалы (colorbar) к графику, сопоставляя цвета с диапазоном значений.
Цветовая шкала — важный элемент, используемый вместе с цветовой картой, позволяющий читателям сопоставлять цвета обратно с исходными значениями данных.
Определение функции
matplotlib.pyplot.colorbar(mappable=None, cax=None, ax=None, **kwargs)
Figure.colorbar(mappable=None, cax=None, ax=None, use_gridspec=True,
**kwargs)
Описание параметра
| Параметр | Описание |
|---|---|
| mappable | Объект mappable для цвета, например возвращаемое значение imshow(), scatter(), contourf() (обязательный) |
| ax | Axes, к которому прикрепляется цветовая шкала (рекомендуется, автоматически подстраивает компоновку) |
| cax | Отдельный Axes для цветовой шкалы (используется для точной настройки) |
| shrink | Масштабное соотношение цветовой шкалы относительно Axes, по умолчанию 1.0, обычно 0.8 |
| aspect | Соотношение сторон цветовой шкалы, по умолчанию 20 |
| label | Текст подписи для цветовой шкалы |
| orientation | 'vertical' (по умолчанию) или 'horizontal' |
| ticks | Пользовательские позиции делений |
| extend | 'neither'/'both'/'min'/'max', указание цвета для значений вне диапазона |
| pad | Отступ между цветовой шкалой и Axes |
Использование
fig.colorbar(im, ax=ax)Это рекомендуемый подход, так как он автоматически настраивает компоновку подграфиков, чтобы освободить место для цветовой шкалы.
Примеры использования
Пример 1: imshow + вертикальная цветовая шкала
Пример
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')
# Добавить вертикальную цветовую шкалу
cbar = fig.colorbar(im, ax=ax, label='Значение', shrink=0.8)
ax.set_title('imshow с цветовой шкалой')
ax.set_xlabel('Столбец')
ax.set_ylabel('Строка')
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')
# Добавить вертикальную цветовую шкалу
cbar = fig.colorbar(im, ax=ax, label='Значение', shrink=0.8)
ax.set_title('imshow с цветовой шкалой')
ax.set_xlabel('Столбец')
ax.set_ylabel('Строка')
plt.show()
Пример 2: Горизонтальная цветовая шкала + пользовательские деления
Пример
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')
# Горизонтальная цветовая шкала (под осями)
cbar = fig.colorbar(im, ax=ax,
orientation='horizontal',
label='Амплитуда',
shrink=0.8,
pad=0.08,
ticks=[-0.8, -0.4, 0, 0.4, 0.8])
ax.set_title('Горизонтальная цветовая шкала')
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')
# Горизонтальная цветовая шкала (под осями)
cbar = fig.colorbar(im, ax=ax,
orientation='horizontal',
label='Амплитуда',
shrink=0.8,
pad=0.08,
ticks=[-0.8, -0.4, 0, 0.4, 0.8])
ax.set_title('Горизонтальная цветовая шкала')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
Пример 3: scatter + Colorbar
Пример
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 # Данные для сопоставления цветов
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)
# PathCollection, возвращённый scatter, также может быть передан в colorbar
cbar = fig.colorbar(sc, ax=ax, label='Оценка', shrink=0.8)
ax.set_title('Диаграмма рассеяния с цветовой шкалой')
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 # Данные для сопоставления цветов
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)
# PathCollection, возвращённый scatter, также может быть передан в colorbar
cbar = fig.colorbar(sc, ax=ax, label='Оценка', shrink=0.8)
ax.set_title('Диаграмма рассеяния с цветовой шкалой')
ax.set_xlabel('X')
ax.set_ylabel('Y')
plt.show()
ЧАВО
Цветовая шкала вызывает несогласованные размеры подграфиков?
Используйтеlayout='constrained'параметр для автоматической обработки этого.
Или вызвать для Figure,fig.colorbar(im, ax=axes)передав список всех затронутых Axes.
Как совместно использовать одну цветовую шкалу для нескольких подграфиков?
При связывании одной цветовой шкалы с несколькими подграфиками передайтеax=axes_list。
Другие расширения