matplotlib.cm

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

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

Базовый класс для поддержки отображения скалярных данных в RGBA. ScalarMappable использует нормализацию данных перед возвратом RGBA-цветов из заданной цветовой карты.

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

add_checker(self, checker) [source]

Добавление записи в словарь флагов boolean, которые устанавливаются в True, когда mappable изменяется.

autoscale(self) [source]

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

autoscale_None(self) [source]

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

changed(self) [source]

Вызов при изменении mappable для уведомления всех слушателей обратного вызова SM о событии 'changed'.

check_update(self, checker) [source]

Если mappable изменился с момента последней проверки, возвращает True; в противном случае возвращает False.

cmap

Объект Colormap для данного ScalarMappable.

colorbar

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

get_alpha(self) [source]

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

get_array(self) [source]

Возвращает массив.

get_clim(self) [source]

Возвращает минимальное и максимальное значения пределов цветовой шкалы для масштабирования изображения.

get_cmap(self) [source]

Возвращает цветовую карту.

norm

Объект нормализации для данного ScalarMappable.

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 registered colormap name

set_norm(self, norm) [source]

Устанавливает объект нормализации.

Параметры:	normNormalize

Примечания

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

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

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

В стандартном случае x — это одномерная или двумерная последовательность скаляров, и соответствующий массив numpy значений rgba будет возвращен на основе norm и цветовой карты, установленных для данного 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).

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.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, и полученная цветовая карта регистрируется.

matplotlib.cm.revcmap(data) [source]

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

Примечания

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