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, interpolation_stage=None, filternorm=True, filterrad=4.0, resample=None, url=None, data=None, **kwargs)[source]

Отображение данных в виде изображения, т.е. на 2D регулярной растровой сетке.

Входными данными могут быть фактические данные RGB(A) или 2D скалярные данные, которые будут визуализированы как изображение в псевдоцвете. Для отображения изображения в градациях серого настройте цветовое отображение с помощью параметров cmap='gray', vmin=0, vmax=255.

Количество пикселей, используемых для визуализации изображения, задается размером Axes и dpi рисунка. Это может привести к артефактам алиасинга при повторной выборке изображения, поскольку размер отображаемого изображения обычно не будет совпадать с размером X (см. Image antialiasing). Ресемплинг можно контролировать с помощью параметра interpolation и/или rcParams["image.interpolation"] (по умолчанию: 'antialiased').

Parameters

Xarray-like or PIL image

Данные изображения. Поддерживаемые формы массивов:

(M, N): изображение со скалярными данными. Значения сопоставляются с цветами с использованием нормализации и цветовой карты. См. параметры norm, cmap, vmin, vmax.
(M, N, 3): изображение со значениями RGB (вещественные числа от 0 до 1 или целые числа от 0 до 255).
(M, N, 4): изображение со значениями RGBA (вещественные числа от 0 до 1 или целые числа от 0 до 255), т.е. включая прозрачность.

Первые два измерения (M, N) определяют строки и столбцы изображения.

Значения RGB(A) за пределами допустимого диапазона обрезаются.

cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')

Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. Этот параметр игнорируется для данных RGB(A).

normNormalize, optional

Экземпляр Normalize, используемый для масштабирования скалярных данных до диапазона [0, 1] перед сопоставлением с цветами с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее наименьшее значение с 0, а наибольшее — с 1. Этот параметр игнорируется для данных RGB(A).

aspect{'equal', 'auto'} or float, default: rcParams["image.aspect"] (default: 'equal')

Соотношение сторон Axes. Этот параметр особенно важен для изображений, поскольку он определяет, являются ли пиксели квадратными.

Этот параметр является сокращением для явного вызова Axes.set_aspect. См. там для получения более подробной информации.

'equal': Обеспечивает соотношение сторон 1. Пиксели будут квадратными (если размеры пикселей не заданы явно неквадратными в координатах данных с помощью extent).
'auto': Axes остается фиксированным, а соотношение сторон корректируется так, чтобы данные помещались в Axes. В общем случае это приведет к неквадратным пикселям.

interpolationstr, default: rcParams["image.interpolation"] (default: 'antialiased')

Используемый метод интерполяции.

Поддерживаемые значения: 'none', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'.

Если interpolation равно 'none', то интерполяция не выполняется в бэкендах Agg, ps, pdf и svg. Другие бэкенды перейдут на 'nearest'. Обратите внимание, что большинство рендереров SVG выполняют интерполяцию при рендеринге, и используемый ими метод интерполяции по умолчанию может отличаться.

Если interpolation имеет значение по умолчанию 'antialiased', то используется интерполяция 'nearest', если изображение масштабируется более чем в три раза (т.е. количество пикселей на дисплее как минимум в три раза больше размера массива данных). Если коэффициент масштабирования меньше 3 или изображение уменьшается, то для действия как антиалиасинговый фильтр используется интерполяция 'hanning', если только изображение не масштабируется точно в два или один раз.

См. Interpolations for imshow для обзора поддерживаемых методов интерполяции и Image antialiasing для обсуждения антиалиасинга изображений.

Некоторые методы интерполяции требуют дополнительного параметра радиуса, который можно установить с помощью filterrad. Кроме того, фильтр изменения размера изображения antigrain управляется параметром filternorm.

interpolation_stage{'data', 'rgba'}, default: 'data'

Если 'data', интерполяция выполняется на данных, предоставленных пользователем. Если 'rgba', интерполяция выполняется после применения цветового отображения (визуальная интерполяция).

alphafloat or array-like, optional

Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Если alpha является массивом, значения альфа-смешивания применяются пиксель за пикселем, и alpha должен иметь ту же форму, что и X.

vmin, vmaxfloat, optional

При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который охватывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при заданном norm является ошибкой. При использовании данных RGB(A) параметры vmin/vmax игнорируются.

origin{'upper', 'lower'}, default: rcParams["image.origin"] (default: 'upper')

Разместите индекс [0, 0] массива в левом верхнем или левом нижнем углу Axes. Конвенция (по умолчанию) 'upper' обычно используется для матриц и изображений.

Обратите внимание, что вертикальная ось направлена вверх для 'lower', но вниз для 'upper'.

См. учебник origin and extent in imshow для примеров и более подробного описания.

extentfloats (left, right, bottom, top), optional

Ограничивающий прямоугольник в координатах данных, который будет заполнен изображением. Изображение растягивается индивидуально вдоль x и y, чтобы заполнить прямоугольник.

Границы по умолчанию определяются следующими условиями. Пиксели имеют единичный размер в координатах данных. Их центры находятся в целочисленных координатах, и их координаты центров находятся в диапазоне от 0 до columns-1 по горизонтали и от 0 до rows-1 по вертикали.

Обратите внимание, что направление вертикальной оси и, следовательно, значения top и bottom по умолчанию зависят от origin:

Для origin == 'upper' значение по умолчанию — (-0.5, numcols-0.5, numrows-0.5, -0.5).
Для origin == 'lower' значение по умолчанию — (-0.5, numcols-0.5, -0.5, numrows-0.5).

См. учебник origin and extent in imshow для примеров и более подробного описания.

filternormbool, default: True

Параметр для фильтра изменения размера изображения antigrain (см. документацию antigrain). Если filternorm установлен, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает с исходными значениями с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график правильной формы.

filterradfloat > 0, default: 4.0

Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одним из следующих: 'sinc', 'lanczos' или 'blackman'.

resamplebool, default: rcParams["image.resample"] (default: True)

Если True, используйте полный метод ресемплинга. Если False, ресемплируйте только тогда, когда выходное изображение больше входного изображения.

urlstr, optional

Установите URL созданного AxesImage. См. Artist.set_url.

Returns

AxesImage

Other Parameters

dataindexable object, optional: Если задано, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).
**kwargsArtist properties: Эти параметры передаются конструктору объекта AxesImage.

См. также

matshow: Построить матрицу или массив в виде изображения.

Примечания

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

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

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

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