matplotlib.pyplot.figimage

matplotlib.pyplot.figimage(X, xo=0, yo=0, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, origin=None, resize=False, *, colorizer=None, **kwargs)[исходный код]

Добавляет к рисунку изображение без повторной выборки.

Изображение прикрепляется к нижнему или верхнему левому углу в зависимости от origin.

Параметры:

X

Данные изображения. Это массив одной из следующих форм:

• (M, N): изображение со скалярными данными. Преобразование цветов задаётся параметрами cmap, norm, vmin и vmax.
• (M, N, 3): изображение со значениями RGB (float от 0 до 1 или int от 0 до 255).
• (M, N, 4): изображение со значениями RGBA (float от 0 до 1 или int от 0 до 255), то есть с прозрачностью.

xo, yoint

Смещение изображения по осям x/y в пикселях.

alphaNone или float

Значение альфа-смешивания.

cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (значение по умолчанию: 'viridis')

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

Этот параметр игнорируется, если X содержит данные RGB(A).

normstr или Normalize, необязательный

Метод нормализации, используемый для масштабирования скалярных данных в диапазон [0, 1] перед преобразованием в цвета с помощью cmap. По умолчанию используется линейное масштабирование, при котором наименьшее значение преобразуется в 0, а наибольшее — в 1.

Если задано, это может быть одно из следующего:

• Экземпляр Normalize или один из его подклассов (см. Нормализация цветовой карты).
• Имя шкалы, то есть одно из "linear", "log", "symlog", "logit" и т. д. Чтобы получить список доступных шкал, вызовите matplotlib.scale.get_scale_names(). В этом случае подходящий подкласс Normalize создаётся и инициализируется динамически.

Этот параметр игнорируется, если X содержит данные RGB(A).

vmin, vmaxfloat, необязательный

При использовании скалярных данных без явного задания norm параметры vmin и vmax определяют диапазон данных, охватываемый цветовой картой. По умолчанию цветовая карта охватывает весь диапазон значений переданных данных. Использовать vmin/vmax вместе с экземпляром norm нельзя (однако допустимо использовать имя norm типа str вместе с vmin/vmax).

Этот параметр игнорируется, если X содержит данные RGB(A).

origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (значение по умолчанию: 'upper')

Указывает, находится ли индекс массива [0, 0] в верхнем левом или нижнем левом углу области Axes.

resizebool

Если значение равно True, размер рисунка изменяется в соответствии с размером изображения.

colorizerColorizer или None, по умолчанию: None

Объект Colorizer, используемый для сопоставления цветов с данными. Если задано значение None, объект Colorizer создаётся на основе norm и cmap.

Этот параметр игнорируется, если X содержит данные RGB(A).

Возвращает:

matplotlib.image.FigureImage

Другие параметры:

**kwargs

Дополнительные аргументы kwargs — это аргументы kwargs класса Artist, передаваемые в FigureImage.

Примечания

Примечание

Это обёртка pyplot для Figure.figimage.

figimage дополняет изображение Axes (imshow), которое будет повторно выбрано для соответствия текущей области Axes. Чтобы изображение с повторной выборкой заполнило весь рисунок, можно определить Axes с границами [0, 0, 1, 1].

Примеры

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()

Примеры использования matplotlib.pyplot.figimage

Демонстрация Figimage

Демонстрация Figimage