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 — ошибка (но использование str norm вместе с vmin/vmax допустимо).

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

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

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

resizebool

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

Возвращает:

matplotlib.image.FigureImage

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

**kwargs

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

Примечания

Примечание

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

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.pyplot.figimage

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

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