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	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` или lw	float или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемый объект
`rasterized`	bool или None
`sketch_params`	(scale: float, length: float, randomness: 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]: Нарисовать для заданного рендерера.

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

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=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]

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

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

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

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

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

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

Примечания

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