matplotlib.spines

class matplotlib.spines.Spine(axes, spine_type, path, **kwargs)[source]

Базовые классы: matplotlib.patches.Patch

Граница оси — линия, обозначающая границы области данных.

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

Позиция по умолчанию — ('outward', 0).

Границы являются подклассами Patch и наследуют большую часть своего поведения.

Границы рисуют линию, круг или дугу в зависимости от того, был ли вызван set_patch_line, set_patch_circle или set_patch_arc. По умолчанию используется линия.

Параметры:

axesAxes Экземпляр Axes, содержащий границу. spine_typestr Тип границы. pathPath Экземпляр Path, используемый для рисования границы.

Другие параметры:

**kwargs Допустимые именованные аргументы: Свойство Описание agg_filter функция фильтра, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив (m, n, 3) alpha скаляр или None animated bool antialiased или aa неизвестно capstyle CapStyle или {'butt', 'projecting', 'round'} clip_box Bbox clip_on bool clip_path Patch или (Path, Transform) или None color цвет contains неизвестно edgecolor или ec цвет или None или 'auto' facecolor или fc цвет или None figure Figure fill bool gid str hatch {'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} in_layout bool joinstyle JoinStyle или {'miter', 'round', 'bevel'} label объект linestyle или ls {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} linewidth или lw float или None path_effects AbstractPathEffect picker None или bool или float или вызываемый объект rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool или None transform Transform url str visible bool zorder float

classmethod arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)[source]

Создать и вернуть дуговую Spine.

classmethod circular_spine(axes, center, radius, **kwargs)[source]

Создать и вернуть круговой Spine.

cla()[source]

[Устарело]

Примечания

Устарело начиная с версии 3.4:

clear()[source]

Очистить текущий spine.

draw(renderer)[source]

Нарисовать Artist (и его потомков) используя заданный renderer.

Это не оказывает никакого эффекта, если artist не виден (Artist.get_visible возвращает False).

Параметры:	rendererRendererBase подкласс.

Примечания

Этот метод переопределен в подклассах Artist.

get_bounds()[source]

Получить границы spine.

get_patch_transform()[source]

Возвращает экземпляр Transform, отображающий координаты patch в координаты данных.

Например, можно определить patch круга, который представляет радиус 5, предоставив координаты для единичного круга и преобразование, которое масштабирует координаты (координаты patch) на 5.

get_path()[source]

Возвращает путь этого patch.

get_position()[source]

Возвращает позицию spine.

get_spine_transform()[source]

Возвращает преобразование spine.

get_window_extent(renderer=None)[source]

Возвращает область окна spine в пространстве отображения, включая отступы для меток (но не их подписи)

См. также

matplotlib.axes.Axes.get_tightbbox

matplotlib.axes.Axes.get_window_extent

classmethod linear_spine(axes, spine_type, **kwargs)[source]

Создать и вернуть линейный Spine.

register_axis(axis)[source]

Зарегистрировать ось.

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

set_bounds(low=None, high=None)[source]

Установить границы spine.

Параметры:	lowfloat или None, необязательно Нижняя граница spine. Передача None оставляет предел без изменений. Границы также могут быть переданы как кортеж (low, high) в качестве первого позиционного аргумента. highfloat или None, необязательно Верхняя граница spine. Передача None оставляет предел без изменений.

set_color(c)[source]

Установить edgecolor.

Параметры:	cцвет

Примечания

Этот метод не изменяет facecolor (который по умолчанию равен "none"), в отличие от метода Patch.set_color, определенного в родительском классе. Используйте Patch.set_facecolor для установки facecolor.

set_patch_arc(center, radius, theta1, theta2)[source]

Установить spine как дугообразный.

set_patch_circle(center, radius)[source]

Установить spine как круговой.

set_patch_line()[source]

Установить spine как линейный.

set_position(position)[source]

Установить положение рамки.

Положение рамки задаётся 2-кортежем (тип положения, значение). Типы положений:

• 'outward': разместить рамку вне области данных на указанное количество точек. (Отрицательные значения размещают рамку внутри.)
• 'axes': разместить рамку в указанной координате Axes (от 0 до 1).
• 'data': разместить рамку в указанной координате данных.

Кроме того, сокращённые обозначения определяют специальные положения:

• 'center' -> ('axes', 0.5)
• 'zero' -> ('data', 0.0)

class matplotlib.spines.Spines(**kwargs)[source]

Базы: collections.abc.MutableMapping

Контейнер всех Spine в Axes.

Интерфейс похож на словарь, отображающий имена (например, 'left') на объекты Spine. Кроме того, он реализует некоторые функции, подобные pandas.Series, такие как доступ к элементам по атрибуту:

spines['top'].set_visible(False)
spines.top.set_visible(False)

К нескольким рамкам можно обращаться одновременно, передавая список:

spines[['top', 'right']].set_visible(False)

Используйте открытый срез для обращения ко всем рамкам:

spines[:].set_visible(False)

Два последних метода индексирования вернут SpinesProxy, который транслирует все вызовы set_* своим членам, но не может использоваться для каких-либо других операций.

classmethod from_dict(d)[source]

class matplotlib.spines.SpinesProxy(spine_dict)[source]

Базы: object

Прокси для трансляции вызовов метода set_* ко всем содержащимся Spines.

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

Поддерживаемые методы определяются динамически на основе содержащихся рамок. Если не все рамки поддерживают данный метод, он выполняется только на подмножестве рамок, которые его поддерживают.