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

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

format_cursor_data(self, data) [source]

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

Примечание

Этот метод предназначен для переопределения в подклассах artist. Пользователю 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, y : float` Верхний левый угол для рисования изображения в пространстве пикселей. `trans : Affine2D` Аффинная трансформация из пространства изображения в пространство пикселей.

image : (M, N, 4) uint8 array: Изображение RGBA, масштабированное, если unsampled не равно True.
x, y : float: Верхний левый угол для рисования изображения в пространстве пикселей.
trans : Affine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

set_extent(self, 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=<deprecated parameter>, **kwargs) [source]

Базы: matplotlib.image._ImageBase

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

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]

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

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

interp_at_native

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

Возвращает:

Возвращает:	`image : (M, N, 4) uint8 array` Изображение RGBA, масштабированное, если unsampled не равно True. `x, y : float` Верхний левый угол для рисования изображения в пространстве пикселей. `trans : Affine2D` Аффинная трансформация из пространства изображения в пространство пикселей.

image : (M, N, 4) uint8 array: Изображение RGBA, масштабированное, если unsampled не равно True.
x, y : float: Верхний левый угол для рисования изображения в пространстве пикселей.
trans : Affine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

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]

Возвращает:

Возвращает:	`image : (M, N, 4) uint8 array` Изображение RGBA, масштабированное, если unsampled не равно True. `x, y : float` Верхний левый угол для рисования изображения в пространстве пикселей. `trans : Affine2D` Аффинная трансформация из пространства изображения в пространство пикселей.

image : (M, N, 4) uint8 array: Изображение RGBA, масштабированное, если unsampled не равно True.
x, y : float: Верхний левый угол для рисования изображения в пространстве пикселей.
trans : Affine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

set_data(self, A) [source]: Устанавливает массив изображения.

zorder = 0

END_OF_DOCUMENT_MARKER

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

Базы: matplotlib.image.AxesImage

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

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, y : float` Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей. `trans : Affine2D` Аффинная трансформация из пространства изображения в пространство пикселей.

image : (M, N, 4) uint8 array: Изображение RGBA, масштабированное, если unsampled не равно True.
x, y : float: Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей.
trans : Affine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

set_array(self, *args) [source]

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

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

set_cmap(self, cmap) [source]

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

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

set_data(self, x, y, A) [source]

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

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

set_filternorm(self, s) [source]

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

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

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

set_filterrad(self, s) [source]

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

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

set_interpolation(self, s) [source]

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

set_norm(self, 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(self, event) [source]

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

См. также

matplotlib.artist.Artist.get_cursor_data

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

Возвращает:

Возвращает:	`image : (M, N, 4) uint8 array` Изображение RGBA, масштабированное, если unsampled не равно True. `x, y : float` Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей. `trans : Affine2D` Аффинная трансформация из пространства изображения в пространство пикселей.

image : (M, N, 4) uint8 array: Изображение RGBA, масштабированное, если unsampled не равно True.
x, y : float: Верхний левый угол, где должно быть отображено изображение, в пространстве пикселей.
trans : Affine2D: Аффинная трансформация из пространства изображения в пространство пикселей.

set_array(self, *args) [source]

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

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

set_data(self, x, y, A) [source]

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

x и y — монотонные одномерные массивы длины N+1 и M+1 соответственно, определяющие границы прямоугольников. Если None, они будут созданы как равномерные массивы от 0 до N и от 0 до M соответственно.: соответственно, определяющие границы прямоугольников
A — массив (M,N) или массив с пропусками значений, подлежащих: окраске по цветовой карте, или массив (M,N,3) RGB, или массив (M,N,4) RGBA.

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: Смещение изображения (слева, снизу) на выходном рисунке.

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.

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.

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

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

Параметры:

Параметры:	`fname : str or PathLike file-like` Путь или объект Python-подобного файла для хранения изображения. Если формат не задан, формат вывода определяется по расширению fname, если таковое имеется, и из `rcParams["savefig.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. `origin : {'upper', 'lower'}, optional` Указывает, находится ли индекс `(0, 0)` массива в верхнем левом или нижнем левом углу осей. По умолчанию `rcParams["image.origin"]` ('upper'). `dpi : int` DPI для хранения в метаданных файла. Это не влияет на разрешение выходного изображения.

fname : str or PathLike file-like: Путь или объект Python-подобного файла для хранения изображения. Если формат не задан, формат вывода определяется по расширению fname, если таковое имеется, и из rcParams["savefig.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.
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` Экземпляр фигуры, содержащий миниатюру.

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: Экземпляр фигуры, содержащий миниатюру.