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, shape=<deprecated parameter>, filternorm=1, filterrad=4.0, imlim=<deprecated parameter>, resample=None, url=None, *, data=None, **kwargs) [source]

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

Параметры:	`X : array-like or PIL image` Данные изображения. Поддерживаемые формы массивов: (M, N): изображение со скалярными данными. Данные визуализируются с использованием цветовой карты. (M, N, 3): изображение с RGB значениями (плавающие числа от 0 до 1 или целые числа от 0 до 255). (M, N, 4): изображение с RGBA значениями (плавающие числа от 0 до 1 или целые числа от 0 до 255), включая прозрачность. Первые два измерения (M, N) определяют строки и столбцы изображения. Значения RGB(A) вне диапазона обрезаются. `cmap : str or Colormap, optional` Экземпляр цветовой карты или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. Этот параметр игнорируется для данных RGB(A). По умолчанию используется `rcParams["image.cmap"]`. `norm : Normalize, 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'). `interpolation : str, optional` Метод интерполяции, используемый. Если None, используется `rcParams["image.interpolation"]`, который по умолчанию равен 'nearest'. Поддерживаемые значения: 'none', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos'. Если interpolation равен 'none', то интерполяция не выполняется на бэкендах Agg, ps, pdf и svg. Другие бэкэнды вернутся к 'nearest'. Обратите внимание, что большинство рендерингов SVG выполняют интерполяцию при рендеринге, и используемый по умолчанию метод интерполяции может отличаться. См. Методы интерполяции для imshow/matshow для обзора поддерживаемых методов интерполяции. Некоторые методы интерполяции требуют дополнительного параметра радиуса, который можно установить с помощью filterrad. Кроме того, фильтр изменения размера изображения антигрейнов управляется параметром filternorm. `alpha : scalar, optional` Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Этот параметр игнорируется для входных данных RGBA. `vmin, vmax : scalar, optional` При использовании скалярных данных и отсутствии явного norm, vmin и vmax определяют диапазон данных, который покрывает цветовая карта. По умолчанию цветовая карта покрывает весь диапазон значений предоставленных данных. vmin, vmax игнорируются, если используется параметр norm. `origin : {'upper', 'lower'}, optional` Поместить индекс [0,0] массива в верхний левый или нижний левый угол осей. Конвенция 'upper' обычно используется для матриц и изображений. Если не указано, используется `rcParams["image.origin"]`, по умолчанию 'upper'. Обратите внимание, что вертикальная ось направлена вверх для 'lower' и вниз для 'upper'. См. учебное пособие origin и extent в imshow для примеров и более подробного описания. `extent : scalars (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 для примеров и более подробного описания. `filternorm : bool, optional, default: True` Параметр для фильтра изменения размера изображения антигрейнов (см. документацию антигрейнов). Если filternorm установлен, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает со значениями исходных чисел с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график нужной формы. `filterrad : float > 0, optional, default: 4.0` Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция равна 'sinc', 'lanczos' или 'blackman'. `resample : bool, optional` Если True, используется полный метод ресемплирования. Если False, ресемплирование выполняется только тогда, когда размер выходного изображения больше, чем размер входного изображения. `url : str, optional` Устанавливает URL созданного `AxesImage`. См. `Artist.set_url`.
Возвращает:	`image : AxesImage`
Другие параметры:	`**kwargs : Artist properties` Эти параметры передаются конструктору объекта `AxesImage`.

См. также

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

Примечания

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

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

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

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

Примечание

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