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) -
Отображение изображения на осях.
Параметры: 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, используется значение по умолчанию из rcimage.interpolation. См. также параметрыfilternormиfilterrad. Еслиinterpolationравно ‘none’, интерполяция не выполняется на бэкендах Agg, ps и pdf. Другие бэкенды будут использовать ‘nearest’.norm :
Normalize, необязательно, по умолчанию: NoneЭкземпляр
Normalizeиспользуется для масштабирования двумерного floatXвходного массива в диапазон (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 : скаляры (left, right, bottom, top), необязательно, по умолчанию: None
Положение, в координатах данных, нижне-левого и верхне-правого углов. Если
None, изображение позиционируется таким образом, что центры пикселей совпадают с нулевыми (строка, столбец) индексами.shape : скаляры (столбцы, строки), необязательно, по умолчанию: None
Для изображений из необработанного буфера
filternorm : скаляр, необязательно, по умолчанию: 1
Параметр для фильтра масштабирования изображения Antigrain. Из документации Antigrain, если
filternorm= 1, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он не делает ничего со значениями исходного числа с плавающей запятой, он исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график нужной формы.filterrad : скаляр, необязательно, по умолчанию: 4.0
Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одной из: ‘sinc’, ‘lanczos’ или ‘blackman’
Возвращает: image :
AxesImageДругие параметры: **kwargs : свойства
Artist.См. также
-
matshow - Построение матрицы или массива как изображения.
Примечания
Если не используется extent, центры пикселей будут расположены в целых координатах. Другими словами: начало координат совпадёт с центром пикселя (0, 0).
Примечание
В дополнение к вышеописанным аргументам, эта функция может принимать ключевой аргумент data. Если такой аргумент data задан, следующие аргументы заменяются на data[<arg>]:
- Все позиционные и все ключевые аргументы.
Примеры использования matplotlib.pyplot.imshow
END_OF_DOCUMENT_MARKER
© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.pyplot.imshow.html