matplotlib.spines

classmatplotlib.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, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
`alpha`	неизвестно
`animated`	bool
`antialiased` или aa	bool или None
`capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`clip_box`	`BboxBase` или None
`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	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
`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`	str
`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`	`BboxBase` или None
`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	{'-', '--', '-.', ':', '', (смещение, последовательность вкл/выкл), ...}
`linewidth` или lw	float или None
`mouseover`	bool
`patch_arc`	неизвестно
`patch_circle`	неизвестно
`path_effects`	список `AbstractPathEffect`
`picker`	None или bool или float или вызываемая функция
`position`	неизвестно
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	float

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

Установка границ отрезка.

Parameters:

lowfloat или None, optional

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

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

highfloat или None, optional

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

classmethodfrom_dict(d)[source]

classmatplotlib.spines.SpinesProxy(spine_dict)[source]

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

Прокси для трансляции методов set_*() и set() к содержащим Spines.

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

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