cm (colormap)

matplotlib.cm

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

См. Справочник по цветовым картам для списка встроенных цветовых карт. См. Цветовые карты в Matplotlib для подробного обсуждения цветовых карт.

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(checker) [source]

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

autoscale() [source]

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

autoscale_None() [source]

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

changed() [source]

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

check_update(checker) [source]

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

cmap = None

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

colorbar = None

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

get_array() [source]

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

get_clim() [source]

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

get_cmap() [source]

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

norm = None

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

set_array(A) [source]

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

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

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

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

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

set_cmap(cmap) [source]

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

ПРИНИМАЕТ: цветовую карту или зарегистрированное имя цветовой карты.

set_norm(norm) [source]

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

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

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

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

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

Существует один специальный случай для обработки изображений, которые уже представлены в RGB или RGBA формате, например, прочитанных из файла изображения. Если x — это массив NumPy с 3 измерениями, и последнее измерение равно 3 или 4, то он будет обработан как массив RGB или RGBA, и никакого сопоставления не будет произведено. Массив может быть целым числом 8 бит или с плавающей точкой со значениями в диапазоне 0-1; в противном случае будет возбуждено исключение ValueError. Если это массив с маской, маска будет проигнорирована. Если последнее измерение равно 3, параметр alpha (по умолчанию 1) будет использован для заполнения прозрачности. Если последнее измерение равно 4, параметр alpha игнорируется; он не заменяет существующее значение альфа-канала. ValueError будет возбуждён, если третье измерение отличается от 3 или 4.

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

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

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

Возвращает экземпляр цветовой карты, по умолчанию используя значения из rcParams, если 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 в формате словаря.