matplotlib.axes.Axes.imshow

Axes.imshow(X, cmap=None, norm=None, aspect=None, interpolation=None, alpha=None, vmin=None, vmax=None, origin=None, extent=None, shape=None, filternorm=1, filterrad=4.0, imlim=None, resample=None, url=None, *, data=None, **kwargs) [source]

Отображение изображения на оси.

Параметры:	X : array_like, shape (n, m) or (n, m, 3) or (n, m, 4) Отобразить изображение в X на текущей оси. X может быть массивом или изображением PIL. Если X является массивом, он может иметь следующие формы и типы: MxN — значения для отображения (float или int) MxNx3 — RGB (float или uint8) MxNx4 — RGBA (float или uint8) Массивы MxN отображаются в цветах, основанные на norm (отображение скаляра на скаляр) и cmap (отображение нормированного скаляра в цвет). Элементы массивов RGB и RGBA представляют пиксели изображения MxN. Все значения должны находиться в диапазоне [0 .. 1] для чисел с плавающей точкой или [0 .. 255] для целых чисел. Значения вне диапазона будут обрезаны до этих границ. cmap : Colormap, optional, default: None Если None, по умолчанию используется значение rc image.cmap. cmap игнорируется, если X имеет размерность 3, напрямую задавая значения RGB(A). aspect : ['auto' | 'equal' | scalar], optional, default: None Если 'auto', изменяет соотношение сторон изображения, чтобы соответствовать соотношению сторон оси. Если 'equal', и extent равно None, изменяет соотношение сторон оси, чтобы соответствовать соотношению сторон изображения. Если extent не None, соотношение сторон оси изменяется, чтобы соответствовать масштабу. Если None, по умолчанию используется значение rc image.aspect. interpolation : string, optional, default: None Допустимые значения: 'none', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos' Если interpolation равно None, по умолчанию используется значение rc image.interpolation. См. также параметры filternorm и filterrad. Если interpolation равно 'none', то интерполяция не выполняется для backends Agg, ps и pdf. Другие backends будут использовать 'nearest'. norm : Normalize, optional, default: None Экземпляр Normalize используется для масштабирования входных данных 2-D float X в диапазон (0, 1) для ввода в cmap. Если norm равно None, используется функция по умолчанию: normalize. Если norm является экземпляром NoNorm, X должен быть массивом целых чисел, которые напрямую индексируют таблицу поиска cmap. vmin, vmax : scalar, optional, default: None vmin и vmax используются совместно с norm для нормализации данных яркости. Обратите внимание, если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут игнорироваться. alpha : scalar, optional, default: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Аргумент alpha игнорируется для входных данных RGBA. origin : ['upper' | 'lower'], optional, default: None Разместить индекс [0,0] массива в верхнем левом или нижнем левом углу оси. Если None, по умолчанию используется значение rc image.origin. extent : scalars (left, right, bottom, top), optional, default: None Позиция, в координатах данных, нижнего левого и верхнего правого углов. Если None, изображение позиционируется так, что центры пикселей попадают на индексы (строка, столбец), начиная с нуля. shape : scalars (columns, rows), optional, default: None Для изображений с сырым буфером filternorm : scalar, optional, default: 1 Параметр для фильтра масштабирования изображения antigrain. Из документации antigrain, если filternorm = 1, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает со значениями исходных чисел с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график правильной формы. filterrad : scalar, optional, default: 4.0 Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одной из: 'sinc', 'lanczos' или 'blackman'
Возвращает:	image : AxesImage
Другие параметры:	**kwargs : Artist properties.

См. также

matshow

Построение матрицы или массива как изображения.

Примечания

Если не используется extent, центры пикселей будут расположены в целочисленных координатах. Другими словами: начало координат совпадёт с центром пикселя (0, 0).

Для изображений RGB с альфа-каналом используются два типичных представления:

• Прямой (не связанный) альфа: каналы R, G и B представляют цвет пикселя, не учитывая его непрозрачность.
• Предварительно умноженный (связанный) альфа: каналы R, G и B представляют цвет пикселя, скорректированный на его непрозрачность умножением.

imshow ожидает изображения RGB, используя прямое (не связанное) представление альфа-канала.

Примечание

Помимо описанных выше аргументов, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:

• Все позиционные и все ключевые аргументы.

Примеры использования matplotlib.axes.Axes.imshow

Палитра

Справочник по палитрам

Обрезка изображений с помощью фигур

Демонстрация штрих-кода

Методы интерполяции для imshow/matshow

Слоирование изображений

Аффинное преобразование изображения

Пример затенения

Множество изображений

Демонстрация изображений

Маскированное изображение

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

Смешивание прозрачности с цветом на 2D изображениях

Изображение контуров

Создание цветовой карты из списка цветов

Создание аннотированных тепловых карт