Spec-Zone.ru › Matplotlib 3.2

matplotlib.image

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

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

Базы: matplotlib.image._ImageBase

Параметры:
axAxes

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

cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')

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

normNormalize

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

interpolationstr, default: rcParams["image.interpolation"] (default: 'antialiased')

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

origin{'upper', 'lower'}, default: rcParams["image.origin"] (default: 'upper')

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

extenttuple, optional

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

filternormbool, default: True

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

filterradfloat > 0, default: 4

Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция — 'sinc', 'lanczos' или 'blackman'.

resamplebool, default: False

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

**kwargsArtist properties
Параметры:
normmatplotlib.colors.Normalize instance

Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если None, norm по умолчанию — объект colors.Normalize, который инициализирует масштабирование на основе первой обработанной данных.

cmapstr or Colormap instance

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

format_cursor_data(self, data) [source]

Возвращает строковое представление data.

Примечание

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

По умолчанию реализация преобразует целые и плавающие числа и массивы целых и плавающих чисел в строку, разделенную запятыми и заключённую в квадратные скобки.

См. также

get_cursor_data
get_cursor_data(self, event) [source]

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

См. также

matplotlib.artist.Artist.get_cursor_data
get_extent(self) [source]

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

get_window_extent(self, renderer=None) [source]

Возвращает прямоугольник осей в пространстве отображения.

Ширина и высота прямоугольника неотрицательны.

Подклассы должны переопределить для включения в вычисление "плотного" прямоугольника. По умолчанию возвращает пустой прямоугольник в координатах 0, 0.

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

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

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

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

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

Изображение RGBA, масштабированное, если unsampled не True.

x, yfloat

Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей.

transAffine2D

Аффинная трансформация из пространства изображения в пространство пикселей.

set_extent(self, extent) [source]

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

Параметры:
extent4-tuple of float

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

Примечания

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

class matplotlib.image.BboxImage(bbox, cmap=None, norm=None, interpolation=None, origin=None, filternorm=1, filterrad=4.0, resample=False, interp_at_native=<deprecated parameter>, **kwargs) [source]

Базы: matplotlib.image._ImageBase

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

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

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

contains(self, mouseevent) [source]

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

get_transform(self) [source]

Возвращает экземпляр Transform, используемый этим элементом.

get_window_extent(self, renderer=None) [source]

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

Ширина и высота прямоугольника неотрицательны.

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

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

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

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

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

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

Изображение RGBA, с ресемплированием, если unsampled не равно True.

x, yfloat

Верхний левый угол, где должно быть нарисовано изображение, в пространстве пикселей.

transAffine2D

Аффинное преобразование из пространства изображения в пространство пикселей.

class matplotlib.image.FigureImage(fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs) [source]

Базы: matplotlib.image._ImageBase

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

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

get_extent(self) [source]

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

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

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

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

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

Изображение RGBA, с ресемплированием, если unsampled не равно True.

x, yfloat

Верхний левый угол, где должно быть нарисовано изображение, в пространстве пикселей.

transAffine2D

Аффинное преобразование из пространства изображения в пространство пикселей.

set_data(self, A) [source]

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

zorder = 0
class matplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs) [source]

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

Параметры:
interpolation{'nearest', 'bilinear'}
**kwargs

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

get_extent(self) [source]

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

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

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

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

Возвращаемое значение:
image(M, N, 4) uint8 array

Изображение в формате RGBA, масштабированное, если unsampled не равно True.

x, yfloat

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

transAffine2D

Аффинная трансформация из пространства изображения в пространство пикселей.

set_array(self, *args) [source]

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

Параметры:
Aarray-like
set_cmap(self, cmap) [source]

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

Параметры:
cmapcolormap or registered colormap name
set_data(self, x, y, A) [source]

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

Параметры:
x, y1D array-likes

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

Aarray-like

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

set_filternorm(self, s) [source]

Устанавливает, будет ли масштабирующий фильтр нормализовывать веса.

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

Параметры:
filternormbool
set_filterrad(self, s) [source]

Устанавливает радиус фильтра масштабирования, применимый только к некоторым схемам интерполяции — см. справку для imshow

Параметры:
filterradpositive float
set_interpolation(self, s) [source]
Параметры:
sstr, None

Либо 'nearest', 'bilinear', или None.

set_norm(self, norm) [source]

Устанавливает экземпляр нормализации.

Параметры:
normNormalize

Примечания

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

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

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

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

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

cmap по умолчанию устанавливается из rc настроек

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

Дополнительные ключевые аргументы — свойства matplotlib.artist

get_cursor_data(self, event) [source]

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

См. также

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

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

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

Возвращаемое значение:
image(M, N, 4) uint8 array

Изображение в формате RGBA, масштабированное, если unsampled не равно True.

x, yfloat

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

transAffine2D

Аффинная трансформация из пространства изображения в пространство пикселей.

set_array(self, *args) [source]

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

Параметры:
Aarray-like
set_data(self, x, y, A) [source]

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

Параметры:
x, y1D array-likes or None

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

Aarray-like

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

matplotlib.image.composite_images(images, renderer, magnification=1.0) [source]

Компонует несколько изображений RGBA в одно. Изображения компонуются в том порядке, в котором они появляются в списке images.

Параметры:
imageslist of Images

Каждый должен иметь метод make_image. Для каждого изображения, метод can_composite должен возвращать True, хотя это не проверяется данной функцией. Каждое изображение должно иметь чисто аффинное преобразование без сдвига.

rendererRendererBase instance
magnificationfloat

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

Возвращает:
tupleimage, offset_x, offset_y

Возвращает кортеж:

  • image: Массив NumPy того же типа, что и входные изображения.
  • offset_x, offset_y: Смещение изображения (слева, снизу) на выходном графике.
matplotlib.image.imread(fname, format=None) [source]

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

Параметры:
fnamestr or file-like

Файл изображения для чтения: имя файла, URL-адрес или объект файла, открытый в режиме чтения в двоичном формате.

formatstr, optional

Предполагаемый формат файла изображения для чтения данных. Если не задано, формат определяется из имени файла. Если ничего не может быть выведено, используется PNG.

Возвращает:
imagedatanumpy.array

Данные изображения. Возвращаемый массив имеет форму:

  • (M, N) для градационных изображений.
  • (M, N, 3) для изображений RGB.
  • (M, N, 4) для изображений RGBA.

Примечания

Matplotlib может читать только PNG-файлы напрямую. Другие форматы изображений поддерживаются с помощью необязательной зависимости Pillow. Обратите внимание, что строки URL несовместимы с Pillow. См. документацию Pillow для получения дополнительной информации.

matplotlib.image.imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None, origin=None, dpi=100, *, metadata=None, pil_kwargs=None) [source]

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

Параметры:
fnamestr or PathLike or file-like

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

arrarray-like

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

vmin, vmaxscalar, optional

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

cmapstr or Colormap, optional

Экземпляр цветовой карты Colormap или зарегистрированное имя цветовой карты. Цветовая карта отображает скалярные данные в цвета. Игнорируется для данных RGB(A). По умолчанию rcParams["image.cmap"] (по умолчанию: 'viridis') ('viridis').

formatstr, optional

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

origin{'upper', 'lower'}, optional

Указывает, находится ли (0, 0) индекс массива в верхнем левом или нижнем левом углу осей. По умолчанию rcParams["image.origin"] (по умолчанию: 'верх') ('верх').

dpiint

DPI для хранения в метаданных файла. Это не влияет на разрешение выходного изображения.

metadatadict, optional

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

pil_kwargsdict, optional

Если установлено ненулевое значение, всегда используйте Pillow для сохранения фигуры (независимо от формата вывода) и передайте эти ключевые аргументы в PIL.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 or file-like

Файл изображения — должен быть PNG или поддерживаемым Pillow, если установлен Pillow.

thumbfilestr or file-like

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

scalefloat, optional

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

interpolationstr, optional

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

previewbool, optional

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

Возвращает:
figureFigure

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

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

Spec-Zone.ru

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