matplotlib.backends.backend_svg

matplotlib.backends.backend_svg.FigureCanvas[source]

псевдоним для FigureCanvasSVG

classmatplotlib.backends.backend_svg.FigureCanvasSVG(figure=None)[source]

Базы: FigureCanvasBase

draw()[source]

Отображение Figure.

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

filetypes={'svg': 'Scalable Vector Graphics', 'svgz': 'Scalable Vector Graphics'}

fixed_dpi=72

get_default_filetype()[source]

Возвращает значение по умолчанию для формата сохранения файла, как указано в rcParams["savefig.format"] (значение по умолчанию: 'png').

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

print_svg(filename, *, bbox_inches_restore=None, metadata=None)[source]

Parameters:

filenamestr или path-like или file-like

Целевой объект вывода; если строка, то будет открыт файл для записи.

metadatadict[str, Any], необязательно

Метаданные в файле SVG, определённые как пары «ключ-значение» строк, дат, времени или списков строк, например, {'Creator': 'My software', 'Contributor': ['Me', 'My Friend'], 'Title': 'Awesome'}.

Стандартные ключи и их типы значений:

• str: 'Coverage', 'Description', 'Format', 'Identifier', 'Language', 'Relation', 'Source', 'Title', и 'Type'.
• str или список строк: 'Contributor', 'Creator', 'Keywords', 'Publisher', и 'Rights'.
• str, дата, время или кортеж из того же: 'Date'. Если не str, то будет отформатировано как ISO 8601.

Значения предопределены для 'Creator', 'Date', 'Format', и 'Type'. Их можно удалить, установив их в значение None.

Информация закодирована как метаданные Dublin Core.

print_svgz(filename, **kwargs)[source]

classmatplotlib.backends.backend_svg.RendererSVG(width, height, svgwriter, basename=None, image_dpi=72, *, metadata=None)[source]

Bases: RendererBase

close_group(s)[source]

Закрыть элемент группировки с меткой s.

Используется только в SVG-рендерере.

draw_gouraud_triangles(gc, triangles_array, colors_array, transform)[source]

Отрисовка серии треугольников Гуро.

Параметры:

gcGraphicsContextBase

Контекст графики.

triangles_array(N, 3, 2) массив-подобный объект

Массив из N точек (x, y) для треугольников.

colors_array(N, 3, 4) массив-подобный объект

Массив из N цветов RGBA для каждой точки треугольников.

transformTransform

Аффинное преобразование, применяемое к точкам.

draw_image(gc, x, y, im, transform=None)[source]

Отрисовка изображения RGBA.

Параметры:

gcGraphicsContextBase

Контекст графики с информацией о обрезке.

xскаляр

Расстояние в физических единицах (точках или пикселях) от левой стороны холста.

yскаляр

Расстояние в физических единицах (точках или пикселях) от нижней стороны холста.

im(N, M, 4) массив numpy.uint8

Массив пикселей RGBA.

transformAffine2DBase

Если и только если конкретный бэкэнд написан таким образом, что option_scale_image возвращает True, может быть передано аффинное преобразование (т.е., Affine2DBase) возможно в draw_image. Вектор переноса преобразования задаётся в физических единицах (точках или пикселях). Обратите внимание, что преобразование не переопределяет x и y и должно быть применено до перевода результата на x и y (это можно сделать, добавив x и y к вектору переноса, определённому transform).

draw_markers(gc, marker_path, marker_trans, path, trans, rgbFace=None)[source]

Отрисовка маркера в каждой вершине path (исключая контрольные точки).

Базовая (по умолчанию) реализация вызывает несколько вызовов draw_path. Бэкэнды могут переопределить этот метод, чтобы нарисовать маркер только один раз и повторно использовать его несколько раз.

Параметры:

gcGraphicsContextBase

Контекст графики.

marker_pathPath

Путь для маркера.

marker_transTransform

Аффинное преобразование, применяемое к маркеру.

pathPath

Расположение для отрисовки маркеров.

transTransform

Аффинное преобразование, применяемое к пути.

rgbFaceцвет, необязательно

draw_path(gc, path, transform, rgbFace=None)[source]

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

draw_path_collection(gc, master_transform, paths, all_transforms, offsets, offset_trans, facecolors, edgecolors, linewidths, linestyles, antialiaseds, urls, offset_position)[source]

Отрисовка коллекции paths.

Каждый путь сначала преобразуется соответствующей записью в all_transforms (список матриц (3, 3)), а затем — master_transform. Затем они переводятся соответствующей записью в offsets, которая предварительно преобразуется с помощью offset_trans.

facecolors, edgecolors, linewidths, linestyles и antialiased — списки, задающие соответствующие свойства.

offset_position сейчас не используется, но аргумент сохраняется для обратной совместимости.

Основная (fallback) реализация выполняет несколько вызовов draw_path. Бэкэнды могут переопределить это, чтобы отрисовать каждый набор данных пути только один раз, а затем ссылаться на этот путь несколько раз с различными смещениями, цветами, стилями и т. д. Генераторные методы _iter_collection_raw_paths и _iter_collection предназначены для помощи (и стандартизации) реализации в разных бэкендах. Сильно рекомендуется использовать эти генераторы, чтобы изменения в поведении draw_path_collection можно было внести глобально.

draw_text(gc, x, y, s, prop, angle, ismath=False, mtext=None)[source]

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

Параметры:

gcGraphicsContextBase

Контекст графики.

xfloat

Координата x текста в координатах отображения.

yfloat

Координата y линии основания текста в координатах отображения.

sstr

Строка текста.

propFontProperties

Свойства шрифта.

anglefloat

Угол поворота в градусах против часовой стрелки.

ismathbool или "TeX"

Если True, использовать парсер mathtext. Если "TeX", использовать tex для рендеринга.

mtextText

Исходный объект текста для рендеринга.

finalize()[source]

flipy()[source]

Возвращает, увеличиваются ли значения y сверху вниз.

Обратите внимание, что это влияет только на отрисовку текста.

get_canvas_width_height()[source]

Возвращает ширину и высоту холста в координатах отображения.

get_image_magnification()[source]

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

get_text_width_height_descent(s, prop, ismath)[source]

Получение ширины, высоты и спуска (смещения снизу до линии основания) в координатах отображения строки s с FontProperties prop.

Пробелы в начале и в конце s включаются в расчетную ширину.

open_group(s, gid=None)[source]

Открытие элемента группирования с меткой s и gid (если задано) в качестве идентификатора.

Используется только бэкендом SVG.

option_image_nocomposite()[source]

Возвращает, следует ли пропустить композицию изображений Matplotlib.

Бэкенды растровых изображений обычно возвращают False (позволяя C-уровневому растрирующему устройству позаботиться о композиции изображений); бэкенды векторных изображений обычно возвращают not rcParams["image.composite_image"].

option_scale_image()[source]

Возвращает, поддерживаются ли произвольные аффинные преобразования в draw_image (True для большинства бэкэндов векторных изображений).

classmatplotlib.backends.backend_svg.XMLWriter(file)[source]

Bases: object

Параметры:

fileобъект текстового файла для записи

close(id)[source]

Закрывает открытые элементы до (и включая) элемента, идентифицированного данным идентификатором.

Параметры:

id

Идентификатор элемента, возвращённый методом start().

comment(comment)[source]

Добавляет комментарий в поток вывода.

Параметры:

commentstr

Текст комментария.

data(text)[source]

Добавляет символьные данные в поток вывода.

Параметры:

textstr

Символьные данные.

element(tag, text=None, attrib={}, **extra)[source]

Добавляет целый элемент. Это эквивалентно последовательному вызову start(), data() и end(). Аргумент text можно опустить.

end(tag=None, indent=True)[source]

Закрывает текущий элемент (открытый последним вызовом start()).

Параметры:

tag

Тэг элемента. Если указан, он должен совпадать с начальным тэгом. Если опущен, текущий элемент закрывается.

indentbool, по умолчанию: True

flush()[source]

Очистить поток вывода.

start(tag, attrib={}, **extra)[source]

Открывает новый элемент. Атрибуты могут быть заданы как ключевые аргументы или в виде строки/словаря строк. Метод возвращает непрозрачный идентификатор, который можно передать методу close() для закрытия всех открытых элементов до и включая этот.

Параметры:

tag

Тэг элемента.

attrib

Словарь атрибутов. В качестве альтернативы, атрибуты можно задать в виде ключевых аргументов.

Возвращает:

Идентификатор элемента.