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()

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

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)

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

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

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

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

Примечание: этот метод предполагает, что входные данные корректны; он не проверяет аномалии, такие как x, являющийся замаскированным массивом rgba, или являющимся целым типом, отличным от uint8, или являющимся массивом rgba с плавающей точкой со значениями вне диапазона от 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 в формате словаря.