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

Отображение изображения на осях.

Параметры:	X : array_like, shape (n, m) or (n, m, 3) or (n, m, 4) Отобразить изображение в X на текущих осях. X может быть массивом или изображением PIL. Если X является массивом, он может иметь следующие формы и типы: MxN — значения для отображения (float или int) MxNx3 — RGB (float или uint8) MxNx4 — RGBA (float или uint8) Массивы MxN отображаются в цветах, основанных на norm (отображение скаляра на скаляр) и cmap (отображение нормированного скаляра в цвет). Элементы массивов RGB и RGBA представляют пиксели изображения MxN. Все значения должны быть в диапазоне [0 .. 1] для чисел с плавающей точкой или [0 .. 255] для целых чисел. Значения вне диапазона будут ограничены этими границами. cmap : Colormap, optional, default: None Если None, используется значение по умолчанию rc image.cmap. cmap игнорируется, если X имеет 3 измерения, непосредственно задавая значения RGB(A). aspect : ['auto' | 'equal' | scalar], optional, default: None Если 'auto', изменяет пропорции изображения для соответствия осям. Если 'equal', и extent равно None, изменяет пропорции осей для соответствия изображению. Если extent не None, пропорции осей изменяются для соответствия диапазону. Если None, используется значение по умолчанию rc image.aspect. interpolation : string, optional, default: None Допустимые значения: 'none', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos' Если interpolation равно None, используется значение по умолчанию rc image.interpolation. См. также параметры filternorm и filterrad. Если interpolation равно 'none', интерполяция не выполняется на бэкендах Agg, ps и pdf. Другие бэкенды будут использовать 'nearest'. norm : Normalize, optional, default: None Экземпляр Normalize используется для масштабирования 2-мерного входного значения float X в диапазон (0, 1) для ввода в cmap. Если norm равно None, используется функция по умолчанию: normalize. Если norm является экземпляром NoNorm, X должен быть массивом целых чисел, которые напрямую индексируют в таблицу поиска cmap. vmin, vmax : scalar, optional, default: None vmin и vmax используются совместно с norm для нормализации данных яркости. Обратите внимание, если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут игнорироваться. alpha : scalar, optional, default: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный). Аргумент alpha игнорируется для входных данных RGBA. origin : ['upper' | 'lower'], optional, default: None Поместить индекс [0,0] массива в верхний левый или нижний левый угол осей. Если None, используется значение по умолчанию rc image.origin. extent : scalars (left, right, bottom, top), optional, default: None Расположение, в координатах данных, нижних левых и верхних правых углов. Если None, изображение позиционируется таким образом, что центры пикселей совпадают с индексами (строка, столбец) с нулевым основанием. shape : scalars (columns, rows), optional, default: None Для изображений с необработанным буфером filternorm : scalar, optional, default: 1 Параметр для фильтра изменения размера изображения antigrain. Из документации antigrain, если filternorm = 1, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает со входными значениями с плавающей запятой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график правильной формы. filterrad : scalar, optional, default: 4.0 Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция равна 'sinc', 'lanczos' или 'blackman'
Возвращает:	image : AxesImage
Другие параметры:	**kwargs : Artist properties.

См. также

matshow

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

Примечания

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

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

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

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

Примечание

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

• Все позиционные и все ключевые аргументы.

Примеры использования matplotlib.pyplot.imshow

Настройка отступов

Цветная шкала

Вырезка изображений с фигурами

Демонстрация штрих-кода

Методы интерполяции для imshow/matshow

Слой изображений

Аффинное преобразование изображения

Пример затенения

Множественные изображения

Демонстрация изображения

Маскированное изображение

Демонстрация pcolor

Смешивание прозрачности с цветом на 2D-изображениях

Изображение контуров

Создание цветовой карты из списка цветов

Создание аннотированных тепловых карт

Дельфины

Затенённое и нормализованное по мощности отображение

Анимированное изображение с предварительно вычисленным списком изображений

Гиперссылки

Урок по изображениям

Руководство по плотному макетированию