matplotlib.axes.Axes.imshow

Axes.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, *, data=None, **kwargs)

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

Параметры:

Параметры:	X : массив_подобный, форма (n, m) или (n, m, 3) или (n, m, 4) Отобразить изображение в `X` на текущих осях. `X` может быть массивом или изображением PIL. Если `X` является массивом, он может иметь следующие формы и типы: MxN – значения для отображения (float или int) MxNx3 – RGB (float или uint8) MxNx4 – RGBA (float или uint8) Значение для каждого компонента массивов MxNx3 и MxNx4 типа float должно быть в диапазоне от 0,0 до 1,0. Массивы MxN отображаются в цветах на основе `norm` (отображение скаляра на скаляр) и `cmap` (отображение нормированного скаляра в цвет). cmap : `Colormap`, необязательно, по умолчанию: None Если None, используется значение по умолчанию из rc `image.cmap`. `cmap` игнорируется, если `X` является 3-мерным, напрямую задавая значения RGB(A). aspect : [‘auto’ \| ‘equal’ \| скаляр], необязательно, по умолчанию: None Если ‘auto’, изменяет соотношение сторон изображения, чтобы соответствовать соотношению сторон осей. Если ‘equal’, и `extent` равно None, изменяет соотношение сторон осей, чтобы соответствовать соотношению сторон изображения. Если `extent` не `None`, соотношение сторон осей изменяется, чтобы соответствовать соотношению сторон области отображения. Если None, используется значение по умолчанию из rc `image.aspect`. interpolation : строка, необязательно, по умолчанию: 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`, необязательно, по умолчанию: None Экземпляр `Normalize` используется для масштабирования двумерного входного значения типа float `X` в диапазон (0, 1) для входных данных в `cmap`. Если `norm` равно None, используется функция по умолчанию: `normalize`. Если `norm` является экземпляром `NoNorm`, `X` должен быть массивом целых чисел, которые напрямую указывают на таблицу значений `cmap`. vmin, vmax : скаляр, необязательно, по умолчанию: None `vmin` и `vmax` используются совместно с norm для нормализации данных яркости. Обратите внимание, если вы передаете экземпляр `norm`, ваши настройки для `vmin` и `vmax` будут проигнорированы. alpha : скаляр, необязательно, по умолчанию: None Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный) origin : [‘upper’ \| ‘lower’], необязательно, по умолчанию: None Разместить индекс [0,0] массива в верхнем левом или нижнем левом углу осей. Если None, используется значение по умолчанию из rc `image.origin`. extent : скаляры (левый, правый, нижний, верхний), необязательно, по умолчанию: None Расположение в координатах данных левого нижнего и правого верхнего углов. Если `None`, изображение размещается так, что центры пикселей попадают на нулевые (строка, столбец) индексы. shape : скаляры (столбцы, строки), необязательно, по умолчанию: None Для изображений из необработанного буфера filternorm : скаляр, необязательно, по умолчанию: 1 Параметр для фильтра изменения размера изображения антигрейда. Согласно документации антигрейда, если `filternorm` = 1, фильтр нормализует целые значения и исправляет ошибки округления. Он ничего не делает со значениями исходных чисел с плавающей запятой, он исправляет только целые числа в соответствии с правилом 1,0, что означает, что любая сумма весов пикселей должна быть равна 1,0. Таким образом, функция фильтра должна создавать график правильной формы. filterrad : скаляр, необязательно, по умолчанию: 4,0 Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одной из: ‘sinc’, ‘lanczos’ или ‘blackman’
Возвращает:	image : `AxesImage`
Другие параметры:
	**kwargs : свойства `Artist`.

X : массив_подобный, форма (n, m) или (n, m, 3) или (n, m, 4)

Отобразить изображение в X на текущих осях. X может быть массивом или изображением PIL. Если X является массивом, он может иметь следующие формы и типы:

MxN – значения для отображения (float или int)
MxNx3 – RGB (float или uint8)
MxNx4 – RGBA (float или uint8)

Значение для каждого компонента массивов MxNx3 и MxNx4 типа float должно быть в диапазоне от 0,0 до 1,0. Массивы MxN отображаются в цветах на основе norm (отображение скаляра на скаляр) и cmap (отображение нормированного скаляра в цвет).

cmap : Colormap, необязательно, по умолчанию: None

Если None, используется значение по умолчанию из rc image.cmap. cmap игнорируется, если X является 3-мерным, напрямую задавая значения RGB(A).

aspect : [‘auto’ | ‘equal’ | скаляр], необязательно, по умолчанию: None

Если ‘auto’, изменяет соотношение сторон изображения, чтобы соответствовать соотношению сторон осей.

Если ‘equal’, и extent равно None, изменяет соотношение сторон осей, чтобы соответствовать соотношению сторон изображения. Если extent не None, соотношение сторон осей изменяется, чтобы соответствовать соотношению сторон области отображения.

Если None, используется значение по умолчанию из rc image.aspect.

interpolation : строка, необязательно, по умолчанию: 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, необязательно, по умолчанию: None

Экземпляр Normalize используется для масштабирования двумерного входного значения типа float X в диапазон (0, 1) для входных данных в cmap. Если norm равно None, используется функция по умолчанию: normalize. Если norm является экземпляром NoNorm, X должен быть массивом целых чисел, которые напрямую указывают на таблицу значений cmap.

vmin, vmax : скаляр, необязательно, по умолчанию: None

vmin и vmax используются совместно с norm для нормализации данных яркости. Обратите внимание, если вы передаете экземпляр norm, ваши настройки для vmin и vmax будут проигнорированы.

alpha : скаляр, необязательно, по умолчанию: None

Значение альфа-смешивания, от 0 (прозрачный) до 1 (непрозрачный)

origin : [‘upper’ | ‘lower’], необязательно, по умолчанию: None

Разместить индекс [0,0] массива в верхнем левом или нижнем левом углу осей. Если None, используется значение по умолчанию из rc image.origin.

extent : скаляры (левый, правый, нижний, верхний), необязательно, по умолчанию: None

Расположение в координатах данных левого нижнего и правого верхнего углов. Если None, изображение размещается так, что центры пикселей попадают на нулевые (строка, столбец) индексы.

shape : скаляры (столбцы, строки), необязательно, по умолчанию: None

Для изображений из необработанного буфера

filternorm : скаляр, необязательно, по умолчанию: 1

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

filterrad : скаляр, необязательно, по умолчанию: 4,0

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

Возвращает:

image : AxesImage

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

**kwargs : свойства Artist.

См. также

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

Примечания

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

Примечание

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

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