spines

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, используемый для рисования оси

Допустимые ключевые слова:

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

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

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

get_patch_transform() [source]

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

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

get_path() [source]: Возвращает путь этого патча

get_position() [source]: Получить положение шипа

get_smart_bounds() [source]: Получить, имеет ли шип интеллектуальные границы

get_spine_transform() [source]: Получить преобразование шипа

get_window_extent(renderer=None) [source]

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

Будьте осторожны при использовании этой функции, результаты не обновятся, если область отображения объекта-художника изменится. Область может измениться из-за любых изменений в стеке преобразования, таких как изменение пределов осей, размера фигуры или холста (как делается при сохранении фигуры). Это может привести к неожиданному поведению, когда интерактивные фигуры будут выглядеть нормально на экране, но будут сохранены неправильно.

is_frame_like() [source]

Возвращает True, если непосредственно на рамке осей

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

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

register_axis(axis) [source]

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

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

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

set_color(c) [source]

Устанавливает цвет обводки.

Параметры:	`c : color or sequence of rgba tuples` .. см. также:: `set_facecolor(), set_edgecolor()` Для отдельной установки цвета обводки или заливки.

set_patch_arc(center, radius, theta1, theta2) [source]: Устанавливает шип в виде дуги

set_patch_circle(center, radius) [source]: Устанавливает шип в виде окружности

set_patch_line() [source]: Устанавливает шип в виде прямой линии

set_position(position) [source]

Устанавливает положение шипа

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

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

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

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

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