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

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

origin{'верхний', 'нижний'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper')

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

resizebool

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

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

matplotlib.image.FigureImage

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

**kwargs

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

Примечания

figimage дополняет изображение осей (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()

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

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

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