Функция colorbar() в Matplotlib


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() (обязательный)
axAxes, к которому прикрепляется цветовая шкала (рекомендуется, автоматически подстраивает компоновку)
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()

Пример 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()

Пример 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()

ЧАВО

Цветовая шкала вызывает несогласованные размеры подграфиков?

Используйтеlayout='constrained'параметр для автоматической обработки этого.

Или вызвать для Figure,fig.colorbar(im, ax=axes)передав список всех затронутых Axes.

Как совместно использовать одну цветовую шкалу для нескольких подграфиков?

При связывании одной цветовой шкалы с несколькими подграфиками передайтеax=axes_list。


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения