matplotlib.pyplot.imshow

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

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

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

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

Параметры:	Xмассив или изображение PIL Данные изображения. Поддерживаются следующие формы массивов: (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) вне диапазона обрезаются. cmapстрока или `Colormap`, по умолчанию: `rcParams["image.cmap"]` (по умолчанию: `'viridis'`) Объект Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. Этот параметр игнорируется для данных RGB(A). norm`Normalize`, необязательно Объект `Normalize`, используемый для масштабирования скалярных данных до диапазона [0, 1] перед отображением в цвета с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее минимальное значение с 0, а максимальное - с 1. Этот параметр игнорируется для данных RGB(A). aspect{'equal', 'auto'} или число, по умолчанию: `rcParams["image.aspect"]` (по умолчанию: `'equal'`) Соотношение сторон осей. Этот параметр особенно важен для изображений, так как определяет, являются ли пиксели квадратными. Этот параметр является сокращением для явного вызова `Axes.set_aspect`. Для получения более подробной информации см. его документацию. 'equal': Обеспечивает отношение сторон 1. Пиксели будут квадратными (если размеры пикселей не сделаны неквадратными в координатах данных с помощью extent). 'auto': Ось сохраняется неизменной, а соотношение сторон настраивается таким образом, чтобы данные поместились в область. В общем случае это приведет к неквадратным пикселям. interpolationстрока, по умолчанию: `rcParams["image.interpolation"]` (по умолчанию: `'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' в качестве фильтра антиалиасинга, если изображение не увеличивается в два или один раз. См. Методы интерполяции для imshow для обзора поддерживаемых методов интерполяции и Антиалиасинг изображений для обсуждения антиалиасинга изображений. Некоторые методы интерполяции требуют дополнительного параметра радиуса, который можно задать с помощью filterrad. Кроме того, фильтр изменения размера изображений antigrain управляется параметром filternorm. alphaчисло или массив, необязательно Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Если alpha - массив, значения альфа-смешивания применяются к каждому пикселю, и alpha должен иметь такие же размеры, как и X. vmin, vmaxчисло, необязательно При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта охватывает весь диапазон значений предоставленных данных. Использование vmin/vmax при задании norm устарело. При использовании данных RGB(A) параметры vmin/vmax игнорируются. origin{'upper', 'lower'}, по умолчанию: `rcParams["image.origin"]` (по умолчанию: `'upper'`) Расположить индекс [0, 0] массива в верхнем левом или нижнем левом углу осей. Обычно используется соглашение (по умолчанию) 'upper' для матриц и изображений. Обратите внимание, что вертикальная ось направлена вверх для 'lower' и вниз для 'upper'. См. учебник origin и extent в imshow для примеров и более подробного описания. extentчисла (left, right, bottom, top), необязательно Прямоугольник в координатах данных, который заполнит изображение. Изображение растягивается по оси x и y, чтобы заполнить прямоугольник. Значение по умолчанию для extent определяется следующими условиями. Пиксели имеют единичный размер в координатах данных. Их центры находятся на целых координатах, а их координаты центров изменяются от 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 и extent в imshow для примеров и более подробного описания. filternormbool, по умолчанию: True Параметр фильтра масштабирования изображений antigrain (см. документацию antigrain). Если filternorm установлен, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает с исходными значениями с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график нужной формы. filterradчисло > 0, по умолчанию: 4.0 Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одной из: 'sinc', 'lanczos' или 'blackman'. resamplebool, по умолчанию: `rcParams["image.resample"]` (по умолчанию: `True`) Если True, используется полный метод повторного сэмплирования. Если False, используется повторное сэмплирование только при увеличении выходного изображения по сравнению с входным. urlстрока, необязательно Установить URL созданного `AxesImage`. См. `Artist.set_url`.
Возвращает:	`AxesImage`
Другие параметры:	**kwargs`Artist` свойства Эти параметры передаются конструктору элемента `AxesImage`.

См. также

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

Примечания

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

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

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

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

Примечание

В дополнение к описанным выше аргументам, эта функция может принять аргумент data. Если такой аргумент data указан, каждый другой аргумент также может быть строкой s, которая интерпретируется как data[s] (если это не вызывает исключение).

Объекты, передаваемые в качестве data, должны поддерживать доступ к элементам (data[s]) и проверку на членство (s in data).