cm (палитра)

matplotlib.cm

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

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

Базы: object

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

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

add_checker(checker)

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

autoscale()

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

autoscale_None()

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

changed()

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

check_update(checker)

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

cmap = None

Экземпляр Colormap для данного ScalarMappable.

colorbar = None

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

get_array()

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

get_clim()

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

get_cmap()

Возвращает палитру.

norm = None

Экземпляр Normalization для данного ScalarMappable.

set_array(A)

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

set_clim(vmin=None, vmax=None)

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

ПРИНИМАЕТ: последовательность длиной 2 из чисел с плавающей точкой.

set_cmap(cmap)

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

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

set_norm(norm)

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

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

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

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

matplotlib.cm.get_cmap(name=None, lut=None)

Получает экземпляр палитры, по умолчанию используя значения из 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)

Добавляет палитру к набору, распознаваемому 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)

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