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.
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, ресемплирование выполняется только тогда, когда выходное изображение больше входного изображения.
**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: Аффинное преобразование из пространства изображения в пространство пикселей.

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`	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	число или двумерный массив-подобный объект или None
`animated`	логическое значение
`array`	массив-подобный объект
`clim`	(vmin: число, vmax: число)
`clip_box`	`BboxBase` или None
`clip_on`	логическое значение
`clip_path`	Объект Patch или (Путь, Преобразование) или 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: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
`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`	число с плавающей точкой или двумерный массив-подобный объект или None
`animated`	булево значение
`array`	массив-подобный объект
`clim`	(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
`clip_box`	`BboxBase` или None
`clip_on`	булево значение
`clip_path`	объект Patch или (Path, Transform) или 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`	(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
`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.

Returns:

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`	функция фильтра, которая принимает массив (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`	неизвестно
`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_cursor_data(event)[source]

Return the image value at the event position or None if the event is outside the image.

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

Примечания

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

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

Bases: AxesImage

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

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

Parameters:

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')

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

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, изображение не будет масштабироваться, но вместо этого будет возвращена подходящая аффинная трансформация.

Returns:

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

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

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

Свойство	Описание
`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 или (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`	(масштаб: число, длина: число, случайность: число)
`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{'upper', 'lower'}, по умолчанию: 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 целых чисел.

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

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 или файлоподобный объект: Файл изображения. Matplotlib использует библиотеку Pillow для чтения изображений, поэтому поддерживает широкий спектр форматов файлов, включая PNG, JPG, TIFF и другие.
thumbfilestr или файлоподобный объект: Имя файла миниатюры.
scalefloat, по умолчанию: 0.1: Коэффициент масштабирования для миниатюры.
interpolationstr, по умолчанию: 'bilinear': Схема интерполяции, используемая при ресемплировании. См. параметр interpolation в imshow для возможных значений.
previewbool, по умолчанию: False: Если True, будет использоваться стандартный бэкэнд (вероятно, бэкэнд пользовательского интерфейса), что приведет к отображению фигуры, если будет вызван show. Если False, фигура создается с помощью FigureCanvasBase, а бэкэнд рисования выбирается так же, как это обычно делает Figure.savefig.

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

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