matplotlib.spines

classmatplotlib.spines.Spine(axes, spine_type, path, **kwargs)[исходный код]

Базовые классы: 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` or `aa`	bool или None
`capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color`	цвет
`edgecolor` or `ec`	цвет или None
`facecolor` or `fc`	цвет или None
`figure`	`Figure` или `SubFigure`
`fill`	bool
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	неизвестно
`in_layout`	bool
`joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`label`	object
`linestyle` or `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` or `lw`	float или None
`mouseover`	bool
`path_effects`	список объектов `AbstractPathEffect`
`picker`	None, bool, float или вызываемый объект
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool или None
`transform`	`Transform`
`url`	str
`visible`	bool
`zorder`	float

classmethodarc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)[исходный код]: Создает и возвращает дуговую Spine.

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

clear()[исходный код]: Очищает текущую линию оси.

draw(renderer)[исходный код]

Рисует Artist (и его дочерние объекты) с помощью указанного средства отрисовки.

Ничего не делает, если объект artist не виден (метод Artist.get_visible возвращает False).

Параметры:

rendererподкласс RendererBase.

Примечания

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

get_bounds()[исходный код]: Возвращает границы линии оси.

get_patch_transform()[исходный код]

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

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

get_path()[исходный код]: Возвращает контур этого патча.

get_position()[исходный код]: Возвращает позицию линии оси.

get_spine_transform()[исходный код]: Возвращает преобразование линии оси.

get_window_extent(renderer=None)[исходный код]

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

См. также

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

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

register_axis(axis)[исходный код]

Регистрирует ось.

Ось следует зарегистрировать в соответствующей ей линии оси экземпляра 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>, hatch_linewidth=<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>)[источник]

Задать несколько свойств одновременно.

Поддерживаются следующие свойства:

Свойство	Описание
`agg_filter`	функция фильтра, принимающая массив чисел с плавающей точкой формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от левого нижнего угла изображения
`alpha`	float или None
`animated`	bool
`antialiased` or `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` or `ec`	цвет или None
`facecolor` or `fc`	цвет или None
`figure`	`Figure` или `SubFigure`
`fill`	bool
`gid`	str
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	неизвестно
`in_layout`	bool
`joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`label`	object
`linestyle` or `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` or `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`	str
`visible`	bool
`zorder`	float

set_bounds(low=None, high=None)[источник]

Задать границы осевой линии.

Параметры:

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

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

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

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

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

set_color(c)[источник]

Задать цвет границы.

Параметры:

cцвет

Примечания

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

set_patch_arc(center, radius, theta1, theta2)[источник]: Задать осевую линию в виде дуги.

set_patch_circle(center, radius)[источник]: Задать осевую линию в виде окружности.

set_patch_line()[источник]: Задать осевую линию в виде прямой.

set_position(position)[источник]

Задать положение осевой линии.

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

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

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

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

Примеры

Размещение осевых линий

classmatplotlib.spines.Spines(**kwargs)[источник]

Базовые классы: 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)[источник]

classmatplotlib.spines.SpinesProxy(spine_dict)[источник]

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

Прокси для распространения вызовов методов set_*() и set() на содержащиеся в нём объекты Spines.

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

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