matplotlib.spines

classmatplotlib.spines.Spine(axes, spine_type, path, **kwargs)[source]

Основания: 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`	Функция фильтра, которая принимает массив (m, n, 3) с плавающей запятой и значение 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	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
`linewidth` или lw	число с плавающей запятой или None
`path_effects`	`AbstractPathEffect`
`picker`	None или bool или число с плавающей запятой или вызываемая функция
`rasterized`	bool
`sketch_params`	(масштаб: число с плавающей запятой, длина: число с плавающей запятой, случайность: число с плавающей запятой)
`snap`	bool или None
`transform`	`Transform`
`url`	строка
`visible`	bool
`zorder`	число с плавающей запятой

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

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

cla()[source]: [Устаревшее]

Примечания

Устарело начиная с версии 3.4:

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>, 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	float или None
`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`	число с плавающей точкой

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

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

Parameters

lowfloat или None, optional

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

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

highfloat или None, optional

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

set_color(c)[source]

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

Parameters

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]

Базы: collections.abc.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.

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

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