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 с extents [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