matplotlib.cm

Встроенные цветовые карты, утилиты обработки цветовых карт и миксин ScalarMappable.

class matplotlib.cm.ScalarMappable(norm=None, cmap=None) [source]

Базовый класс для отображения скалярных данных в RGBA.

Класс ScalarMappable применяет нормализацию данных перед возвратом цветов RGBA из заданной цветовой карты.

Параметры:	normmatplotlib.colors.Normalize (or subclass thereof) Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если None, по умолчанию norm устанавливается как объект colors.Normalize, который инициализирует масштабирование на основе первых обработанных данных. cmapstr or Colormap Цветовая карта, используемая для сопоставления нормализованных значений данных с цветами RGBA.

add_checker(self, checker) [source]

[Устаревший]

Примечания

Устарело начиная с версии 3.3:

autoscale(self) [source]

Автоматически масштабирует пределы скаляров в объекте norm с использованием текущего массива

autoscale_None(self) [source]

Автоматически масштабирует пределы скаляров в объекте norm с использованием текущего массива, изменяя только пределы, которые равны None

changed(self) [source]

Вызывается при изменении отображаемого объекта, чтобы уведомить все слушателей обратного вызова callbackSM о сигнале 'changed'.

check_update(self, checker) [source]

[Устаревший]

Примечания

Устарело начиная с версии 3.3:

colorbar

Последняя цветовая шкала, связанная с этим отображаемым объектом ScalarMappable. Может быть None.

get_alpha(self) [source]

Возвращает:	float Всегда возвращает 1.

get_array(self) [source]

Возвращает массив данных.

get_clim(self) [source]

Возвращает значения (мин, макс), которые сопоставляются с пределами цветовой карты.

get_cmap(self) [source]

Возвращает экземпляр Colormap.

set_array(self, A) [source]

Устанавливает массив изображения из массива NumPy A.

Параметры:	Andarray

set_clim(self, vmin=None, vmax=None) [source]

Устанавливает пределы нормализации для масштабирования изображения.

Параметры:	vmin, vmaxfloat Пределы. Пределы также можно передать как кортеж (vmin, vmax) в качестве единственного позиционного аргумента.

set_cmap(self, cmap) [source]

Устанавливает цветовую карту для данных яркости.

Параметры:	cmapColormap or str or None

set_norm(self, norm) [source]

Устанавливает экземпляр нормализации.

Параметры:	normNormalize or None

Примечания

Если какие-либо цветовые шкалы используют отображаемый объект для данной нормализации, установка нормализации отображаемого объекта сбросит нормализацию, локатор и форматеры цветовой шкалы до значений по умолчанию.

to_rgba(self, x, alpha=None, bytes=False, norm=True) [source]

Возвращает массив нормализованных rgba, соответствующих x.

В нормальном случае x представляет собой 1-мерный или 2-мерный последовательность скаляров, и соответствующий массив значений rgba будет возвращен на основе нормализации и цветовой карты, заданной для данного ScalarMappable.

Есть один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, прочитанных из файла изображения. Если x является массивом ndarray с 3 измерениями, и последнее измерение равно 3 или 4, то он будет обрабатываться как массив rgb или rgba, и никакое сопоставление не будет выполнено. Массив может быть uint8 или он может быть с плавающей точкой со значениями в диапазоне 0-1; в противном случае будет поднято исключение ValueError. Если это массив с маскировкой, маска будет проигнорирована. Если последнее измерение равно 3, аргумент alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, аргумент alpha игнорируется; он не заменяет уже существующий альфа-канал. Будет поднято исключение ValueError, если третье измерение отличается от 3 или 4.

В любом случае, если bytes равен False (по умолчанию), массив rgba будет числами с плавающей точкой в диапазоне 0-1; если он равен True, возвращаемый массив rgba будет uint8 в диапазоне от 0 до 255.

Если norm равен False, нормализация входных данных не выполняется, и предполагается, что они находятся в диапазоне (0-1).

property update_dict

matplotlib.cm.get_cmap(name=None, lut=None) [source]

Получить экземпляр цветовой карты, по умолчанию используя значения из rc, если name равно None.

Цветовые карты, добавленные с помощью register_cmap(), имеют приоритет над встроенными цветовыми картами.

Параметры:

namematplotlib.colors.Colormap or str or None, default: None Если экземпляр Colormap, он будет возвращен. В противном случае, имя цветовой карты, известной Matplotlib, которая будет пересчитана с помощью lut. По умолчанию, None, означает rcParams["image.cmap"] (значение по умолчанию: 'viridis'). lutint or None, default: None Если name еще не является экземпляром Colormap, а lut не равно None, цветовая карта будет пересчитана, чтобы иметь lut записей в таблице поиска.

Примечания

В настоящее время возвращается глобальный объект цветовой карты, который устарел. В Matplotlib 3.5 вы больше не сможете изменять глобальные цветовые карты на месте.

matplotlib.cm.register_cmap(name=None, cmap=None, data=None, lut=None) [source]

Добавить цветовую карту в набор, распознаваемый get_cmap().

Можно использовать двумя способами:

register_cmap(name='swirly', cmap=swirly_cmap)

register_cmap(name='choppy', data=choppydata, lut=128)

В первом случае, cmap должен быть экземпляром matplotlib.colors.Colormap. name необязателен; если отсутствует, имя будет name атрибутом cmap.

Второй случай устарел. Здесь три аргумента передаются в инициализатор LinearSegmentedColormap, и полученная цветовая карта регистрируется. Вместо неявного создания цветовой карты, создайте LinearSegmentedColormap и используйте первый случай: register_cmap(cmap=LinearSegmentedColormap(name, data, lut)).

Примечания

Регистрация цветовой карты сохраняет ссылку на объект цветовой карты, который в настоящее время может быть изменен и непреднамеренно изменить состояние глобальной цветовой карты. Это поведение устарело, и в Matplotlib 3.5 зарегистрированная цветовая карта будет неизменяемой.

matplotlib.cm.revcmap(data) [source]

[Устарело] Может обрабатывать только указание data в формате словаря.

Примечания

Устарело начиная с версии 3.2.