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, **kwargs)[source]

Добавление нересамплированного изображения в рисунок.

Изображение прикрепляется к нижнему или верхнему левому углу в зависимости от 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

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

cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

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

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

normстрока или 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 вместе с vmin/vmax допустимо).

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

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

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

resizebool

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

Возвращаемое значение:

matplotlib.image.FigureImage

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

**kwargs

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

Примечания

figimage дополняет изображение Axes (imshow), которое будет ресемплировано для соответствия текущим осям. Если нужно, чтобы ресемплированное изображение заполнило весь рисунок, можно определить оси 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()