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Изображение, прикреплённое к оси.
- Параметры:
-
-
ax
Axes -
Ось, к которой будет принадлежать изображение.
-
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, ресемплирование выполняется только если выходное изображение больше входного изображения.
-
**kwargs
Artistсвойства
-
ax
- Параметры:
-
-
norm
Normalize(или подкласс) или строка или None -
Объект нормализации, который масштабирует данные, обычно в интервал
[0, 1]. Если строка, динамически генерируется подклассNormalizeв соответствии с именем масштаба. Если None, norm по умолчанию устанавливается как объект colors.Normalize, который инициализирует масштабирование на основе первых обрабатываемых данных. -
cmapстрока или
Colormap -
Цветовая карта, используемая для сопоставления нормализованных значений данных с RGBA цветами.
-
norm
- get_cursor_data(event)[source]
-
Возвращает значение изображения в позиции указателя или None, если указатель находится вне изображения.
См. также
- 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
-
Аффинная трансформация из пространства изображения в пространство пикселей.
- 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]
-
Установить несколько свойств сразу.
Поддерживаемые свойства:
Свойство
Описание
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, а возвращает массив (m, n, 3) и два смещения от левого нижнего угла изображения
alphaчисловой float или двумерный массив-подобный объект или None
bool
arrayмассив-подобный объект
(vmin: float, vmax: float)
bool
Объект Patch или (Path, Transform) или None
Colormapили строка или Nonedataмассив-подобный объект или
PIL.Image.Imageкортеж из 4 чисел с плавающей точкой
filternormbool
filterradположительное число с плавающей точкой
строка
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
объект
bool
Normalizeили строка или NoneNone или bool или число с плавающей точкой или вызываемая функция
bool
resamplebool или None
(scale: float, length: float, randomness: float)
bool или None
строка
bool
число с плавающей точкой
- 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]
-
Устанавливает сразу несколько свойств.
Поддерживаемые свойства:
Свойство
Описание
функция фильтра, которая принимает массив чисел с плавающей точкой (m, n, 3) и значение dpi, а возвращает массив чисел с плавающей точкой (m, n, 3) и два смещения от нижнего левого угла изображения
alphaчисло с плавающей точкой или двумерный массив или None
логическое значение
arrayмассив
(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
логическое значение
Объект Patch или (Path, Transform) или None
Colormapили строка или Nonedataмассив или
PIL.Image.Imagefilternormлогическое значение
filterradположительное число с плавающей точкой
строка
логическое значение
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
объект
логическое значение
Normalizeили строка или NoneNone или логическое значение или число с плавающей точкой или вызываемая функция
логическое значение
resampleлогическое значение или None
(scale: число с плавающей точкой, length: число с плавающей точкой, randomness: число с плавающей точкой)
логическое значение или None
строка
логическое значение
число с плавающей точкой
- 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]
-
Установка нескольких свойств сразу.
Поддерживаемые свойства:
Свойство
Описание
функция фильтра, которая принимает (m, n, 3) массив чисел с плавающей точкой и значение dpi, и возвращает (m, n, 3) массив и два смещения от нижнего левого угла изображения
alphaчисло с плавающей точкой или 2D массив или None
булево значение
arrayмассив-подобный объект
(vmin: число с плавающей точкой, vmax: число с плавающей точкой)
булево значение
объект Patch или (Path, Transform) или None
Colormapили строка или Noneнеизвестно
filternormбулево значение
filterradположительное число с плавающей точкой
строка
булево значение
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
объект
булево значение
Normalizeили строка или NoneNone или булево значение или число с плавающей точкой или вызываемая функция
булево значение
resampleбулево значение или None
(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
булево значение или None
строка
булево значение
число с плавающей точкой
- 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]
-
Установить сразу несколько свойств.
Поддерживаемые свойства:
Свойство
Описание
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alphaчисло или 2D-подобный массив или None
bool
arrayнеизвестно
(vmin: число, vmax: число)
bool
Объект Patch или (Path, Transform) или None
неизвестно
неизвестно
4-кортеж чисел с плавающей точкой
filternormнеизвестно
filterradнеизвестно
строка
bool
{'ближайший', 'билинейный'} или None
interpolation_stage{'данные', 'rgba'} или None
объект
bool
неизвестно
None или bool или число с плавающей точкой или вызываемая функция
bool
resamplebool или None
(масштаб: число, длина: число, случайность: число)
bool или None
строка
bool
число с плавающей точкой
- set_array(*args)[source]
-
Сохранено для обратной совместимости — используйте set_data вместо этого.
- Parameters:
-
- Aподобный массиву
- set_cmap(cmap)[source]
-
Установить цветовую карту для данных яркости.
- Parameters:
-
-
cmap
Colormapили строка или None
-
cmap
- 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]
-
Установите экземпляр нормализации.
- Параметры:
-
-
norm
Normalizeили str или None
-
norm
Примечания
Если какие-либо цветовые шкалы используют отображаемое значение для этой нормализации, установка нормализации отображаемого значения сбросит нормализации, локатор и форматеры цветовой шкалы по умолчанию.
- classmatplotlib.image.PcolorImage(ax, x=None, y=None, A=None, *, cmap=None, norm=None, **kwargs)[source]
-
Основывается на
AxesImageСоздайте график типа pcolor с нерегулярной прямоугольной сеткой.
Это использует модификацию исходного кода нерегулярных изображений, и используется pcolorfast для соответствующего типа сетки.
- Параметры:
-
-
ax
Axes -
Ось, к которой будет принадлежать изображение.
- 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.
-
**kwargs
Artistсвойства
-
ax
- get_cursor_data(event)[source]
-
Возвращает значение изображения в позиции события или None, если событие находится вне изображения.
См. также
- 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]
-
Установить сразу несколько свойств.
Поддерживаются следующие свойства
Свойство
Описание
Функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
alphafloat или 2D массив-подобный объект или None
bool
arrayнеизвестно
(vmin: float, vmax: float)
bool
Объект Patch или (Path, Transform) или None
Colormapили str или Noneнеизвестно
4-кортеж float
filternormbool
filterradположительное число с плавающей точкой
строка
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
объект
bool
Normalizeили строка или NoneNone или bool или float или вызываемый объект
bool
resamplebool или None
(scale: float, length: float, randomness: float)
bool или None
строка
bool
число с плавающей точкой
- 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, хотя это не проверяется этой функцией. Каждое изображение должно иметь чистое аффинное преобразование без сдвига. -
renderer
RendererBase - 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