mpl_toolkits.axes_grid1.colorbar

Инструментарий для создания цветовых баров с двумя классами и функцией:

ColorbarBase

базовый класс с полным функционалом для отрисовки цветовой шкалы. Он может быть использован непосредственно для создания цветовой шкалы для заданной цветовой карты; объект mappable (например, изображение) не требуется.

Colorbar

производный класс для использования с изображениями или контурными диаграммами.

make_axes()

функция для изменения размера осей и добавления второй оси, подходящей для цветовой шкалы

Метод colorbar() использует make_axes() и Colorbar; функция colorbar() является тонким оболочкой над colorbar().

class mpl_toolkits.axes_grid1.colorbar.CbarAxesLocator(locator=None, extend='neither', orientation='vertical') [source]

CbarAxesLocator — это разместитель осей для осей цветовой шкалы. Он корректирует положение осей, чтобы обеспечить место для расширенных концов, т.е. расширенные концы располагаются за пределами области осей.

locator : the bbox returned from the locator is used as a

начальное расположение осей. Если None, используется axes.bbox.

extend : то же, что и в ColorbarBase orientation : то же, что и в ColorbarBase

get_end_vertices(self) [source]

возвращает кортеж из двух вершин для расширенных концов цветовой шкалы. Первая вершина — для минимального конца, вторая — для максимального.

get_original_position(self, axes, renderer) [source]

получить исходное положение осей.

get_path_ends(self) [source]

получить пути для расширенных концов

get_path_patch(self) [source]

получить путь для области осей

class mpl_toolkits.axes_grid1.colorbar.Colorbar(ax, mappable, **kw) [source]

add_lines(self, CS) [source]

Добавление линий из не заполненного ContourSet в цветовую шкалу.

update_bruteforce(self, mappable) [source]

Обновление элементов цветовой шкалы, чтобы отразить изменения связанного объекта mappable.

class mpl_toolkits.axes_grid1.colorbar.ColorbarBase(ax, cmap=None, norm=None, alpha=1.0, values=None, boundaries=None, orientation='vertical', extend='neither', spacing='uniform', ticks=None, format=None, drawedges=False, filled=True) [source]

Отрисовка цветовой шкалы на существующей оси.

Это базовый класс для класса Colorbar, который является основой для метода colorbar() и функции pyplot.

Он также полезен сам по себе для отображения цветовой карты. Если аргумент cmap задан, но boundaries и values оставлены как None, то цветовая карта будет отображаться в масштабе 0-1. Чтобы отобразить цвета для значений ниже и выше диапазона, укажите norm как:

colors.Normalize(clip=False)

Чтобы отобразить цвета по индексу вместо масштаба 0-1, используйте:

norm=colors.NoNorm.

Полезные атрибуты:

ax

экземпляр Axes, на котором отображается цветовая шкала

lines

LineCollection, если были нарисованы линии, иначе None

dividers

LineCollection, если drawedges равно True, иначе None

Полезные публичные методы — set_label() и add_lines().

add_lines(self, levels, colors, linewidths) [source]

Отрисовка линий на цветовой шкале. Удаляет существующие линии.

set_alpha(self, alpha) [source]

Устанавливает значение альфа.

set_label_text(self, label, **kw) [source]

Подписывает ось цветовой шкалы

update_artists(self) [source]

Обновление элементов цветовой шкалы, filled и ends. Обратите внимание, что lines не обновляются. Необходимо вызывать, когда меняется clim связанного изображения.

mpl_toolkits.axes_grid1.colorbar.colorbar(mappable, cax=None, ax=None, **kw) [source]

Создание полосы цвета для экземпляра ScalarMappable.

Документация для тонкого обертки pyplot:

Добавление полосы цвета к графику.

Подписи функций для интерфейса pyplot; все, кроме первой, также являются подписями методов для метода colorbar():

colorbar(**kwargs)
colorbar(mappable, **kwargs)
colorbar(mappable, cax=cax, **kwargs)
colorbar(mappable, ax=ax, **kwargs)

аргументы:

mappable

отображаемый объект, ContourSet и т.д., к которому применяется полоса цвета; этот аргумент обязателен для метода colorbar(), но необязателен для функции colorbar(), которая устанавливает значение по умолчанию для текущего изображения.

аргументы ключевых слов:

cax

None | объект осей, в который будет нарисована полоса цвета

ax

None | родительский объект осей, из которого будет взято пространство для новых осей полосы цвета

Дополнительные аргументы ключевых слов бывают двух видов:

свойства осей:

Свойство	Описание
orientation	вертикальное или горизонтальное
fraction	0.15; доля исходных осей, используемых для полосы цвета
pad	0.05 при вертикальном расположении, 0.15 при горизонтальном; доля исходных осей между полосой цвета и новыми осями изображения
shrink	1.0; доля, на которую уменьшается полоса цвета
aspect	20; отношение длинной стороны к короткой

свойства полосы цвета:

Свойство	Описание
extend	[ 'neither' | 'both' | 'min' | 'max' ] Если не 'neither', создаются острые концы для значений за пределами диапазона. Они устанавливаются для заданной цветовой карты с помощью методов colormap set_under и set_over.
spacing	[ 'uniform' | 'proportional' ] Равномерное расстояние дает каждому дискретному цвету одинаковое пространство; пропорциональное делает расстояние пропорциональным интервалу данных.
ticks	[ None | список меток | объект Locator ] Если None, метки определяются автоматически из входных данных.
format	[ None | строка формата | объект Formatter ] Если None, используется ScalarFormatter. Если задана строка формата, например, '%.3f', она используется. Вместо этого может быть предоставлен альтернативный объект Formatter.
drawedges	bool, рисовать ли линии на границах цветов.

Следующее, вероятно, будет полезно только в контексте индексированных цветов (то есть, когда mappable имеет norm=NoNorm()) или других необычных обстоятельствах.

Свойство	Описание
boundaries	None или последовательность
values	None или последовательность, которая должна быть на 1 меньше длины последовательности boundaries. Для каждого региона, ограниченного смежными записями в boundaries, будет использоваться цвет, сопоставленный с соответствующим значением в values.

Если mappable является ContourSet, его аргумент extend включается автоматически.

Обратите внимание, что аргумент shrink предоставляет простой способ предотвратить, например, чтобы вертикальная полоса цвета была выше осей отображаемого объекта, к которому прикреплена полоса цвета; но это ручной метод, требующий некоторой проб и ошибок. Если полоса цвета слишком большая (или горизонтальная полоса цвета слишком широкая), используйте меньшее значение shrink.

Для более точного управления вы можете вручную указать положение объектов осей, в которых отображаются mappable и полоса цвета. В этом случае не используйте ни один из аргументов ключевых слов свойств осей.

Известно, что некоторые просмотрщики векторной графики (svg и pdf) отображают белые пробелы между сегментами полосы цвета. Это связано с ошибками в просмотрщиках, а не в matplotlib. В качестве обходного решения полоса цвета может быть отображена с перекрывающимися сегментами:

cbar = colorbar()
cbar.solids.set_edgecolor("face")
draw()

Однако это имеет негативные последствия в других ситуациях. В частности, с полупрозрачными изображениями (alpha < 1) и расширениями полосы цвета и по умолчанию не включено (проблема #1188).

возвращает:

экземпляр Colorbar; см. также его базовый класс, ColorbarBase. Вызовите метод set_label() для подписи полосы цвета.

transData объекта cax корректируется таким образом, что пределы в наиболее длинной оси фактически соответствуют пределам в диапазоне полосы цвета. С другой стороны, самая короткая ось имеет пределы данных [1,2], значение которого нестандартно, чтобы предотвратить потерю значимости при использовании логарифмической шкалы.

mpl_toolkits.axes_grid1.colorbar.make_axes(parent, *, fraction=0.15, shrink=1.0, aspect=20, **kw) [source]

Изменение размера и перестановка родительских осей и возвращение дочерних осей, подходящих для полосы цвета

cax, kw = make_axes(parent, **kw)

Аргументы ключевых слов могут включать следующее (с значениями по умолчанию):

orientation

'vertical' или 'horizontal'

Свойство	Описание
orientation	вертикальное или горизонтальное
fraction	0.15; доля исходных осей, используемых для полосы цвета
pad	0.05 при вертикальном расположении, 0.15 при горизонтальном; доля исходных осей между полосой цвета и новыми осями изображения
shrink	1.0; доля, на которую уменьшается полоса цвета
aspect	20; отношение длинной стороны к короткой

Все, кроме первого, удаляются из входного набора kw.

Возвращает (cax, kw), дочерние оси и уменьшенный словарь kw.