Spec-Zone.ru › Matplotlib 3.6

matplotlib.image

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

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

Bases: _ImageBase

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

Параметры:
axAxes

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

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

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

normstr или Normalize

Преобразует яркость в диапазон 0-1.

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

Допустимые значения: 'none', 'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'.

interpolation_stage{'data', 'rgba'}, по умолчанию: 'data'

Если 'data', интерполяция выполняется над данными, предоставленными пользователем. Если 'rgba', интерполяция выполняется после применения цветовой карты (визуальная интерполяция).

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

Размещает индекс [0, 0] массива в верхнем левом или нижнем левом углу осей. Конвенция 'upper' обычно используется для матриц и изображений.

extentкортеж, необязательно

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

filternormbool, по умолчанию: True

Параметр фильтра масштабирования изображений (см. документацию антиграйн). Если 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

функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения

alpha

числовой float или двумерный массив-подобный объект или 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

массив-подобный объект или 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

объект

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_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: _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

число с плавающей точкой или двумерный массив или None

animated

логическое значение

array

массив

clim

(vmin: число с плавающей точкой, vmax: число с плавающей точкой)

clip_box

Bbox

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.

Если 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

функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения

alpha

число с плавающей точкой или 2D массив или 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

объект

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:
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
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

число или 2D-подобный массив или None

animated

bool

array

неизвестно

clim

(vmin: число, vmax: число)

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

{'ближайший', 'билинейный'} или None

interpolation_stage

{'данные', 'rgba'} или None

label

объект

mouseover

bool

norm

неизвестно

path_effects

AbstractPathEffect

picker

None или bool или число с плавающей точкой или вызываемая функция

rasterized

bool

resample

bool или None

sketch_params

(масштаб: число, длина: число, случайность: число)

snap

bool или None

transform

Transform

url

строка

visible

bool

zorder

число с плавающей точкой

set_array(*args)[source]

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

Parameters:
Aподобный массиву
set_cmap(cmap)[source]

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

Parameters:
cmapColormap или строка или 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 или 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) массив NumPy или массив с пропускаемыми значениями: значения для сопоставления с цветовой палитрой
  • (M, N, 3): массив RGB
  • (M, N, 4): массив RGBA
cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis')

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

normstr или Normalize

Преобразует яркость в диапазон 0-1.

**kwargsArtist свойства
get_cursor_data(event)[source]

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

См. также

matplotlib.artist.Artist.get_cursor_data
make_image(renderer, magnification=1.0, unsampled=False)[source]

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

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

Возвращает:
image(M, N, 4) массив 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

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 или str или None

data

неизвестно

extent

4-кортеж float

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 или 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 вместо него.

Parameters:
Aмассив-подобный объект
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
magnificationfloat, по умолчанию: 1

Дополнительное увеличение для применения к используемому рендереру.

Возвращает:
imageмассив uint8 (M, N, 4)

Компонованное изображение RGBA.

offset_x, offset_yfloat

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

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]

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

Параметры:
fnameстрока или объект пути или файлоподобный объект

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

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

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

vmin, vmaxfloat, необязательно

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) массива в верхнем левом или нижнем левом углу осей.

dpifloat

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

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

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

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

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

© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.6.0/api/image_api.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API