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

Примеры см. на странице Оси.

Parameters:

axesAxes: Экземпляр Axes, содержащий ось.
spine_typestr: Тип оси.
pathPath: Экземпляр Path, используемый для рисования оси.

Other Parameters:

**kwargs

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

Свойство	Описание
`agg_filter`	Функция фильтра, которая принимает (m, n, 3) массив float и значение dpi, и возвращает (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`	строка
`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 или callable
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: 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).

Параметры:

rendererRendererBase подкласс.

Примечания

Этот метод переопределён в подклассах элементов графического интерфейса.

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`	функция фильтра, которая принимает массив float (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	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
`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]

Установка границ колючки.

Параметры:

lowчисло с плавающей точкой или None, необязательно

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

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

highчисло с плавающей точкой или 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]

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

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

'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.

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

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