matplotlib.cm

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

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

Базовый класс: object

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

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

add_checker(self, checker) [source]

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

autoscale(self) [source]

Автоматически масштабирует пределы скаляров в экземпляре norm, используя текущий массив.

autoscale_None(self) [source]

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

changed(self) [source]

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

check_update(self, checker) [source]

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

cmap = None

Экземпляр Colormap этого ScalarMappable.

colorbar = None

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

get_alpha(self) [source]

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

get_array(self) [source]

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

get_clim(self) [source]

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

get_cmap(self) [source]

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

norm = None

Экземпляр Normalization этого ScalarMappable.

set_array(self, A) [source]

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

Параметры:	A : ndarray

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

Устанавливает пределы нормализации для масштабирования изображения; если vmin является последовательностью длиной 2, интерпретирует её как (vmin, vmax), что используется для поддержки setp.

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой; может быть переопределено в методах, имеющих vmin и vmax параметры.

set_cmap(self, cmap) [source]

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

Параметры:	cmap : colormap or registered colormap name

set_norm(self, norm) [source]

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

Параметры:	norm : Normalize

Примечания

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

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

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

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

Есть один специальный случай для обработки изображений, которые уже являются rgb или rgba, например, прочитанных из файла изображения. Если x — массив с 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(), имеют приоритет над встроенными цветовыми картами.

Если name — экземпляр matplotlib.colors.Colormap, он будет возвращен.

Если lut не равно None, оно должно быть целым числом, определяющим количество элементов, требуемых в таблице поиска, а name должно быть стандартным именем цветовой карты mpl.

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 в формате словаря.