matplotlib.spines

классmatplotlib.spines.Spine(axes, spine_type, path, **kwargs)[source]

Bases: 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`	неизвестно
`animated`	bool
`antialiased` или aa	bool или None
`capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`clip_box`	`Bbox`
`clip_on`	bool
`clip_path`	Объект Patch или (Path, Transform) или None
`color`	цвет
`edgecolor` или ec	цвет или None
`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
`mouseover`	bool
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или float или вызываемая функция
`rasterized`	bool
`sketch_params`	(масштаб: float, длина: float, случайность: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	float

classmethodarc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)[source]: Создать и вернуть дугу Spine.

classmethodcircular_spine(axes, center, radius, **kwargs)[source]: Создать и вернуть окружность Spine.

clear()[source]: Очистить текущую линию.

draw(renderer)[source]

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

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

Parameters:

rendererRendererBase подкласс.

Примечания

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

get_bounds()[source]: Получить пределы линии.

get_patch_transform()[source]

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

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

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

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

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

get_window_extent(renderer=None)[source]

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

См. также

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

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

register_axis(axis)[source]

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

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

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, bounds=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, patch_arc=<UNSET>, patch_circle=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, position=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)[source]

Установить сразу несколько свойств.

Поддерживаемые свойства:

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

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

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

Параметры:

lowfloat или None, необязательно

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

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

highfloat или None, необязательно

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

set_color(c)[source]

Установить цвет рамки.

Параметры:

cцвет

Примечания

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

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

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

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

set_position(position)[source]

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

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

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

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

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

classmatplotlib.spines.Spines(**kwargs)[source]

Базовое классы: 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_* вызовы своим членам, но не может быть использован для других операций.

classmethodfrom_dict(d)[source]

classmatplotlib.spines.SpinesProxy(spine_dict)[source]

Базовое классы: object

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

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

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