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 Оси, к которым будет принадлежать изображение. cmapстрока или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой карты, используемое для сопоставления скалярных данных с цветами. normNormalize Преобразует яркость в диапазон 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'. origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper') Размещает индекс [0, 0] массива в верхнем левом или нижнем левом углу осей. Конвенция 'upper' обычно используется для матриц и изображений. extentкортеж, необязательно Оси данных (слева, справа, снизу, сверху) для создания графиков изображений, согласованных с графиками данных. По умолчанию используются индексы строк и столбцов с нуля для обозначения центров пикселей. filternormбулево, по умолчанию: True Параметр фильтра масштабирования изображения antigrain (см. документацию antigrain). Если filternorm установлено, фильтр нормализует целочисленные значения и исправляет ошибки округления. Он не выполняет никаких операций с исходными значениями с плавающей запятой, а исправляет только целые числа в соответствии с правилом 1.0, что означает, что любая сумма весов пикселей должна быть равна 1.0. Таким образом, функция фильтра должна генерировать график с правильной формой. filterradчисло > 0, по умолчанию: 4 Радиус фильтра для фильтров, имеющих параметр радиуса, т.е. когда интерполяция является одним из: 'sinc', 'lanczos' или 'blackman'. resampleбулево, по умолчанию: False Если True, используется полный метод ресемплирования. Если False, ресемплирование выполняется только тогда, когда выходное изображение больше входного изображения. **kwargsArtist свойства

Параметры:	normmatplotlib.colors.Normalize (или подкласс) Объект нормализации, который масштабирует данные, обычно в интервал [0, 1]. Если None, norm по умолчанию устанавливается в объект colors.Normalize, который инициализирует масштабирование на основе обработанных данных. cmapстрока или Colormap Цветовая карта, используемая для сопоставления нормализованных значений данных с цветами RGBA.

format_cursor_data(data)[source]

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

Примечание

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

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

См. также

get_cursor_data

get_cursor_data(event)[source]

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

См. также

matplotlib.artist.Artist.get_cursor_data

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, yвещественное число Верхний левый угол, куда должно быть нарисовано изображение, в пикселях. transAffine2D Аффинное преобразование из пространства изображения в пространство пикселей.

set_extent(extent)[source]

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

Параметры:	extentкортеж из 4 чисел с плавающей точкой Положение и размер изображения в виде кортежа (left, right, bottom, top) в координатах данных.

Примечания

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

класс matplotlib.image.BboxImage(bbox, cmap=None, norm=None, interpolation=None, origin=None, filternorm=True, filterrad=4.0, resample=False, **kwargs)[source]

Базы: matplotlib.image._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 — пересэмплировано. x, yfloat Верхний левый угол, где должно быть отображено изображение, в пикселях. transAffine2D Аффинное преобразование из пространства изображения в пространство пикселей.

класс 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]

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

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

Возвращает:	image(M, N, 4) массив uint8 RGBA изображение, если не unsampled — пересэмплировано. x, yfloat Верхний левый угол, где должно быть отображено изображение, в пикселях. transAffine2D Аффинное преобразование из пространства изображения в пространство пикселей.

set_data(A)[source]

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

zorder = 0

класс matplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs)[source]

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

Параметры:	interpolation{'nearest', 'bilinear'}, по умолчанию: 'nearest' **kwargs Все остальные ключевые аргументы идентичны аргументам AxesImage.

get_extent()[source]

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

свойство is_grayscale

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

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

Параметры:	Aarray-like

set_cmap(cmap)[source]

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

Параметры:	cmapColormap или str или None

set_data(x, y, A)[source]

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

Параметры:	x, yОдномерный массив-подобный объект Монотонные массивы форм (N,) и (M,), соответственно, определяющие центры пикселей. Aarray-like (M, N) ndarray или masked array значений для цветовой карты, или (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]

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

Параметры:	normNormalize или None

Примечания

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

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

Базы: matplotlib.image.AxesImage

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

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

Параметры:

axAxes Оси, к которым будет принадлежать изображение. x, yОдномерный массив, необязательно Монотонные массивы длиной N+1 и M+1 соответственно, определяющие границы прямоугольников. Если не указаны, будут использованы значения по умолчанию range(N + 1) и range(M + 1) соответственно. Aмассив Данные для кодирования цвета. Интерпретация зависит от формы: (M, N) массив или массив с пропусками: значения для сопоставления с цветовой палитрой (M, N, 3): массив RGB (M, N, 4): массив RGBA cmapстрока или Colormap, значение по умолчанию: rcParams["image.cmap"] (значение по умолчанию: 'viridis') Экземпляр Colormap или зарегистрированное имя цветовой палитры, используемое для сопоставления скалярных данных с цветами. normNormalize Преобразует значения яркости в диапазон 0-1. **kwargsArtist свойства

get_cursor_data(event)[source]

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

См. также

matplotlib.artist.Artist.get_cursor_data

свойство is_grayscale

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

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

Параметры:	Aмассив

set_data(x, y, A)[source]

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

Параметры:

x, yОдномерный массив, необязательно Монотонные массивы длиной N+1 и M+1 соответственно, определяющие границы прямоугольников. Если не указаны, будут использованы значения по умолчанию range(N + 1) и range(M + 1) соответственно. Aмассив Данные для кодирования цвета. Интерпретация зависит от формы: (M, N) массив или массив с пропусками: значения для сопоставления с цветовой палитрой (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, хотя это не проверяется этой функцией. Каждое изображение должно иметь чисто аффинную трансформацию без сдвига. rendererRendererBase magnificationfloat, значение по умолчанию: 1 Дополнительное увеличение, применяемое к используемому renderer.
Возвращает:	imageмассив uint8 (M, N, 4) Объединенное изображение RGBA. offset_x, offset_yfloat Смещение (слева, снизу), где объединенное изображение должно быть размещено в выходной фигуре.

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

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

Параметры:

fnamestr или file-like Файл изображения для чтения: имя файла, URL или файл-подобный объект, открытый в режиме чтения в двоичном формате. Передача URL устарела. Пожалуйста, откройте URL для чтения и передайте результат в Pillow, например, с помощью PIL.Image.open(urllib.request.urlopen(url)). formatstr, необязательно Формат файла изображения, предполагаемый для чтения данных. Если не указан, формат определяется из имени файла. Если ничего нельзя определить, используется 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 или путь или файл-подобный объект Путь или файл-подобный объект для хранения изображения. Если format не задан, формат вывода определяется из расширения fname, если оно есть, и из rcParams["savefig.format"] (по умолчанию 'png'). Если format задан, он определяет формат вывода. arrarray-like Данные изображения. Форма может быть MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA). vmin, vmaxfloat, необязательно vmin и vmax устанавливают масштабирование цвета для изображения, фиксируя значения, которые отображаются на пределы цвета палитры. Если vmin или vmax равно None, этот предел определяется по минимальному/максимальному значению в arr. cmapstr или Colormap, по умолчанию: rcParams["image.cmap"] (по умолчанию: 'viridis') Экземпляр Colormap или зарегистрированное имя палитры. Палитра отображает скалярные данные в цвета. Она игнорируется для данных RGB(A). formatstr, необязательно Формат файла, например, 'png', 'pdf', 'svg', ... Поведение, когда это не установлено, документировано в fname. origin{'upper', 'lower'}, по умолчанию: rcParams["image.origin"] (по умолчанию: 'upper') Указывает, находится ли индекс (0, 0) массива в верхнем левом или нижнем левом углу осей. dpifloat DPI, которая хранится в метаданных файла. Это не влияет на разрешение выходного изображения. В зависимости от формата файла, это может быть округлено до ближайшего целого числа. metadatadict, необязательно Метаданные в файле изображения. Поддерживаемые ключи зависят от формата вывода, см. документацию соответствующих бэкэндов для получения дополнительной информации. pil_kwargsdict, необязательно Ключевые аргументы, передаваемые в 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 или file-like Файл изображения. Matplotlib использует Pillow для чтения изображений, и поэтому поддерживает широкий спектр форматов файлов, включая PNG, JPG, TIFF и другие. thumbfilestr или file-like Имя файла миниатюры. scalefloat, по умолчанию: 0.1 Коэффициент масштабирования для миниатюры. interpolationstr, по умолчанию: 'bilinear' Схема интерполяции, используемая при ресемплировании. См. параметр interpolation imshow для возможных значений. previewbool, по умолчанию: False Если True, используется стандартный бэкэнд (предположительно, бэкэнд пользовательского интерфейса), что приведет к появлению фигуры, если вызов show. Если False, фигура создается с помощью FigureCanvasBase, а бэкэнд рисования выбирается так же, как это обычно делает Figure.savefig.

Возвращает:

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