Изображение

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

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

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

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

Дополнительные параметры kwargs — это свойства matplotlib.artist

get_cursor_data(event) [source]

Получение данных указателя для заданного события

get_extent() [source]

Получение области изображения: слева, справа, снизу, сверху

get_window_extent(renderer=None) [source]

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

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

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

set_extent(extent) [source]

extent — это оси данных (слева, справа, снизу, сверху) для создания графиков изображений

Это обновляет ax.dataLim и, при автоматическом масштабировании, устанавливает 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=True, **kwargs) [source]

Базы: matplotlib.image._ImageBase

Класс Image, размер которого определяется заданной областью отрисовки.

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

interp_at_native — флаг, определяющий, применяется ли интерполяция, когда изображение отображается в родном разрешении. Распространённый случай использования — отображение изображения для аннотаций; он обрабатывается аналогично Photoshop (интерполяция используется только при отображении изображения в разрешении, отличном от родного).

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

contains(mouseevent) [source]

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

get_transform() [source]

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

get_window_extent(renderer=None) [source]

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

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

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

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() [source]

Получение области изображения: слева, справа, снизу, сверху

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

set_data(A) [source]

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

zorder = 0

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

Основы: matplotlib.image.AxesImage

Параметры kwargs идентичны параметрам AxesImage, за исключением того, что поддерживаются только опции 'nearest' и 'bilinear' для 'interpolation'.

get_extent() [source]

Получить область изображения: слева, справа, снизу, сверху

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

set_array(*args) [source]

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

Параметры:	A : array-like

set_cmap(cmap) [source]

Установить палитру для данных яркости

Параметры:	cmap : colormap or registered colormap name

set_data(x, y, A) [source]

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

x и y — монотонные одномерные массивы numpy длиной N и M соответственно, определяющие центры пикселей

A — массив numpy (M,N) или массив с пропускаемыми значениями (masked array) значений, подлежащих цветовому отображению, или массив RGB (M,N,3) или RGBA (M,N,4).

set_filternorm(s) [source]

Установить, нормализует ли фильтр веса при изменении размера.

См. справку по imshow.

Параметры:	filternorm : bool

set_filterrad(s) [source]

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

Параметры:	filterrad : positive float

set_interpolation(s) [source]

Параметры:	s : str, None Либо 'nearest', либо 'bilinear', или None.

set_norm(norm) [source]

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

Параметры:	norm : Normalize

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

Дополнительные параметры kwargs — свойства matplotlib.artist

get_cursor_data(event) [source]

Получить данные курсора для заданного события

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

set_array(*args) [source]

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

Параметры:	A : array-like

set_data(x, y, A) [source]

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

x и y — монотонные одномерные массивы numpy длиной N+1 и M+1 соответственно, определяющие границы прямоугольника. Если None, они будут созданы как равномерные массивы от 0 до N и от 0 до M соответственно.

A — массив numpy (M,N) или массив с пропускаемыми значениями (masked array) значений, подлежащих цветовому отображению, или массив RGB (M,N,3) или RGBA (M,N,4).

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

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

Параметры:	images : list of Images Каждый должен иметь метод make_image. Для каждого изображения can_composite должен возвращать True, хотя это не проверяется этой функцией. Каждое изображение должно иметь чисто аффинное преобразование без сдвига. renderer : RendererBase instance magnification : float Дополнительное увеличение для применения рендерером.
Возвращает:	tuple : image, offset_x, offset_y Возвращает кортеж: image: массив numpy того же типа, что и входные изображения. offset_x, offset_y: смещение изображения (слева, снизу) на выходе.

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

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

Параметры:	fname : str or file-like Файл изображения для чтения. Может быть именем файла, URL-адресом или объектом Python-подобного файла, открытым в режиме чтения в двоичном формате. format : str, optional Предполагаемый формат файла изображения для чтения данных. Если не указан, формат определяется по имени файла. Если ничего нельзя определить, используется PNG.
Возвращаемое значение:	imagedata : numpy.array Данные изображения. Возвращаемый массив имеет форму (M, N) для черно-белых изображений. (M, N, 3) для RGB-изображений. (M, N, 4) для RGBA-изображений.

Примечания

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

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

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

Доступные форматы вывода зависят от используемого бэкэнда.

Параметры:

fname : str or file-like Имя файла или объект Python-подобного файла для хранения изображения. Необходимый формат вывода определяется из расширения имени файла, но может быть явно изменён с помощью параметра format. arr : array-like Данные изображения. Форма может быть MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA). vmin, vmax : scalar, optional vmin и vmax задают масштабирование цветов изображения, фиксируя значения, которые отображаются в пределах цветов цветовой карты. Если vmin или vmax равны None, эти пределы определяются по минимальному/максимальному значению в arr. cmap : str or Colormap, optional Экземпляр цветовой карты или зарегистрированное имя цветовой карты. Цветовая карта сопоставляет скалярные данные с цветами. Она игнорируется для данных RGB(A). По умолчанию используется rcParams["image.cmap"] ('viridis'). format : str, optional Формат файла, например, 'png', 'pdf', 'svg' и т. д. Если не указан, формат определяется по расширению имени файла в fname. Подробности см. в Figure.savefig. origin : {'upper', 'lower'}, optional Указывает, находится ли индекс (0, 0) массива в верхнем левом или нижнем левом углу осей. По умолчанию rcParams["image.origin"] ('upper'). dpi : int DPI для хранения в метаданных файла. Это не влияет на разрешение выходного изображения.

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.

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

Параметры:

infile : str or file-like Файл изображения — должен быть PNG, если установлен Pillow, то Pillow-совместимый. thumbfile : str or file-like Имя файла миниатюры. scale : float, optional Коэффициент масштабирования для миниатюры. interpolation : str, optional Схема интерполяции, используемая при ресемплировании. Возможные значения см. в параметре interpolation функции imshow. preview : bool, optional Если True, будет использован стандартный бэкэнд (вероятно, бэкэнд пользовательского интерфейса), который отобразит окно, если будет вызван show. Если False, фигура создаётся с помощью FigureCanvasBase, а бэкэнд отрисовки выбирается так, как это обычно делает savefig.

Возвращаемое значение:

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