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: matplotlib.image._ImageBase

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

Параметры

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

Параметры

normmatplotlib.colors.Normalize (или подкласс): Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если 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]

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

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

Подклассы должны переопределять для включения в расчет области "tight". По умолчанию возвращается пустая область ограничивающей рамки в (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>, 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` или str или None
`data`	массив-подобный объект или `PIL.Image.Image`
`extent`	кортеж из 4 чисел с плавающей точкой
`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`	объект
`norm`	`Normalize` или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или число с плавающей точкой или вызываемый объект
`rasterized`	bool
`resample`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	число с плавающей точкой

set_extent(extent)[source]

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

Параметры

extentкортеж из 4 чисел с плавающей точкой: Положение и размер изображения как кортеж (left, right, bottom, top) в координатах данных.

Примечания

Это обновляет 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]

Bases: matplotlib.image._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>, 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`	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`	объект
`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: matplotlib.image._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.

Возвращает

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>, 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: число, vmax: число)
`clip_box`	`Bbox`
`clip_on`	булево значение
`clip_path`	объект Patch или (Path, Transform) или 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`	объект
`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: matplotlib.image.AxesImage

Parameters

interpolation{'nearest', 'bilinear'}, default: 'nearest'
**kwargs: Все остальные ключевые параметры идентичны параметрам AxesImage.

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

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

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

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

Возвращает

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

mouseover=False

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

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

Свойство	Описание
`agg_filter`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
`alpha`	float или 2D массив-подобный объект или 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-кортеж float
`figure`	`Figure`
`filternorm`	неизвестно
`filterrad`	неизвестно
`gid`	str
`in_layout`	bool
`interpolation`	{'nearest', 'bilinear'} или None
`interpolation_stage`	{'data', 'rgba'} или None
`label`	объект
`norm`	неизвестно
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`rasterized`	bool
`resample`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`transform`	`Transform`
`url`	str
`visible`	bool
`zorder`	float

set_array(*args)[source]

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

Параметры

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

set_cmap(cmap)[source]

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

Параметры

cmapColormap или str или None

set_data(x, y, A)[source]

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

Параметры

x, yОдномерный массив-подобный объект: Монотонные массивы форм (N,) и (M,), соответственно, определяющие центры пикселей.
AМассив-подобный объект: (M, N) массив NumPy или массив с маской значений для цветового кодирования, или (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 или None

Примечания

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

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

Наследуется от matplotlib.image.AxesImage

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

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

Параметры

axAxes

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

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

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

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

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

(M, N) массив NumPy или массив с маской: значения для цветового кодирования
(M, N, 3): RGB массив
(M, N, 4): RGBA массив

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

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

normNormalize

Преобразует яркость в диапазон 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`	float или 2D массив-подобный объект или 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`	неизвестно
`extent`	кортеж из 4 значений с плавающей точкой
`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`	объект
`norm`	`Normalize` или None
`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`	float

set_array(*args)[source]

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

Parameters

Aarray-like

set_data(x, y, A)[source]

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

Параметры

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

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

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

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

(M, N) массив NumPy или массив с пропусками: значения для цветовой схемы
(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строка, необязательно

Предполагаемый формат файла изображения для чтения данных. Если format установлен в «png», изображение загружается как 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]

Сохранение массива как файла изображения.

Параметры

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{'upper', 'lower'}, по умолчанию: 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-изображений.

END_OF_DOCUMENT_MARKER

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: Экземпляр фигуры, содержащий миниатюру.