matplotlib.axes.Axes.imshow

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

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

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

Параметры:	`Xarray-like or PIL image` Данные изображения. Поддерживаемые формы массивов: (M, N): изображение со скалярными данными. Значения отображаются в цвета с помощью нормализации и цветовой карты. См. параметры norm, cmap, vmin, vmax. (M, N, 3): изображение с значениями RGB (0-1 float или 0-255 int). (M, N, 4): изображение с значениями RGBA (0-1 float или 0-255 int), т. е. включая прозрачность. Первые два измерения (M, N) определяют строки и столбцы изображения. Значения RGB(A) вне диапазона отсекаются. `cmapstr or Colormap, optional` Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. Этот параметр игнорируется для данных RGB(A). По умолчанию `rcParams["image.cmap"]` (по умолчанию: 'viridis'). `normNormalize, optional` Экземпляр `Normalize`, используемый для масштабирования скалярных данных до диапазона [0, 1] перед отображением в цвета с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее минимальное значение с 0, а максимальное — с 1. Этот параметр игнорируется для данных RGB(A). `aspect{'equal', 'auto'} or float, optional` Управляет соотношением сторон осей. Соотношение сторон особенно важно для изображений, поскольку оно может искажать изображение, т. е. пиксели не будут квадратными. Этот параметр является сокращением для явного вызова `Axes.set_aspect`. См. там дополнительные детали. 'equal': Гарантирует соотношение сторон 1. Пиксели будут квадратными (если размеры пикселей не сделаны неквадратными в координатах данных с помощью extent). 'auto': Оси остаются фиксированными, а соотношение сторон корректируется таким образом, чтобы данные поместились в оси. В общем случае это приведет к неквадратным пикселям. Если не указан, используется `rcParams["image.aspect"]` (по умолчанию: 'equal'). `interpolationstr, optional` Метод интерполяции, используемый. Если None, используется `rcParams["image.interpolation"]` (по умолчанию: 'antialiased'). Поддерживаемые значения — 'none', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos'. Если interpolation — 'none', то интерполяция не выполняется для бэкендов Agg, ps, pdf и svg. Другие бэкенды будут использовать 'nearest'. Обратите внимание, что большинство рендереров SVG выполняют интерполяцию при рендеринге, и метод интерполяции по умолчанию, который они реализуют, может отличаться. Если interpolation имеет значение по умолчанию 'antialiased', то используется интерполяция 'nearest', если изображение масштабируется более чем в три раза (т. е. количество пикселей отображения не менее чем в три раза больше размера массива данных). Если коэффициент масштабирования меньше 3 или изображение уменьшается, то используется интерполяция 'hanning' в качестве фильтра антиалиасинга, если изображение не масштабируется ровно в два или один раз. См. Методы интерполяции для imshow для обзора поддерживаемых методов интерполяции и Антиалиасинг изображений для обсуждения антиалиасинга изображений. Некоторые методы интерполяции требуют дополнительного параметра радиуса, который можно задать с помощью filterrad. Кроме того, фильтр изменения размера изображений антигрейда контролируется параметром filternorm. `alphascalar or array-like, optional` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Если alpha — массив, значения альфа-смешивания применяются по пикселям, и alpha должен иметь такую же форму, как и X. `vmin, vmaxscalar, optional` При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, охватываемый цветовой картой. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. vmin, vmax игнорируются, если используется параметр norm. `origin{'upper', 'lower'}, optional` Расположить индекс [0, 0] массива в верхнем левом или нижнем левом углу осей. Конвенция 'upper' обычно используется для матриц и изображений. Если не указано, используется `rcParams["image.origin"]` (по умолчанию: 'upper'), по умолчанию 'upper'. Обратите внимание, что вертикальная ось направлена вверх для 'lower', но вниз для 'upper'. См. учебник origin и extent в imshow для примеров и более подробного описания. `extentscalars (left, right, bottom, top), optional` Ограничивающая рамка в координатах данных, которую заполнит изображение. Изображение растягивается по отдельности по осям x и y для заполнения рамки. Значение по умолчанию для extent определяется следующими условиями. Пиксели имеют единичный размер в координатах данных. Их центры находятся на целочисленных координатах, и их координаты центрального положения изменяются от 0 до columns-1 по горизонтали и от 0 до rows-1 по вертикали. Обратите внимание, что направление вертикальной оси, а следовательно, и значения по умолчанию для верхнего и нижнего значения зависят от 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 и extent в imshow для примеров и более подробного описания. `filternormbool, optional, default: True` Параметр для фильтра изменения размера изображений антигрейда (см. документацию антигрейда). Если filternorm задан, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он не выполняет никаких операций со значениями исходного числа с плавающей запятой, он исправляет только целые числа в соответствии с правилом 1,0, что означает, что любая сумма весов пикселей должна быть равна 1,0. Таким образом, функция фильтра должна создавать график правильной формы. `filterradfloat > 0, optional, default: 4.0` Радиус фильтра для фильтров, имеющих параметр радиуса, т. е. когда интерполяция — одна из: 'sinc', 'lanczos' или 'blackman'. `resamplebool, optional` Если True, используйте метод полного пересчета. Если False, пересчитывайте только при увеличении размера выходного изображения по сравнению с входным изображением. `urlstr, optional` Установите URL созданного `AxesImage`. См. `Artist.set_url`.
Возвращает:	`imageAxesImage`
Другие параметры:	`**kwargsArtist properties` Эти параметры передаются конструктору художника `AxesImage`.

См. также

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

Примечания

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

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

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

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

Примечание

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