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, interpolation_stage=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).

normNormalize, необязательно

Экземпляр Normalize используемый для масштабирования скалярных данных в диапазон [0, 1] перед отображением в цвета с помощью cmap. По умолчанию используется линейное масштабирование, сопоставляющее минимальное значение с 0, а максимальное с 1. Этот параметр игнорируется для данных RGB(A).

aspect{'equal', 'auto'} или число, по умолчанию: rcParams["image.aspect"] (по умолчанию: 'equal')

Соотношение сторон области Axes. Этот параметр особенно важен для изображений, поскольку он определяет, являются ли пиксели квадратными.

Этот параметр является сокращением для явного вызова Axes.set_aspect. См. там дополнительные подробности.

• 'equal': Обеспечивает соотношение сторон 1. Пиксели будут квадратными (если размеры пикселей явным образом не сделаны неквадратными в координатах данных с помощью extent).
• 'auto': Область Axes остается неизменной, а соотношение сторон корректируется таким образом, чтобы данные поместились в область Axes. В общем случае это приведет к неквадратным пикселям.

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. Кроме того, фильтр изменения размера изображения антиграйна контролируется параметром filternorm.

interpolation_stage{'data', 'rgba'}, по умолчанию: 'data'

Если 'data', интерполяция выполняется над предоставленными пользователем данными. Если 'rgba', интерполяция выполняется после применения цветового отображения (визуальная интерполяция).

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] массива в верхнем левом или нижнем левом углу области Axes. Конвенция (по умолчанию) 'upper' обычно используется для матриц и изображений.

Обратите внимание, что вертикальная ось направлена вверх для 'lower', но вниз для 'upper'.

См. учебник origin и extent в imshow для примеров и более подробного описания.

extentчисла (left, right, bottom, top), необязательно

Границы области данных, которую заполнит изображение. Изображение растягивается отдельно по осям x и y для заполнения области.

Значение по умолчанию для extent определяется следующими условиями. Пиксели имеют единичный размер в координатах данных. Их центры находятся в целых координатах, и их координаты центра варьируются от 0 до столбцов-1 по горизонтали и от 0 до строк-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 для примеров и более подробного описания.

filternormбулево, по умолчанию: True

Параметр для фильтра изменения размера изображения антиграйна (см. документацию антиграйна). Если filternorm установлен, фильтр нормализует целые значения и исправляет ошибки округления. Он не выполняет никаких действий с исходными значениями с плавающей точкой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график правильной формы.

filterradчисло > 0, по умолчанию: 4.0

Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одной из: 'sinc', 'lanczos' или 'blackman'.

resampleбулево, по умолчанию: rcParams["image.resample"] (по умолчанию: True)

При значении True используется метод полного пересчёта. При значении False пересчёт выполняется только при увеличении размера выходного изображения по сравнению с входным изображением.

urlстрока, необязательно

Устанавливает адрес URL созданного AxesImage. См. Artist.set_url.

Возвращает

AxesImage

Другие параметры

dataиндексируемый объект, необязательно

Если указан, все параметры также принимают строку s, которая интерпретируется как data[s] (если это не вызывает исключение).

**kwargsArtist свойства

Эти параметры передаются в конструктор AxesImage объекта.

См. также

matshow

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

Примечания

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

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

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

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

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