matplotlib.image

Модуль image поддерживает основные операции по загрузке, масштабированию и отображению изображений.

classmatplotlib.image.AxesImage(ax, *, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=True, filterrad=4.0, resample=False, interpolation_stage=None, **kwargs)[source]

Bases: _ImageBase

Изображение, прикреплённое к оси.

Параметры:

axAxes: Ось, к которой будет принадлежать изображение.
cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis'): Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами.
normstr или Normalize: Преобразует яркость в значения от 0 до 1.
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_stage{'data', 'rgba'}, по умолчанию: 'data': Если 'data', интерполяция выполняется над данными, предоставленными пользователем. Если 'rgba', интерполяция выполняется после применения цветового сопоставления (визуальная интерполяция).
origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper'): Расположить индекс [0, 0] массива в верхнем левом или нижнем левом углу осей. Конвенция 'upper' обычно используется для матриц и изображений.
extentкортеж, необязательно: Оси данных (лево, право, низ, верх) для регистрации графиков изображений с графиками данных. По умолчанию пиксельные центры маркируются нулевыми индексами строки и столбца.
filternormbool, по умолчанию: True: Параметр для фильтра масштабирования изображения antigrain (см. документацию antigrain). Если filternorm установлено, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он ничего не делает с исходными значениями с плавающей запятой, исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график правильной формы.
filterradfloat > 0, по умолчанию: 4: Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция — одна из: 'sinc', 'lanczos' или 'blackman'.
resamplebool, по умолчанию: False: Если True, используется метод полного ресемплирования. Если False, ресемплирование выполняется только когда выходное изображение больше входного изображения.
**kwargsArtist свойства

Параметры:

normNormalize (или подкласс) или str или None: Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если строка, подкласс Normalize генерируется динамически на основе масштаба с соответствующим именем. Если None, norm по умолчанию устанавливается как объект colors.Normalize, который инициализирует свой масштаб на основе первых обработанных данных.
cmapstr или Colormap: Цветовая карта, используемая для сопоставления нормализованных значений данных с цветами RGBA.

get_cursor_data(event)[source]

Возвращает значение изображения в позиции события или None, если событие находится вне изображения.

См. также

matplotlib.artist.Artist.get_cursor_data

get_extent()[source]: Возвращает область изображения как кортеж (лево, право, низ, верх).

get_window_extent(renderer=None)[source]

Получить область ограничивающей рамки элемента в пространстве отображения.

Ширина и высота ограничивающей рамки неотрицательны.

Подклассы должны переопределять, чтобы включить в вычисление "уплощенной" ограничивающей рамки. По умолчанию возвращается пустая ограничивающая рамка в координатах 0, 0.

Будьте осторожны при использовании этой функции, результаты не обновятся, если изменится область отображения элемента. Область может измениться из-за любых изменений в стеке преобразований, таких как изменение пределов осей, размера фигуры или используемого холста (как при сохранении фигуры). Это может привести к непредсказуемому поведению, когда интерактивные фигуры будут выглядеть хорошо на экране, но сохранятся неправильно.

make_image(renderer, magnification=1.0, unsampled=False)[source]

Нормализует, масштабирует и применяет цветовую карту к данным этого изображения для отрисовки с помощью renderer, с заданным magnification.

Если unsampled равно True, изображение не будет масштабироваться, но будет возвращена соответствующая аффинная трансформация.

Возвращает:

image(M, N, 4) numpy.uint8 массив: Изображение RGBA, ресемплированное, если unsampled равно True.
x, yfloat: Верхний левый угол, где должно быть нарисовано изображение, в пикселях.
transAffine2D: Аффинное преобразование из пространства изображения в пространство пикселей.

END_OF_DOCUMENT_MARKER

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, array=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, data=<UNSET>, extent=<UNSET>, filternorm=<UNSET>, filterrad=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, interpolation=<UNSET>, interpolation_stage=<UNSET>, label=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, resample=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установить сразу несколько свойств.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив (m, n, 3) с плавающей точкой и значение dpi и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	число с плавающей точкой или двумерный массив-подобный объект или None
`animated`	булево значение
`array`	массив-подобный объект
`clim`	(vmin: float, vmax: float)
`clip_box`	`BboxBase` или None
`clip_on`	булево значение
`clip_path`	объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`data`	массив-подобный объект или `PIL.Image.Image`
`extent`	кортеж из 4 чисел с плавающей точкой
`figure`	`Figure`
`filternorm`	булево значение
`filterrad`	положительное число с плавающей точкой
`gid`	строка
`in_layout`	булево значение
`interpolation`	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`mouseover`	булево значение
`norm`	`Normalize` или строка или None
`path_effects`	список объектов `AbstractPathEffect`
`picker`	None или булево значение или число с плавающей точкой или вызываемая функция
`rasterized`	булево значение
`resample`	булево значение или None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	число с плавающей точкой

set_extent(extent, **kwargs)[source]

Установить область изображения.

Параметры:

extentкортеж из 4 чисел с плавающей точкой: Положение и размер изображения как кортеж (left, right, bottom, top) в координатах данных.
**kwargs: Дополнительные параметры, из которых извлекается информация о единицах измерения (т.е., xunits, yunits, zunits (для 3D осей), runits и thetaunits (для полярных осей), если они присутствуют).

Примечания

Это обновляет ax.dataLim, и, если используется автоматическое масштабирование, устанавливает ax.viewLim для плотного соответствия изображению, независимо от dataLim. Состояние автоматического масштабирования не изменяется, поэтому за этим может следовать ax.autoscale_view(), что повторно выполнит автоматическое масштабирование в соответствии с dataLim.

classmatplotlib.image.BboxImage(bbox, *, cmap=None, norm=None, interpolation=None, origin=None, filternorm=True, filterrad=4.0, resample=False, **kwargs)[source]

Базовый класс: _ImageBase

Класс изображения, размер которого определяется заданной областью.

cmap — экземпляр colors.Colormap, norm — экземпляр colors.Normalize для сопоставления яркости со значениями от 0 до 1

kwargs — необязательный список ключевых аргументов Artist

contains(mouseevent)[source]: Проверка, произошла ли обработка события мыши внутри изображения.

get_window_extent(renderer=None)[source]

Получить область отображения элемента в пространстве отображения.

Ширина и высота области отображения неотрицательны.

Подклассы должны переопределять для включения в вычисление "плотной" области отображения. По умолчанию возвращается пустая область отображения в точке 0, 0.

Будьте осторожны при использовании этой функции, результаты не будут обновляться, если область отображения элемента изменится. Область отображения может измениться из-за любых изменений в стеке преобразований, например, при изменении пределов осей, размера фигуры или используемого холста (как это делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но при сохранении будут сохранены некорректно.

make_image(renderer, magnification=1.0, unsampled=False)[source]

Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer с заданным magnification.

Если unsampled равно True, изображение не будет масштабироваться, а вместо этого будет возвращено соответствующее аффинное преобразование.

Возвращает:

image(M, N, 4) numpy.uint8 массив: Изображение RGBA, масштабированное, если unsampled не равно True.
x, yчисло с плавающей точкой: Координаты верхнего левого угла изображения в пространстве пикселей.
transAffine2D: Аффинное преобразование из пространства изображения в пространство пикселей.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, array=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, data=<UNSET>, filternorm=<UNSET>, filterrad=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, interpolation=<UNSET>, interpolation_stage=<UNSET>, label=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, resample=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установить несколько свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	число с плавающей точкой или 2D массив-подобный объект или None
`animated`	булево значение
`array`	массив-подобный объект
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`BboxBase` или None
`clip_on`	булево значение
`clip_path`	Объект Patch или (Путь, Преобразование) или None
`cmap`	`Colormap` или строка или None
`data`	массив-подобный объект или `PIL.Image.Image`
`figure`	`Figure`
`filternorm`	булево значение
`filterrad`	положительное число с плавающей точкой
`gid`	строка
`in_layout`	булево значение
`interpolation`	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`mouseover`	булево значение
`norm`	`Normalize` или строка или None
`path_effects`	список `AbstractPathEffect`
`picker`	None или булево значение или число с плавающей точкой или вызываемый объект
`rasterized`	булево значение
`resample`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	число с плавающей точкой

classmatplotlib.image.FigureImage(fig, *, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)[source]

Bases: _ImageBase

Изображение, прикрепленное к графику.

cmap — экземпляр colors.Colormap; norm — экземпляр colors.Normalize для сопоставления яркости с диапазоном 0-1

kwargs — необязательный список ключевых аргументов для объекта Artist

get_extent()[source]: Возвращает границы изображения в виде кортежа (левый, правый, нижний, верхний).

make_image(renderer, magnification=1.0, unsampled=False)[source]

Нормализует, масштабирует и применяет цветовую карту к данным изображения для отрисовки с помощью renderer и заданным magnification.

Если unsampled равно True, изображение не будет масштабироваться, а вместо этого будет возвращена соответствующая аффинная трансформация.

Возвращаемое значение:

image(M, N, 4) numpy.uint8 массив: Изображение RGBA, масштабированное, если unsampled не равно True.
x, yfloat: Координаты верхнего левого угла изображения в пространстве пикселей.
transAffine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, array=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, data=<UNSET>, filternorm=<UNSET>, filterrad=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, interpolation=<UNSET>, interpolation_stage=<UNSET>, label=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, rasterized=<UNSET>, resample=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установка нескольких свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	число с плавающей точкой или двумерный массив-подобный объект или None
`animated`	булево значение
`array`	массив-подобный объект
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`BboxBase` или None
`clip_on`	булево значение
`clip_path`	фигура или (путь, преобразование) или None
`cmap`	`Colormap` или строка или None
`data`	неизвестно
`figure`	`Figure`
`filternorm`	булево значение
`filterrad`	положительное число с плавающей точкой
`gid`	строка
`in_layout`	булево значение
`interpolation`	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`mouseover`	булево значение
`norm`	`Normalize` или строка или None
`path_effects`	список `AbstractPathEffect`
`picker`	None или булево значение или число с плавающей точкой или вызываемый объект
`rasterized`	булево значение
`resample`	булево значение или None
`sketch_params`	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
`snap`	булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	булево значение
`zorder`	число с плавающей точкой

set_data(A)[source]: Установить массив изображения.

zorder=0

classmatplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs)[source]

Bases: AxesImage

Parameters:

axAxes: The axes the image will belong to.
interpolation{'nearest', 'bilinear'}, default: 'nearest': The interpolation scheme used in the resampling.
**kwargs: All other keyword arguments are identical to those of AxesImage.

get_extent()[source]: Return the image extent as tuple (left, right, bottom, top).

make_image(renderer, magnification=1.0, unsampled=False)[source]

Normalize, rescale, and colormap this image's data for rendering using renderer, with the given magnification.

If unsampled is True, the image will not be scaled, but an appropriate affine transformation will be returned instead.

Returns:

image(M, N, 4) numpy.uint8 array: The RGBA image, resampled unless unsampled is True.
x, yfloat: The upper left corner where the image should be drawn, in pixel space.
transAffine2D: The affine transformation from image to pixel space.

mouseover=False

Установить несколько свойств одновременно.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	Функция фильтра, которая принимает массив (m, n, 3) с плавающей точкой и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	Вещественное число или двумерный массив-подобный объект или None
`animated`	Булево значение
`array`	неизвестно
`clim`	(vmin: float, vmax: float)
`clip_box`	`BboxBase` или None
`clip_on`	Булево значение
`clip_path`	Объект Patch или (Path, Transform) или None
`cmap`	неизвестно
`data`	неизвестно
`extent`	4-кортеж из вещественных чисел
`figure`	`Figure`
`filternorm`	неизвестно
`filterrad`	неизвестно
`gid`	строка
`in_layout`	Булево значение
`interpolation`	{'nearest', 'bilinear'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`mouseover`	Булево значение
`norm`	неизвестно
`path_effects`	список `AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`rasterized`	Булево значение
`resample`	Булево значение или None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	Булево значение или None
`transform`	`Transform`
`url`	строка
`visible`	Булево значение
`zorder`	вещественное число

set_array(*args)[source]

Сохранено для обратной совместимости - используйте set_data вместо него.

Parameters:

Aarray-like

set_cmap(cmap)[source]

Установить цветовую карту для данных яркости.

Parameters:

cmapColormap или строка или None

set_data(x, y, A)[source]

Установите сетку для центров пикселей и значения пикселей.

Параметры:

x, yОдномерный массив-подобный объект: Монотонные массивы форм (N,) и (M,) соответственно, определяющие центры пикселей.
Aмассив-подобный объект: (M, N) ndarray или массив значений, подлежащих цветовому кодированию, или массив (M, N, 3) RGB, или (M, N, 4) RGBA.

set_filternorm(filternorm)[source]

Установите, нормализует ли фильтр веса.

См. справку для imshow.

Параметры:

filternormbool

set_filterrad(filterrad)[source]

Установите радиус фильтра масштабирования, применимый только к некоторым схемам интерполяции - см. справку для imshow.

Параметры:

filterradположительное число с плавающей запятой

set_interpolation(s)[source]

Параметры:

s{'nearest', 'bilinear'} или None: Если None, используйте rcParams["image.interpolation"] (по умолчанию: 'antialiased').

set_norm(norm)[source]

Установите экземпляр нормализации.

Параметры:

normNormalize или str или None

Примечания

Если для отображения используется какие-либо цветовые шкалы, настройка нормы mappable сбросит норму, локатор и форматировщики на цветовой шкале по умолчанию.

classmatplotlib.image.PcolorImage(ax, x=None, y=None, A=None, *, cmap=None, norm=None, **kwargs)[source]

Основывается на AxesImage

Создайте график типа pcolor с неравномерной прямоугольной сеткой.

Это использует вариацию исходного кода изображения с неравномерной сеткой, и используется pcolorfast для соответствующего типа сетки.

Параметры:

axAxes

Система координат, к которой будет принадлежать изображение.

x, yОдномерный массив-подобный объект, необязательно

Монотонные массивы длиной N+1 и M+1 соответственно, определяющие границы прямоугольников. Если не указаны, по умолчанию будут установлены range(N + 1) и range(M + 1) соответственно.

Aмассив-подобный объект

Данные, которые будут закодированы цветом. Интерпретация зависит от формы:

(M, N) ndarray или массив с пропусками: значения, подлежащие цветовому кодированию
(M, N, 3): массив RGB
(M, N, 4): массив RGBA

cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

Экземпляр Colormap или имя зарегистрированной цветовой карты, используемые для отображения скалярных данных в цвета.

normstr или Normalize

Преобразует яркость к значениям 0-1.

**kwargsArtist свойства

get_cursor_data(event)[source]

Возвращает значение изображения в позиции события или None, если событие находится за пределами изображения.

См. также

matplotlib.artist.Artist.get_cursor_data

make_image(renderer, magnification=1.0, unsampled=False)[source]

Нормализует, масштабирует и использует цветовую карту данных этого изображения для визуализации с помощью renderer, с заданным magnification.

Если unsampled равно True, изображение не будет масштабироваться, вместо этого будет возвращена соответствующая аффинная трансформация.

Возвращает:

image(M, N, 4) numpy.uint8 массив: Изображение RGBA, повторно выборочное, если unsampled не равно True.
x, yfloat: Левый верхний угол, где должно быть нарисовано изображение, в пространстве пикселей.
transAffine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

Установить несколько свойств сразу.

Поддерживаемые свойства:

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей запятой и значение dpi, а возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения
`alpha`	число с плавающей запятой или двумерный массив-подобный объект или None
`animated`	логическое значение
`array`	неизвестно
`clim`	(vmin: число с плавающей запятой, vmax: число с плавающей запятой)
`clip_box`	`BboxBase` или None
`clip_on`	логическое значение
`clip_path`	Объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`data`	неизвестно
`extent`	кортеж из 4 чисел с плавающей запятой
`figure`	`Figure`
`filternorm`	логическое значение
`filterrad`	положительное число с плавающей запятой
`gid`	строка
`in_layout`	логическое значение
`interpolation`	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`mouseover`	логическое значение
`norm`	`Normalize` или строка или None
`path_effects`	список объектов `AbstractPathEffect`
`picker`	None или логическое значение или число с плавающей запятой или вызываемая функция
`rasterized`	логическое значение
`resample`	логическое значение или None
`sketch_params`	(scale: число с плавающей запятой, length: число с плавающей запятой, randomness: число с плавающей запятой)
`snap`	логическое значение или None
`transform`	`Transform`
`url`	строка
`visible`	логическое значение
`zorder`	число с плавающей запятой

set_array(*args)[source]

Сохранено для обратной совместимости — используйте вместо этого set_data.

Parameters:

Aмассив-подобный объект

set_data(x, y, A)[source]

Установите сетку для границ прямоугольника и значения данных.

Параметры:

x, yОдномерный массив-подобный объект, необязательно

Монотонные массивы длины N+1 и M+1 соответственно, определяющие границы прямоугольника. Если не заданы, по умолчанию принимают значения range(N + 1) и range(M + 1) соответственно.

Aмассив-подобный объект

Данные, которые будут кодироваться цветом. Интерпретация зависит от формы:

(M, N) ndarray или массив с пропусками: значения, которые будут отображаться с помощью цветовой карты
(M, N, 3): массив RGB
(M, N, 4): массив RGBA

matplotlib.image.composite_images(images, renderer, magnification=1.0)[source]

Компонует несколько изображений RGBA в одно. Изображения компонуются в том порядке, в котором они появляются в списке images.

Параметры:

imagesсписок изображений: Каждый должен иметь метод make_image. Для каждого изображения can_composite должен возвращать True, хотя это не проверяется этой функцией. Каждое изображение должно иметь чисто аффинное преобразование без сдвига.
rendererRendererBase
magnificationвещественное число, по умолчанию: 1: Дополнительное масштабирование, применяемое к используемому рендереру.

Возвращаемые значения:

image(M, N, 4) numpy.uint8 массив: Компонованное изображение RGBA.
offset_x, offset_yвещественное число: Смещение (слева, снизу), где составленное изображение должно быть размещено на выходном рисунке.

matplotlib.image.imread(fname, format=None)[source]

Чтение изображения из файла в массив.

Примечание

Эта функция существует по историческим причинам. Рекомендуется использовать PIL.Image.open для загрузки изображений вместо неё.

Параметры:

fnameстрока или файл-подобный объект

Файл изображения для чтения: имя файла, URL или файл-подобный объект, открытый в режиме чтения в двоичном формате.

Передача URL устарела. Пожалуйста, откройте URL для чтения и передайте результат в Pillow, например, с помощью np.array(PIL.Image.open(urllib.request.urlopen(url))).

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

Предполагаемый формат файла изображения для чтения данных. Изображение загружается как файл PNG, если format установлено в "png", если fname — путь или открытый файл с расширением ".png", или если это URL. Во всех других случаях format игнорируется, и формат определяется автоматически PIL.Image.open.

Возвращаемые значения:

numpy.array

Данные изображения. Возвращаемый массив имеет форму:

(M, N) для черно-белых изображений.
(M, N, 3) для изображений RGB.
(M, N, 4) для изображений RGBA.

Изображения PNG возвращаются как массивы с плавающей точкой (0-1). Все остальные форматы возвращаются как массивы целых чисел с разрядностью, определяемой содержимым файла.

matplotlib.image.imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None, origin=None, dpi=100, *, metadata=None, pil_kwargs=None)[source]

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

RGB(A) изображения передаются без изменений. Изображения с одним каналом будут отображаться с помощью цветовой карты cmap и norm.

Примечание

Если вы хотите сохранить изображение с одним каналом в оттенках серого, используйте библиотеку ввода-вывода изображений (например, pillow, tifffile или imageio) напрямую.

Параметры:

fnameстрока или путь или файл-подобный объект: Путь или файл-подобный объект для хранения изображения. Если format не задан, формат вывода определяется по расширению fname, если оно есть, и из rcParams["savefig.format"] (по умолчанию: 'png') в противном случае. Если format задан, он определяет формат вывода.
arrмассив-подобный объект: Данные изображения. Форма может быть MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA).
vmin, vmaxвещественное число, необязательно: vmin и vmax задают масштабирование цвета для изображения, фиксируя значения, которые отображаются в пределах цветов цветовой карты. Если vmin или vmax равно None, этот предел определяется минимальным/максимальным значением в arr.
cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis'): Экземпляр цветовой карты или зарегистрированное имя цветовой карты. Цветовая карта отображает скалярные данные в цвета. Она игнорируется для RGB(A) данных.
formatстрока, необязательно: Формат файла, например, 'png', 'pdf', 'svg', ... Поведение, когда это не установлено, описано в разделе fname.
origin{'верхний', 'нижний'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper'): Указывает, находится ли индекс (0, 0) массива в верхнем левом или нижнем левом углу осей.
dpiвещественное число: DPI, которое следует сохранить в метаданных файла. Это не влияет на разрешение выходного изображения. В зависимости от формата файла, это может быть округлено до ближайшего целого числа.
metadataсловарь, необязательно: Метаданные в файле изображения. Поддерживаемые ключи зависят от формата вывода, см. документацию соответствующих бэкэндов для получения дополнительной информации. В настоящее время поддерживаются только для "png", "pdf", "ps", "eps" и "svg".
pil_kwargsсловарь, необязательно: Ключевые аргументы, передаваемые в 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 или file-like: Файл изображения. Matplotlib полагается на библиотеку Pillow для чтения изображений и, следовательно, поддерживает широкий спектр форматов файлов, включая PNG, JPG, TIFF и другие.
thumbfilestr или file-like: Имя файла миниатюры.
scalefloat, по умолчанию: 0.1: Коэффициент масштабирования для миниатюры.
interpolationstr, по умолчанию: 'bilinear': Схема интерполяции, используемая при ресемплировании. См. параметр interpolation функции imshow для возможных значений.
previewbool, по умолчанию: False: Если True, используется стандартный бэкэнд (предположительно бэкэнд пользовательского интерфейса), что приведет к отображению фигуры, если вызов show. Если False, фигура создается с помощью FigureCanvasBase, а бэкэнд отрисовки выбирается так же, как и в случае с Figure.savefig.

Возвращает:

Figure: Экземпляр фигуры, содержащий миниатюру.