Spec-Zone.ru › Matplotlib 3.3

matplotlib.image

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

class matplotlib.image.AxesImage(ax, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=True, 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] массива в верхнем левом или нижнем левом углу оси. Конвенция 'upper' обычно используется для матриц и изображений.

extenttuple, optional

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

filternormbool, default: True

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

filterradfloat > 0, default: 4

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

resamplebool, default: False

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

**kwargsArtist properties
Параметры:
normmatplotlib.colors.Normalize (or subclass thereof)

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

cmapstr or Colormap

Цветовая карта, используемая для сопоставления нормализованных значений данных с цветами 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, с заданным magnification.

Если 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=True, filterrad=4.0, resample=False, **kwargs) [source]

Bases: 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).

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

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

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

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

Bases: 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, с указанным magnification.

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

Bases: matplotlib.image.AxesImage

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

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

get_extent(self) [source]

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

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

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

Если 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 str or None
set_data(self, x, y, A) [source]

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

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

Монотонные массивы форм (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]
Параметры:
s{'nearest', 'bilinear'} or None

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

set_norm(self, norm) [source]

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

Параметры:
normNormalize or None

Примечания

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

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

Bases: matplotlib.image.AxesImage

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

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

Параметры:
axAxes

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

x, y1D array-like, optional

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

Aarray-like

Данные для цветового кодирования. Интерпретация зависит от формы:

  • (M, N) массив NumPy или массив с пропускаемыми значениями: значения для сопоставления с цветовой палитрой
  • (M, N, 3): массив RGB
  • (M, N, 4): массив RGBA
cmapstr or Colormap, default: rcParams["image.cmap"] (default: 'viridis')

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

normNormalize

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

**kwargsArtist properties
get_cursor_data(self, event) [source]

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

См. также

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

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

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

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

Aarray-like

Данные для цветового кодирования. Интерпретация зависит от формы:

  • (M, N) массив NumPy или массив с пропускаемыми значениями: значения для сопоставления с цветовой палитрой
  • (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
magnificationfloat, default: 1

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

Возвращает:
imageuint8 3d array

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

offset_x, offset_yfloat

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

matplotlib.image.imread(fname, format=None) [source]

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

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

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

formatstr, optional

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

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

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

  • (M, N) для черно-белых изображений.
  • (M, N, 3) для изображений RGB.
  • (M, N, 4) для изображений RGBA.
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 path-like or file-like

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

arrarray-like

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

vmin, vmaxfloat, optional

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

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

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

formatstr, optional

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

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

Указывает, находится ли индекс (0, 0) массива в левом верхнем или левом нижнем углу осей.

dpifloat

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

metadatadict, optional

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

pil_kwargsdict, optional

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

matplotlib.image.pil_to_array(pilImage) [source]

Загрузка изображения PIL и возвращение его как массива numpy int.

Возвращает:
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

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

thumbfilestr or file-like

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

scalefloat, default: 0.1

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

interpolationstr, default: 'bilinear'

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

previewbool, default: False

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

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

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

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

Spec-Zone.ru

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