matplotlib.image
Модуль image поддерживает основные операции по загрузке, масштабированию и отображению изображений.
-
class matplotlib.image.AxesImage(ax, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=True, filterrad=4.0, resample=False, **kwargs)[source] -
Базы:
matplotlib.image._ImageBaseИзображение, прикрепленное к оси.
Параметры: -
axAxes -
Ось, к которой будет принадлежать изображение.
-
cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') -
Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.
-
normNormalize -
Преобразует яркость в значения от 0 до 1.
-
interpolationstr, default: rcParams["image.interpolation"] (default: 'antialiased') -
Поддерживаемые значения: 'none', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos'.
-
origin{'upper', 'lower'}, default: rcParams["image.origin"] (default: 'upper') -
Разместить индекс [0, 0] массива в верхнем левом или нижнем левом углу оси. Конвенция 'upper' обычно используется для матриц и изображений.
-
extenttuple, optional -
Оси данных (слева, справа, снизу, сверху) для регистрации графиков изображений с графиками данных. По умолчанию метки пиксельных центров обозначаются нумерацией строк и столбцов с нуля.
-
filternormbool, default: True -
Параметр для фильтра антиалиасинга (см. документацию antigrain). Если установлен filternorm, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он не обрабатывает исходные значения с плавающей точкой, а исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график нужной формы.
-
filterradfloat > 0, default: 4 -
Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция равна 'sinc', 'lanczos' или 'blackman'.
-
resamplebool, default: False -
Если True, использовать полную методику ресемплирования. Если False, ресемплировать только при увеличении размера выходного изображения по сравнению с входным.
-
**kwargsArtist properties
Параметры: -
normmatplotlib.colors.Normalize (or subclass thereof) -
Объект нормализации, масштабирующий данные, обычно в интервал
[0, 1]. Если None, norm по умолчанию является объектом colors.Normalize, который инициализирует масштабирование на основе первых обработанных данных. -
cmapstr or Colormap -
Цветовая карта, используемая для сопоставления нормализованных значений данных с цветами RGBA.
-
format_cursor_data(self, data)[source] -
Возвращает строковое представление данных data.
Примечание
Этот метод предназначен для переопределения подклассами элементов. Пользователю Matplotlib, скорее всего, не придётся вызывать этот метод самостоятельно.
По умолчанию реализация преобразует целые и вещественные числа и массивы целых и вещественных чисел в строку, разделенную запятыми, заключённую в квадратные скобки.
См. также
-
get_cursor_data(self, event)[source] -
Возвращает значение изображения в позиции события или None, если событие находится вне изображения.
См. также
-
get_extent(self)[source] -
Возвращает пределы изображения в виде кортежа (слева, справа, снизу, сверху).
-
get_window_extent(self, renderer=None)[source] -
Возвращает прямоугольник области оси в пространстве отображения.
Ширина и высота прямоугольника неотрицательные.
Подклассы должны переопределять для включения в вычисление "плотного" прямоугольника. По умолчанию возвращается пустой прямоугольник в координатах 0, 0.
Будьте осторожны при использовании этой функции, результаты не обновляются, если изменяется область окна элемента графического интерфейса. Диапазон может изменяться из-за любых изменений в стеке преобразования, например, при изменении пределов осей, размера рисунка или используемой области (как при сохранении рисунка). Это может привести к неожиданному поведению, когда интерактивные рисунки будут выглядеть нормально на экране, но сохранятся неправильно.
-
make_image(self, renderer, magnification=1.0, unsampled=False)[source] -
Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer, с заданным magnification.
Если unsampled True, изображение не будет масштабироваться, а вместо этого будет возвращено соответствующее аффинное преобразование.
Возвращает: -
image(M, N, 4) uint8 array -
Изображение RGBA, ресемплированное, если unsampled не True.
-
x, yfloat -
Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей.
-
transAffine2D -
Аффинное преобразование из пространства изображения в пространство пикселей.
-
-
set_extent(self, extent)[source] -
Устанавливает пределы изображения.
Параметры: -
extent4-tuple of float -
Позиция и размер изображения как кортеж
(left, right, bottom, top)в координатах данных.
Примечания
Это обновляет
ax.dataLim, а если используется автоматическое масштабирование, устанавливаетax.viewLimдля плотного соответствия изображению, независимо отdataLim. Состояние автоматического масштабирования не меняется, поэтому последующее применениеax.autoscale_view()повторно выполнит автоматическое масштабирование в соответствии сdataLim. -
-
-
class matplotlib.image.BboxImage(bbox, cmap=None, norm=None, interpolation=None, origin=None, filternorm=True, filterrad=4.0, resample=False, **kwargs)[source] -
Bases:
matplotlib.image._ImageBaseИзображение, размер которого определяется заданной рамкой.
cmap — экземпляр colors.Colormap, norm — экземпляр colors.Normalize для отображения яркости в диапазоне 0-1
kwargs — необязательный список дополнительных ключевых аргументов для Artist
-
contains(self, mouseevent)[source] -
Проверяет, находится ли точка мыши внутри изображения.
-
get_transform(self)[source] -
Возвращает экземпляр
Transform, используемый этим элементом.
-
get_window_extent(self, renderer=None)[source] -
Возвращает рамку области изображения в пространстве отображения.
Ширина и высота рамки неотрицательны.
Подклассы должны переопределять для включения в вычисление "плотной" рамки. По умолчанию возвращает пустую рамку в координатах (0, 0).
Будьте осторожны при использовании этой функции, результаты не будут обновлены, если изменится область окна элемента. Область может измениться из-за любых изменений в стеке преобразований, например, при изменении пределов осей, размера фигуры или холста (как при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но будут сохранены неправильно.
-
make_image(self, renderer, magnification=1.0, unsampled=False)[source] -
Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer, с указанным magnification.
Если unsampled равно True, изображение не будет масштабироваться, но вместо этого будет возвращено соответствующее аффинное преобразование.
Возвращает: -
image(M, N, 4) uint8 array -
Изображение RGBA, масштабированное, если unsampled не равно True.
-
x, yfloat -
Верхний левый угол, куда должно быть нарисовано изображение, в пространстве пикселей.
-
transAffine2D -
Аффинное преобразование из пространства изображения в пространство пикселей.
-
-
-
class matplotlib.image.FigureImage(fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)[source] -
Bases:
matplotlib.image._ImageBaseИзображение, прикрепленное к фигуре.
cmap — экземпляр colors.Colormap, norm — экземпляр colors.Normalize для отображения яркости в диапазоне 0-1
kwargs — необязательный список дополнительных ключевых аргументов для Artist
-
get_extent(self)[source] -
Возвращает область изображения в виде кортежа (левый, правый, нижний, верхний).
-
make_image(self, renderer, magnification=1.0, unsampled=False)[source] -
Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer, с указанным magnification.
Если unsampled равно True, изображение не будет масштабироваться, но вместо этого будет возвращено соответствующее аффинное преобразование.
Возвращает: -
image(M, N, 4) uint8 array -
Изображение RGBA, масштабированное, если unsampled не равно True.
-
x, yfloat -
Верхний левый угол, куда должно быть нарисовано изображение, в пространстве пикселей.
-
transAffine2D -
Аффинное преобразование из пространства изображения в пространство пикселей.
-
-
set_data(self, A)[source] -
Устанавливает массив изображения.
-
zorder = 0
-
-
class matplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs)[source] -
Bases:
matplotlib.image.AxesImageПараметры: -
interpolation{'nearest', 'bilinear'}, default: 'nearest' - **kwargs
-
Все остальные ключевые аргументы идентичны аргументам
AxesImage.
-
get_extent(self)[source] -
Возвращает область изображения как кортеж (левый, правый, нижний, верхний).
-
property is_grayscale
-
make_image(self, renderer, magnification=1.0, unsampled=False)[source] -
Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer, с заданным magnification.
Если unsampled равно True, изображение не будет масштабироваться, а вместо этого будет возвращена соответствующая аффинная трансформация.
Возвращает: -
image(M, N, 4) uint8 array -
Изображение RGBA, масштабированное, если только unsampled не равно True.
-
x, yfloat -
Левый верхний угол, где должно быть нарисовано изображение, в пространстве пикселей.
-
transAffine2D -
Аффинное преобразование из пространства изображения в пространство пикселей.
-
-
set_array(self, *args)[source] -
Сохранено для обратной совместимости - используйте set_data вместо него.
Параметры: -
Aarray-like
-
-
set_cmap(self, cmap)[source] -
Устанавливает цветовую карту для данных яркости.
Параметры: -
cmapColormap or str or None
-
-
set_data(self, x, y, A)[source] -
Устанавливает сетку для центров пикселей и значения пикселей.
Параметры: -
x, y1D array-like -
Монотонные массивы форм (N,) и (M,), соответственно, задающие центры пикселей.
-
Aarray-like -
(M, N) массив ndarray или masked array значений, которые должны быть отображены в цветовой карте, или (M, N, 3) RGB массив, или (M, N, 4) RGBA массив.
-
-
set_filternorm(self, s)[source] -
Устанавливает, нормализует ли фильтр веса.
См. справку для
imshow.Параметры: -
filternormbool
-
-
set_filterrad(self, s)[source] -
Устанавливает радиус фильтра масштабирования, применимый только к некоторым схемам интерполяции. См. справку для imshow
Параметры: -
filterradpositive float
-
-
set_interpolation(self, s)[source] -
Параметры: -
s{'nearest', 'bilinear'} or None -
Если None, используйте
rcParams["image.interpolation"](по умолчанию:'antialiased').
-
-
set_norm(self, norm)[source] -
Устанавливает экземпляр нормализации.
Параметры: -
normNormalize or None
Примечания
Если для отображения используется цветовая шкала с помощью mappable, установка нормы mappable сбросит норму, локали и форматирование на цветовой шкале до значений по умолчанию.
-
-
-
class matplotlib.image.PcolorImage(ax, x=None, y=None, A=None, cmap=None, norm=None, **kwargs)[source] -
Bases:
matplotlib.image.AxesImageСоздайте график в стиле pcolor с нерегулярной прямоугольной сеткой.
Этот метод использует модификацию исходного кода для изображения с нерегулярной сеткой и используется pcolorfast для соответствующего типа сетки.
Параметры: -
axAxes -
Оси, к которым будет принадлежать изображение.
-
x, y1D array-like, optional -
Монотонные массивы длины N+1 и M+1 соответственно, определяющие границы прямоугольников. Если не указаны, по умолчанию будут использованы
range(N + 1)иrange(M + 1)соответственно. -
Aarray-like -
Данные для цветового кодирования. Интерпретация зависит от формы:
- (M, N) массив NumPy или массив с пропускаемыми значениями: значения для сопоставления с цветовой палитрой
- (M, N, 3): массив RGB
- (M, N, 4): массив RGBA
-
cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') -
Экземпляр цветовой палитры или зарегистрированное имя цветовой палитры, используемое для сопоставления скалярных данных с цветами.
-
normNormalize -
Преобразует яркость в диапазон от 0 до 1.
-
**kwargsArtist properties
-
get_cursor_data(self, event)[source] -
Возвращает значение изображения в позиции курсора или None, если событие находится вне изображения.
См. также
-
property is_grayscale
-
make_image(self, renderer, magnification=1.0, unsampled=False)[source] -
Нормализует, масштабирует и применяет цветовую палитру к данным изображения для визуализации с помощью renderer при заданном magnification.
Если unsampled True, изображение не будет масштабироваться, а вместо этого будет возвращена соответствующая аффинная трансформация.
Возвращает: -
image(M, N, 4) uint8 array -
Изображение RGBA, пересчитанное, если unsampled не True.
-
x, yfloat -
Координаты левого верхнего угла изображения в пространстве пикселей.
-
transAffine2D -
Аффинное преобразование из пространства изображения в пространство пикселей.
-
-
set_array(self, *args)[source] -
Сохранено для обратной совместимости — используйте вместо него set_data.
Параметры: -
Aarray-like
-
-
set_data(self, x, y, A)[source] -
Устанавливает сетку границ прямоугольников и значения данных.
Параметры: -
x, y1D array-like, optional -
Монотонные массивы длины N+1 и M+1 соответственно, определяющие границы прямоугольников. Если не указаны, по умолчанию будут использованы
range(N + 1)иrange(M + 1)соответственно. -
Aarray-like -
Данные для цветового кодирования. Интерпретация зависит от формы:
- (M, N) массив NumPy или массив с пропускаемыми значениями: значения для сопоставления с цветовой палитрой
- (M, N, 3): массив RGB
- (M, N, 4): массив RGBA
-
-
-
matplotlib.image.composite_images(images, renderer, magnification=1.0)[source] -
Комбинирует несколько изображений RGBA в одно. Изображения комбинируются в том порядке, в котором они появляются в списке images.
Параметры: -
imageslist of Images -
Каждый из них должен иметь метод
make_image. Для каждого изображенияcan_compositeдолжно возвращатьTrue, хотя это не проверяется данной функцией. Каждое изображение должно иметь чистое аффинное преобразование без сдвига. -
rendererRendererBase -
magnificationfloat, default: 1 -
Дополнительное увеличение, которое нужно применить для используемого визуализатора.
Возвращает: -
imageuint8 3d array -
Комбинированное изображение RGBA.
-
offset_x, offset_yfloat -
Смещение (слева, снизу) места расположения комбинированного изображения в выходном рисунке.
-
-
matplotlib.image.imread(fname, format=None)[source] -
Чтение изображения из файла в массив.
Параметры: -
fnamestr or file-like -
Файл изображения для чтения: имя файла, URL или объект файла, открытый в режиме чтения в двоичном формате.
-
formatstr, optional -
Формат файла изображения, предполагаемый для чтения данных. Если не задан, формат определяется из имени файла. Если ничего нельзя определить, используется PNG.
Возвращает: -
numpy.array -
Данные изображения. Возвращаемый массив имеет форму
- (M, N) для черно-белых изображений.
- (M, N, 3) для изображений RGB.
- (M, N, 4) для изображений RGBA.
-
-
matplotlib.image.imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None, origin=None, dpi=100, *, metadata=None, pil_kwargs=None)[source] -
Сохранение массива как файла изображения.
Параметры: -
fnamestr or path-like or file-like -
Путь или объект файла для сохранения изображения. Если format не задан, формат вывода определяется по расширению fname (если есть) и из
rcParams["savefig.format"](по умолчанию'png'). Если format задан, он определяет формат вывода. -
arrarray-like -
Данные изображения. Форма может быть MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA).
-
vmin, vmaxfloat, optional -
vmin и vmax устанавливают масштабирование цвета для изображения, фиксируя значения, которые отображаются в цветовых пределах цветовой палитры. Если vmin или vmax равны None, эти пределы определяются по минимальному/максимальному значению в arr.
-
cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis') -
Экземпляр цветовой палитры или зарегистрированное имя цветовой палитры. Цветовая палитра сопоставляет скалярные данные с цветами. Игнорируется для данных RGB(A).
-
formatstr, optional -
Формат файла, например, 'png', 'pdf', 'svg' ... Поведение, когда он не задан, описано в разделе fname.
-
origin{'upper', 'lower'}, default: rcParams["image.origin"] (default: 'upper') -
Указывает, находится ли индекс
(0, 0)массива в левом верхнем или левом нижнем углу осей. -
dpifloat -
DPI для хранения в метаданных файла. Это не влияет на разрешение выходного изображения. В зависимости от формата файла, это может быть округлено до ближайшего целого.
-
metadatadict, optional -
Метаданные в файле изображения. Поддерживаемые ключи зависят от формата вывода, подробности см. в документации соответствующих бэкэндов.
-
pil_kwargsdict, optional -
Ключевые слова, передаваемые в
PIL.Image.Image.save. Если ключ 'pnginfo' присутствует, он полностью переопределяет metadata, включая ключ по умолчанию 'Software'.
-
-
matplotlib.image.pil_to_array(pilImage)[source] -
Загрузка изображения PIL и возвращение его как массива numpy int.
Возвращает: - numpy.array
-
Форма массива зависит от типа изображения:
- (M, N) для черно-белых изображений.
- (M, N, 3) для RGB-изображений.
- (M, N, 4) для RGBA-изображений.
-
matplotlib.image.thumbnail(infile, thumbfile, scale=0.1, interpolation='bilinear', preview=False)[source] -
Создание миниатюры изображения в infile с выходным именем файла thumbfile.
Параметры: -
infilestr or file-like -
Файл изображения. Matplotlib полагается на Pillow для чтения изображений и, таким образом, поддерживает широкий спектр форматов файлов, включая PNG, JPG, TIFF и другие.
-
thumbfilestr or file-like -
Имя файла миниатюры.
-
scalefloat, default: 0.1 -
Коэффициент масштабирования для миниатюры.
-
interpolationstr, default: 'bilinear' -
Схема интерполяции, используемая при ресемплировании. См. параметр interpolation функции
imshowдля возможных значений. -
previewbool, default: False -
Если True, будет использоваться стандартный бэкенд (предположительно, бэкенд пользовательского интерфейса), который приведет к созданию окна графики, если вызов
show. Если False, график создается с помощьюFigureCanvasBase, и бэкенд отрисовки выбирается как в случае сFigure.savefig.
Возвращает: -
Figure -
Экземпляр графика, содержащий миниатюру.
-
© 2012–2018 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.3.3/api/image_api.html