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 регулярной растровой структуре.

Входные данные могут быть фактическими данными 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` Экземпляр цветовой карты или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. Этот параметр игнорируется для данных 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. Кроме того, фильтр изменения размера изображения antigrain контролируется параметром 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] массива в верхнем левом или нижнем левом углу осей. Обычно используется соглашение 'верхний' для матриц и изображений. Если не указано, используется `rcParams["image.origin"]` (по умолчанию: 'верхний'), по умолчанию 'верхний'. Обратите внимание, что вертикальная ось направлена вверх для 'нижний', но вниз для 'верхний'. См. учебник происхождения и диапазона в imshow для примеров и более подробного описания. `extentscalars (left, right, bottom, top), optional` Прямоугольник в координатах данных, который будет заполнять изображение. Изображение растягивается индивидуально по осям x и y, чтобы заполнить прямоугольник. Диапазон по умолчанию определяется следующими условиями. Пиксели имеют единичный размер в координатах данных. Их центры находятся на целочисленных координатах, и их центры координат меняются от 0 до столбцов-1 по горизонтали и от 0 до строк-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)`. См. учебник происхождения и диапазона в imshow для примеров и более подробного описания. `filternormbool, optional, default: True` Параметр для фильтра изменения размера изображений antigrain (см. документацию antigrain). Если 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>]: