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. По умолчанию используется вид линии.

axes : экземпляр Axes, содержащий ось
spine_type : строка, определяющая тип оси
path : экземпляр path, используемый для рисования оси

Допустимые аргументы kwargs:

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

classmethod arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs) [source]: (classmethod) Возвращает дугу Spine.

classmethod circular_spine(axes, center, radius, **kwargs) [source]: (staticmethod) Возвращает окружность Spine.

cla(self) [source]: Очистить текущую ось.

draw(self, renderer) [source]: Нарисовать Patch на заданном рендерере.

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]: Возвращает, имеет ли осевая линия интеллектуальные границы.

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

get_window_extent(self, renderer=None) [source]

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

См. также

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

is_frame_like(self) [source]

[Устарело] Возвращает True, если осевая линия находится непосредственно на рамке осей.

Это полезно для определения, является ли осевая линия краем графика старого стиля MPL. Если да, эта функция вернёт True.

Примечания

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

classmethod linear_spine(axes, spine_type, **kwargs) [source]: (статический метод) Возвращает линейную Spine.

register_axis(self, axis) [source]

Регистрирует ось.

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

set_bounds(self, low, high) [source]: Устанавливает границы осевой линии.

set_color(self, c) [source]

Устанавливает цвет края.

Параметры:	`c : color`

Примечания

Этот метод не изменяет цвет заливки (по умолчанию «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,0 до 1,0).
'data' : помещает осевую линию в указанной координате данных.

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

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

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