Изображение

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)

Базовые классы: matplotlib.image._AxesImageBase

интерполяция и cmap по умолчанию используют значения из rc настроек

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

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

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

get_cursor_data(event)

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

get_extent()

Получение области изображения: left, right, bottom, top

get_window_extent(renderer=None)

make_image(magnification=1.0)

set_extent(extent)

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

Это обновляет 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)

Базовые классы: matplotlib.image._AxesImageBase

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

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

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

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

contains(mouseevent)

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

draw(artist, renderer, *args, **kwargs)

get_size()

Получение количества строк и столбцов входного изображения

get_window_extent(renderer=None)

make_image(renderer, magnification=1.0)

class matplotlib.image.FigureImage(fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)

Базовые классы: matplotlib.artist.Artist, matplotlib.cm.ScalarMappable

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

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

contains(mouseevent)

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

draw(artist, renderer, *args, **kwargs)

get_extent()

Получение области изображения: left, right, bottom, top

get_size()

Получение количества строк и столбцов входного изображения

make_image(magnification=1.0)

set_array(A)

Устаревшая функция; используйте set_data для соответствия другим типам изображений.

set_data(A)

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

write_png(fname)

Запись изображения в файл png с именем fname

zorder = 0

class matplotlib.image.NonUniformImage(ax, **kwargs)

Базовые классы: matplotlib.image.AxesImage

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

get_extent()

make_image(magnification=1.0)

set_array(*args)

set_cmap(cmap)

set_data(x, y, A)

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

x и y — одномерные массивы длиной N и M соответственно,

определяющие центры пикселей

A — массив (M,N) или массив значений с маскировкой, подлежащих

отображению с помощью colormap, или массив (M,N,3) RGB, или массив (M,N,4) RGBA.

set_filternorm(s)

set_filterrad(s)

set_interpolation(s)

set_norm(norm)

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

Базовые классы: matplotlib.artist.Artist, matplotlib.cm.ScalarMappable

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

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

cmap по умолчанию использует значение из rc настроек

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

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

changed()

draw(artist, renderer, *args, **kwargs)

make_image(magnification=1.0)

set_alpha(alpha)

Установка значения альфа-канала для смешивания — не поддерживается на всех бэкендах

ПРИНИМАЕТ: float

set_array(*args)

set_data(x, y, A)

matplotlib.image.imread(fname, format=None)

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

fname может быть строкой пути, допустимым URL или объектом Python-подобного файла. При использовании объекта файла он должен быть открыт в двоичном режиме.

Если format указан, то будет пытаться прочитать файл этого типа; в противном случае тип определяется из имени файла. Если ничего не удаётся определить, используется PNG.

Возвращаемое значение — массив numpy.array. Для черно-белых изображений возвращаемый массив имеет размер MxN. Для RGB-изображений возвращаемое значение — MxNx3. Для RGBA-изображений возвращаемое значение — MxNx4.

matplotlib может напрямую читать только PNG, но если установлена PIL, то она будет использоваться для загрузки изображения и возвращения массива (если возможно), который может быть использован с imshow(). Обратите внимание, что URL-строки могут быть несовместимы с PIL. Обратитесь к документации PIL для получения дополнительной информации.

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

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

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

Аргументы:

fname:

Строка с путем к имени файла или объект Python-подобного файла. Если format равен None и fname — строка, формат вывода определяется из расширения имени файла.

arr:

MxN (яркость), MxNx3 (RGB) или MxNx4 (RGBA) массив.

Ключевые аргументы:

vmin/vmax: [ None | скаляр ]

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

cmap:

cmap — экземпляр colors.Colormap, например, cm.jet. Если None, используется значение rc image.cmap.

format:

Одно из расширений файлов, поддерживаемых активным бэкэндом. Большинство бэкэндов поддерживают png, pdf, ps, eps и svg.

origin

[ ‘upper’ | ‘lower’ ] Указывает, где индекс [0,0] массива находится в верхнем левом или нижнем левом углу осей. По умолчанию используется значение rc image.origin.

dpi

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

matplotlib.image.pil_to_array(pilImage)

Загрузка изображения PIL и возвращение его в виде массива numpy. Для черно-белых изображений возвращаемый массив имеет размер MxN. Для RGB-изображений возвращаемое значение — MxNx3. Для RGBA-изображений возвращаемое значение — MxNx4

matplotlib.image.thumbnail(infile, thumbfile, scale=0.1, interpolation='bilinear', preview=False)

создать миниатюру изображения в infile с именем выходного файла thumbfile.

infile файл изображения – должен быть PNG или поддерживаемый Pillow, если у вас

установлена Pillow

thumbfile

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

scale

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

interpolation

схема интерполяции, используемая при повторном взятии образцов

preview

если True, будет использован стандартный бэкэнд (предположительно, бэкэнд пользовательского интерфейса), который отобразит график, если show() будет вызван. Если False, будет использован чистый бэкэнд для изображений в зависимости от расширения, ‘png’->FigureCanvasAgg, ‘pdf’->FigureCanvasPdf, ‘svg’->FigureCanvasSVG

См. примеры/разное/image_thumbnail.py.

примерный код misc: image_thumbnail.py

Возвращаемое значение — экземпляр фигуры, содержащей миниатюру