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(self, event)[source] -
Возвращает значение изображения в позиции события или None, если событие находится вне изображения.
См. также
-
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._ImageBasecmap — экземпляр 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, если позиция курсора находится вне изображения.
См. также
-
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