spines

matplotlib.spines¶

class matplotlib.spines.Spine(axes, spine_type, path, **kwargs)[源代码]¶

基类：matplotlib.patches.Patch

轴脊柱——记录数据区域边界的线

尖晶石是连接轴刻度线并记录数据区域边界的线。它们可以放置在任意位置。有关详细信息，请参见函数：`~matplotlib.spines.spine.set摼position'。

默认位置是 ('outward',0) .

spines是类的子类：patch，继承了它们的大部分行为。

spines根据函数：set_patch_line，函数：set_patch_circle，或函数：`~matplotlib.spines.spine.set_patch_arc`已被调用，绘制一条线、一个圆或一条弧。默认设置为“线型”。

• axes ：包含脊椎的轴实例
• spine_type ：指定脊椎类型的字符串
• path ：用于绘制脊椎的路径实例

有效Kwarg包括：

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
antialiased	未知的
capstyle	“对接”、“圆形”、“突出”
clip_box	Bbox
clip_on	布尔
clip_path	[(Path, Transform) | Patch | None]
color	颜色
contains	可赎回的
edgecolor	颜色或无或“自动”
facecolor	颜色或无
figure	Figure
fill	布尔
gid	STR
hatch	'/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout	布尔
joinstyle	'miter'、'round'、'bevel'
label	对象
linestyle	'-'、'-'、'-'、'-'、'：'、'、'、'（偏移量、开/关顺序）、…
linewidth	浮动或无默认值
path_effects	AbstractPathEffect
picker	无或bool或float或callable
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	STR
visible	布尔
zorder	浮动

classmethod arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)[源代码]¶

（ClassMethod）返回一个弧 Spine .

classmethod circular_spine(axes, center, radius, **kwargs)[源代码]¶

（StaticMethod）返回一个循环 Spine .

cla()[源代码]¶

清除当前脊椎

draw(renderer)[源代码]¶

画出 Patch 到给定的 渲染器 .

get_bounds()[源代码]¶

得到脊椎的边界。

get_patch_transform()[源代码]¶

返回 Transform 将补丁坐标转换为数据坐标的实例。

例如，可以通过为单位圆提供坐标来定义表示半径为5的圆的面片，以及将坐标（面片坐标）缩放5的变换。

get_path()[源代码]¶

返回此修补程序的路径

get_position()[源代码]¶

获取脊椎位置

get_smart_bounds()[源代码]¶

了解脊椎是否有智能边界

get_spine_transform()[源代码]¶

获取脊椎转换

get_window_extent(renderer=None)[源代码]¶

获取显示空间中的轴边界框。子类应覆盖以包含在边界框“紧密”计算中。默认值是返回0、0处的空边界框。

使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。

is_frame_like()[源代码]¶

如果直接在轴框架上，则返回true

这对于确定脊椎是否是旧样式MPL绘图的边缘很有用。如果是这样，此函数将返回true。

classmethod linear_spine(axes, spine_type, **kwargs)[源代码]¶

（StaticMethod）返回线性 Spine .

register_axis(axis)[源代码]¶

登记坐标轴

应使用轴实例中相应的脊椎来注册轴。这允许脊椎在需要时清除任何轴属性。

set_bounds(low, high)[源代码]¶

设置脊椎的边界。

set_color(c)[源代码]¶

设置边缘颜色。

参数:	c : rgba元组的颜色或序列 …参阅： set_facecolor(), set_edgecolor() 用于单独设置边缘或面颜色。

set_patch_arc(center, radius, theta1, theta2)[源代码]¶

将脊椎设置为弧形

set_patch_circle(center, radius)[源代码]¶

将脊椎设置为圆形

set_patch_line()[源代码]¶

将脊椎设置为线性

set_position(position)[源代码]¶

设置脊椎的位置

脊椎位置由2个元组（位置类型、数量）指定。职位类型为：

• “向外”：将脊椎从数据区域中移出指定数量的点。（负值指定将脊椎向内放置。）
• “轴”：将脊椎放置在指定的轴坐标（从0.0-1.0）。
• “数据”：将脊椎放在指定的数据坐标处。

此外，速记符号定义了一个特殊位置：

• '中心'->（'轴'，0.5）
• '零'->（'数据'，0.0）

set_smart_bounds(value)[源代码]¶

将脊椎和关联轴设置为具有智能边界