matplotlib.figure.Figure.figimage

Figure.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 (числа с плавающей запятой от 0 до 1 или целые числа от 0 до 255).
• (M, N, 4): изображение со значениями RGBA (числа с плавающей запятой от 0 до 1 или целые числа от 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 — это аргументы Artist, передаваемые в FigureImage.

Примечания

figimage дополняет изображение Axes (imshow), которое подвергается повторной выборке для соответствия текущей области Axes. Чтобы изображение с повторной выборкой заполнило всю фигуру, можно определить объект Axes с extent [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.figure.Figure.figimage

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

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

Изображение водяного знака

Изображение водяного знака

Преобразование текста в изображения

Преобразование текста в изображения