matplotlib.colorizer

Класс Colorizer, который обрабатывает конвейер преобразования данных в цвет с помощью нормализации и цветовой карты.

classmatplotlib.colorizer.Colorizer(cmap=None, norm=None)[исходный код]

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

Конвейер преобразования данных в цвет.

К этому конвейеру можно обратиться через Colorizer.to_rgba; он выполняется с помощью атрибутов Colorizer.norm и Colorizer.cmap.

Параметры:

cmap: colorbar.Colorbar or str or None, default: None

Цветовая карта, используемая для окрашивания данных.

norm: colors.Normalize or str or None, default: None

Нормализация, используемая для нормализации данных

autoscale(A)[исходный код]

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

autoscale_None(A)[исходный код]

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

changed()[исходный код]

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

propertyclip

propertycmap

get_clim()[исходный код]

Возвращает значения (min, max), соответствующие пределам цветовой карты.

propertynorm

set_clim(vmin=None, vmax=None)[исходный код]

Задаёт пределы norm для масштабирования изображения.

Параметры:

vmin, vmaxfloat

Пределы.

Пределы также можно передать кортежем (vmin, vmax) в качестве единственного позиционного аргумента.

to_rgba(x, alpha=None, bytes=False, norm=True)[исходный код]

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

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

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

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

Если norm равно False, входные данные не нормализуются и считаются принадлежащими диапазону (0-1).

propertyvmax

propertyvmin

classmatplotlib.colorizer.ColorizingArtist(colorizer, **kwargs)[исходный код]

Базовые классы: _ScalarMappable, Artist

Базовый класс для художников, преобразующих данные в цвет с помощью colorizer.Colorizer.

colorizer.Colorizer нормализует данные, прежде чем вернуть цвета RGBA из Colormap.

Параметры:

colorizercolorizer.Colorizer

propertycolorizer

draw(renderer)[исходный код]

Рисует художника (и его дочерние элементы) с помощью указанного средства визуализации.

Ничего не делает, если художник невидим (Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

Этот метод переопределяется в подклассах Artist.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, array=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[исходный код]

Задаёт несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив с плавающей точкой размером (m, n, 3) и значение dpi и возвращающая массив размером (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float или None
animated	bool
array	array-like или None
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	Colormap или str или None
figure	Figure или SubFigure
gid	str
in_layout	bool
label	object
mouseover	bool
norm	Normalize или str или None
path_effects	список элементов AbstractPathEffect
picker	None, bool, float или callable
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool или None
transform	Transform
url	str
visible	bool
zorder	float

classmatplotlib.colorizer._ColorizerInterface[исходный код]

Bases: object

Базовый класс, содержащий интерфейс к объектам Colorizer из ColorizingArtist или cm.ScalarMappable.

Примечание: этот класс содержит только функции, взаимодействующие с атрибутом .colorizer. Другие функции, общие для ColorizingArtist и cm.ScalarMappable, сюда не включены.

autoscale()[исходный код]

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

autoscale_None()[исходный код]

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

propertycmap

propertycolorbar

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

get_alpha()[исходный код]

get_clim()[исходный код]

Возвращает значения (min, max), сопоставленные с пределами цветовой карты.

get_cmap()[исходный код]

Возвращает экземпляр Colormap.

propertynorm

set_clim(vmin=None, vmax=None)[исходный код]

Задать пределы norm для масштабирования изображения.

Параметры:

vmin, vmaxfloat

Пределы.

Для скалярных данных пределы также можно передать в виде кортежа (vmin, vmax) одним позиционным аргументом.

set_cmap(cmap)[исходный код]

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

Параметры:

cmapColormap или str или None

set_norm(norm)[исходный код]

Задать экземпляр нормализации.

Параметры:

normNormalize или str или None

Примечания

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

to_rgba(x, alpha=None, bytes=False, norm=True)[исходный код]

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

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

Предусмотрен особый случай для обработки изображений, которые уже представлены в формате RGB или RGBA, например прочитаны из файла изображения. Если x — это ndarray с тремя измерениями, а последнее измерение равно 3 или 4, то массив будет трактоваться как RGB или RGBA, и преобразование выполняться не будет. Массив может иметь тип uint8 либо содержать числа с плавающей точкой в диапазоне 0–1; в противном случае будет вызвано исключение ValueError. Все значения NaN и замаскированные элементы получат альфа-значение 0. Если последнее измерение равно 3, для заполнения прозрачности будет использоваться именованный аргумент alpha (по умолчанию равный 1). Если последнее измерение равно 4, именованный аргумент alpha игнорируется и не заменяет уже имеющееся альфа-значение. Если третье измерение не равно 3 или 4, будет вызвано исключение ValueError.

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

Если norm равно False, входные данные не нормализуются и предполагается, что они находятся в диапазоне (0–1).

classmatplotlib.colorizer._ScalarMappable(norm=None, cmap=None, *, colorizer=None, **kwargs)[исходный код]

Bases: _ColorizerInterface

Класс-миксин для преобразования одного или нескольких наборов скалярных данных в RGBA.

ScalarMappable нормализует данные, прежде чем возвращать цвета RGBA из заданной Colormap.

Параметры:

normNormalize (или ее подкласс), или str, или None

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

cmapstr или Colormap

Цветовая карта, используемая для преобразования нормализованных значений данных в цвета RGBA.

changed()[исходный код]

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

get_array()[исходный код]

Возвращает массив значений, преобразуемых в цвета.

Базовый класс ScalarMappable не делает предположений о размерности и форме массива.

set_array(A)[исходный код]

Задать массив значений из объекта, подобного массиву, A.

Параметры:

Aобъект, подобный массиву, или None

Значения, преобразуемые в цвета.

Базовый класс ScalarMappable не делает предположений о размерности и форме массива значений A.