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, **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
-
Значение смешивания альфа-канала.
-
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] массива находится в верхнем левом или нижнем левом углу осей.
- resizebool
-
Если True, размер рисунка изменяется в соответствии с размером данного изображения.
- Возвращает:
-
matplotlib.image.FigureImage
- Другие параметры:
-
- **kwargs
-
Дополнительные параметры kwargs являются параметрами
Artist, передаваемымиFigureImage.
Примечания
figimage дополняет изображение осей (
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.figure.Figure.figimage
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.figure.Figure.figimage.html