matplotlib.image

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

classmatplotlib.image.AxesImage(ax, *, cmap=None, norm=None, colorizer=None, interpolation=None, origin=None, extent=None, filternorm=True, filterrad=4.0, resample=False, interpolation_stage=None, **kwargs)[исходный код]

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

Изображение с пикселями на регулярной сетке, связанное с объектом Axes.

Параметры:

axAxes

Объект Axes, которому будет принадлежать изображение.

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

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

normstr или Normalize

Отображает яркость в диапазоне от 0 до 1.

interpolationstr, по умолчанию: rcParams["image.interpolation"] (по умолчанию: 'auto')

Поддерживаемые значения: 'none', 'auto', '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

Параметр фильтра изменения размера изображений antigrain (см. документацию antigrain). Если filternorm задан, фильтр нормализует целочисленные значения и корректирует ошибки округления. Он не влияет на исходные значения с плавающей запятой, а корректирует только целые числа согласно правилу 1.0, которое означает, что сумма любых весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна создавать график правильной формы.

filterradfloat > 0, по умолчанию: 4

Радиус фильтра для фильтров с параметром радиуса, то есть когда интерполяция имеет одно из значений: 'sinc', 'lanczos' или 'blackman'.

resamplebool, по умолчанию: False

Если True, используется полный метод повторной выборки. Если False, повторная выборка выполняется только тогда, когда выходное изображение больше входного.

**kwargsсвойства Artist

Параметры:

colorizercolorizer.Colorizer

get_cursor_data(event)[исходный код]

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

См. также

matplotlib.artist.Artist.get_cursor_data

get_extent()[исходный код]

Возвращает границы изображения в виде кортежа (слева, справа, снизу, сверху).

get_window_extent(renderer=None)[исходный код]

Возвращает ограничивающую рамку объекта Artist в пространстве отображения.

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

Для включения объекта в расчёт ограничивающей рамки «tight» подклассы должны переопределять этот метод. По умолчанию возвращается пустая ограничивающая рамка в точке 0, 0.

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

make_image(renderer, magnification=1.0, unsampled=False)[исходный код]

Нормализует, масштабирует и применяет цветовую карту к данным этого изображения для отрисовки с помощью 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>)[исходный код]

Задаёт несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
alpha	float, массивоподобный объект размерности 2 или None
animated	bool
array	массивоподобный объект
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch, (Path, Transform) или None
cmap	Colormap, str или None
data	массивоподобный объект или PIL.Image.Image
extent	кортеж из 4 значений float
figure	Figure или SubFigure
filternorm	bool
filterrad	положительное значение float
gid	str
in_layout	bool
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
interpolation_stage	{'data', 'rgba', 'auto'} или None
label	объект
mouseover	bool
norm	Normalize, str или 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	str
visible	bool
zorder	float

set_extent(extent, **kwargs)[исходный код]

Задаёт границы изображения.

Параметры:

extentкортеж из 4 значений float

Положение и размер изображения в виде кортежа (left, right, bottom, top) в координатах данных.

**kwargs

Другие параметры, из которых применяются сведения о единицах измерения (то есть записи xunits, yunits, zunits (для 3D Axes), runits и thetaunits (для полярных Axes), если они присутствуют).

Примечания

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

classmatplotlib.image.BboxImage(bbox, *, cmap=None, norm=None, colorizer=None, interpolation=None, origin=None, filternorm=True, filterrad=4.0, resample=False, **kwargs)[исходный код]

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

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

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

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

contains(mouseevent)[исходный код]

Проверяет, произошло ли событие мыши внутри изображения.

get_window_extent(renderer=None)[исходный код]

Возвращает ограничивающую рамку объекта Artist в координатах области отображения.

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

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

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

make_image(renderer, magnification=1.0, unsampled=False)[исходный код]

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

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

Возвращает:

image(M, N, 4) numpy.uint8 array

Изображение 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>)[исходный код]

Одновременно задает несколько свойств.

Поддерживаются следующие свойства:

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

classmatplotlib.image.FigureImage(fig, *, cmap=None, norm=None, colorizer=None, offsetx=0, offsety=0, origin=None, **kwargs)[исходный код]

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

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

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

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

get_extent()[исходный код]

Возвращает границы изображения в виде кортежа (left, right, bottom, top).

make_image(renderer, magnification=1.0, unsampled=False)[исходный код]

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

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

Возвращает:

image(M, N, 4) numpy.uint8 array

Изображение 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>)[исходный код]

Одновременно задает несколько свойств.

Поддерживаются следующие свойства:

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

set_data(A)[исходный код]

Задает массив изображения.

zorder=0

classmatplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs)[исходный код]

Базовые классы: AxesImage

Изображение с пикселями на прямолинейной сетке.

В отличие от AxesImage, где пиксели расположены на регулярной сетке, NonUniformImage позволяет задавать индивидуальную высоту строк и ширину столбцов.

См. также Изображение на неравномерной сетке.

Параметры:

axAxes

Объект Axes, которому будет принадлежать изображение.

interpolation{'nearest', 'bilinear'}, по умолчанию: 'nearest'

Метод интерполяции, используемый при передискретизации.

**kwargs

Все остальные именованные аргументы идентичны аргументам AxesImage.

get_cursor_data(event)[исходный код]

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

См. также

matplotlib.artist.Artist.get_cursor_data

get_extent()[исходный код]

Возвращает границы изображения в виде кортежа (left, right, bottom, top).

make_image(renderer, magnification=1.0, unsampled=False)[исходный код]

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

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

Возвращает:

image(M, N, 4) numpy.uint8 array

Изображение 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>)[исходный код]

Задаёт несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
agg_filter	функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
alpha	float или массивоподобный объект 2D или None
animated	bool
array	неизвестно
clim	(vmin: float, vmax: float)
clip_box	BboxBase или None
clip_on	bool
clip_path	Patch или (Path, Transform) или None
cmap	неизвестно
data	неизвестно
extent	кортеж из 4 значений float
figure	Figure или SubFigure
filternorm	неизвестно
filterrad	неизвестно
gid	str
in_layout	bool
interpolation	{'nearest', 'bilinear'} или None
interpolation_stage	{'data', 'rgba', 'auto'} или None
label	object
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	str
visible	bool
zorder	float

set_array(*args)[исходный код]

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

Параметры:

Aarray-like

set_cmap(cmap)[исходный код]

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

Параметры:

cmapColormap или str или None

set_data(x, y, A)[исходный код]

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

Параметры:

x, y1D array-like

Монотонные массивы форм (N,) и (M,) соответственно, задающие центры пикселей.

Aarray-like

(M, N) ndarray или маскированный массив значений для применения цветовой карты, либо массив RGB формы (M, N, 3), либо массив RGBA формы (M, N, 4).

set_filternorm(filternorm)[исходный код]

Задаёт, нормализует ли фильтр изменения размера веса.

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

Параметры:

filternormbool

set_filterrad(filterrad)[исходный код]

Задаёт радиус фильтра изменения размера; применимо только к некоторым методам интерполяции — см. справку для imshow.

Параметры:

filterradположительное значение float

set_interpolation(s)[исходный код]

Параметры:

s{'nearest', 'bilinear'} или None

Если значение равно None, используется rcParams["image.interpolation"] (по умолчанию: 'auto').

set_norm(norm)[исходный код]

Задаёт экземпляр нормализации.

Параметры:

normNormalize или str или None

Примечания

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

classmatplotlib.image.PcolorImage(ax, x=None, y=None, A=None, *, cmap=None, norm=None, colorizer=None, **kwargs)[исходный код]

Базовые классы: AxesImage

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

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

Параметры:

axAxes

Объект Axes, которому будет принадлежать изображение.

x, y1D-подобный массив, необязательный

Монотонные массивы длины 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.

**kwargsсвойства Artist

get_cursor_data(event)[исходный код]

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

См. также

matplotlib.artist.Artist.get_cursor_data

make_image(renderer, magnification=1.0, unsampled=False)[исходный код]

Нормализует, масштабирует и применяет цветовую карту к данным этого изображения для отрисовки с помощью 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>, 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>)[исходный код]

Задаёт несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
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	неизвестно
extent	кортеж из 4 вещественных чисел
figure	Figure или SubFigure
filternorm	логическое значение
filterrad	положительное вещественное число
gid	строка
in_layout	логическое значение
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} или None
interpolation_stage	{'data', 'rgba', 'auto'} или 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_array(*args)[исходный код]

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

Параметры:

Aподобный массив

set_data(x, y, A)[исходный код]

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

Параметры:

x, y1D-подобный массив, необязательный

Монотонные массивы длины 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)[исходный код]

Объединяет несколько изображений 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)[исходный код]

Считывает изображение из файла в массив.

Примечание

Эта функция существует по историческим причинам. Для загрузки изображений рекомендуется вместо неё использовать 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)[исходный код]

Применяет цветовую карту к массиву и сохраняет его как файл изображения.

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

Примечание

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

Параметры:

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

Путь или файловый объект, в который следует сохранить изображение. Если параметр format не задан, выходной формат определяется по расширению fname, если оно есть, а в противном случае — по rcParams["savefig.format"] (значение по умолчанию: 'png'). Если параметр format задан, он определяет выходной формат.

arrподобный массив

Данные изображения. Принимаются массивы NumPy или последовательности (например, списки или кортежи). Форма может быть MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA).

vmin, vmaxвещественное число, необязательный

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

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

Экземпляр Colormap или имя зарегистрированной цветовой карты. Цветовая карта преобразует скалярные данные в цвета. Для данных RGB(A) этот параметр игнорируется.

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

Формат файла, например 'png', 'pdf', 'svg' и т. д. Поведение при отсутствии этого параметра описано в разделе fname.

origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (значение по умолчанию: 'upper')

Определяет, находится ли индекс (0, 0) массива в верхнем левом или нижнем левом углу Axes.

dpiвещественное число

Значение DPI, сохраняемое в метаданных файла. Оно не влияет на разрешение выходного изображения. В зависимости от формата файла значение может быть округлено до ближайшего целого.

metadataсловарь, необязательный

Метаданные файла изображения. Поддерживаемые ключи зависят от выходного формата; дополнительную информацию см. в документации соответствующих серверных модулей. В настоящее время поддерживаются только форматы "png", "pdf", "ps", "eps" и "svg".

pil_kwargsсловарь, необязательный

Именованные аргументы, передаваемые в PIL.Image.Image.save. Если присутствует ключ 'pnginfo', он полностью заменяет metadata, включая ключ 'Software', используемый по умолчанию.

matplotlib.image.pil_to_array(pilImage)[исходный код]

Загружает изображение 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)[исходный код]

Создает миниатюру изображения из infile с выходным именем файла thumbfile.

См. Миниатюра изображения.

Параметры:

infileстрока или файловый объект

Файл изображения. Для чтения изображений Matplotlib использует Pillow и поэтому поддерживает широкий спектр форматов файлов, включая PNG, JPG, TIFF и другие.

thumbfileстрока или файловый объект

Имя файла миниатюры.

scaleчисло с плавающей точкой, по умолчанию: 0.1

Коэффициент масштабирования миниатюры.

interpolationстрока, по умолчанию: 'bilinear'

Метод интерполяции, используемый при передискретизации. Возможные значения см. в параметре interpolation метода imshow.

previewлогическое значение, по умолчанию: False

Если значение равно True, будет использоваться бэкенд по умолчанию (предположительно, бэкенд пользовательского интерфейса), который откроет окно с рисунком при вызове show. Если значение равно False, рисунок создается с помощью FigureCanvasBase, а бэкенд отрисовки выбирается так же, как это обычно делает Figure.savefig.

Возвращает:

Figure

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