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

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

Параметры:

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

Параметры:

normNormalize (или подкласс) или строка или None: Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если строка, динамически генерируется подкласс Normalize на основе масштаба с соответствующим именем. Если None, norm по умолчанию равен объекту colors.Normalize, который инициализирует своё масштабирование на основе первой обработанной порции данных.
cmapстрока или 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) 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`	`Bbox`
`clip_on`	логическое значение
`clip_path`	Объект Patch или (объект Path, Преобразование) или 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) массив 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`	функция фильтра, которая принимает массив чисел с плавающей точкой размера (m, n, 3) и значение dpi, и возвращает массив чисел с плавающей точкой размера (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	число с плавающей точкой или 2D массив или None
`animated`	bool
`array`	массив
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`data`	массив или `PIL.Image.Image`
`figure`	`Figure`
`filternorm`	bool
`filterrad`	положительное число с плавающей точкой
`gid`	строка
`in_layout`	bool
`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`	bool
`norm`	`Normalize` или строка или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или число с плавающей точкой или вызываемая функция
`rasterized`	bool
`resample`	bool или None
`sketch_params`	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`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, изображение не будет масштабироваться, а вместо этого будет возвращена соответствующая аффинная трансформация.

Returns:

image(M, N, 4) 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`	bool
`array`	массив-подобный объект
`clim`	(vmin: float, vmax: float)
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`data`	неизвестно
`figure`	`Figure`
`filternorm`	bool
`filterrad`	положительное число с плавающей точкой
`gid`	строка
`in_layout`	bool
`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`	bool
`norm`	`Normalize` или строка или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или число с плавающей точкой или вызываемая функция
`rasterized`	bool
`resample`	bool или None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	число с плавающей точкой

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

zorder=0

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

Bases: AxesImage

Parameters:

axAxes: Оси, к которым будет принадлежать изображение.
interpolation{'nearest', 'bilinear'}, default: 'nearest': Схема интерполяции, используемая при повторном выборочном отборе.
**kwargs: Все остальные ключевые параметры идентичны параметрам AxesImage.

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

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

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

Возвращает:

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

mouseover=False

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

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

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

set_array(*args)[source]

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

Параметры:

Aмассив

set_cmap(cmap)[source]

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

Параметры:

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(s)[source]

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

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

Параметры:

filternormbool

set_filterrad(s)[source]

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

Параметры:

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

set_interpolation(s)[source]

Параметры:

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

set_norm(norm)[source]

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

Параметры:

normNormalize или str или None

Примечания

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

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

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

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

normстрока или 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) массив uint8: Изображение RGBA, повторно масштабированное, если unsampled равно True.
x, yчисло с плавающей точкой: Левый верхний угол, где должно быть нарисовано изображение, в пространстве пикселей.
transAffine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив float (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	число с плавающей точкой или двумерный массив-подобный объект или None
`animated`	булево значение
`array`	неизвестно
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	Объект Patch или (Path, Transform) или None
`cmap`	`Colormap` или строка или None
`data`	неизвестно
`extent`	четверки чисел с плавающей точкой
`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_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массив uint8 (M, N, 4): Объединённое изображение 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словарь, необязательно: Метаданные в файле изображения. Поддерживаемые ключи зависят от формата вывода, см. документацию соответствующих бэкэндов для получения дополнительной информации.
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: Экземпляр фигуры, содержащий миниатюру.