matplotlib.spines

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

Bases: 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, и возвращает массив float (m, n, 3)
`alpha`	float или None
`animated`	bool
`antialiased` или aa	неизвестно
`capstyle`	{'butt', 'round', 'projecting'}
`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`	строка
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`in_layout`	bool
`joinstyle`	{'miter', 'round', 'bevel'}
`label`	объект
`linestyle` или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
`linewidth` или lw	float или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или вызываемый объект
`rasterized`	bool или None
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`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(self) [source]: Очищает текущую ось.

draw(self, renderer) [source]

Отобразить элемент (и его потомки) с помощью заданного рендерера.

Этот метод не имеет эффекта, если элемент не отображается (Artist.get_visible возвращает False).

Параметры:	`rendererRendererBase subclass.`

Примечания

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

get_bounds(self) [source]: Получить границы отсечки.

get_patch_transform(self) [source]

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

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

get_path(self) [source]: Возвратить путь данного элемента.

get_position(self) [source]: Возвращает положение отсечки.

get_smart_bounds(self) [source]: [Устарело] Возвращает, имеет ли отсечка интеллектуальные границы.

Примечания

Устарело начиная с версии 3.2.

get_spine_transform(self) [source]: Возвращает преобразование отсечки.

get_window_extent(self, renderer=None) [source]

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

См. также

matplotlib.axes.Axes.get_tightbbox
matplotlib.axes.Axes.get_window_extent

classmethod linear_spine(axes, spine_type, **kwargs) [source]: Создать и вернуть линейную Spine.

register_axis(self, axis) [source]

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

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

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

Установить границы отсечки.

Параметры:

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

lowfloat or None, optional

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

Границы также могут быть переданы в виде кортежа (low, high) в качестве первого позиционного аргумента.

highfloat or None, optional

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

set_color(self, c) [source]

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

Параметры:	`ccolor`

Примечания

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

set_patch_arc(self, center, radius, theta1, theta2) [source]: Установить отсечку в форме дуги.

set_patch_circle(self, center, radius) [source]: Установить отсечку в форме круга.

set_patch_line(self) [source]: Установить отсечку в форме прямой линии.

set_position(self, position) [source]

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

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

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

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

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

set_smart_bounds(self, value) [source]: [Устарело] Установить интеллектуальные границы для отсечки и связанной оси.

Примечания

Устарело начиная с версии 3.2.