matplotlib.spines

class matplotlib.spines.Spine(axes, spine_type, path, **kwargs)

基类：matplotlib.patches.Patch

一个轴轴--记录数据区域边界的线。

脊椎是连接轴刻度线并标注数据区域边界的线。它们可以放在任意位置。看到了吗 set_position 更多信息。

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

脊骨是脊骨的亚类 Patch 继承了他们的很多行为。

脊椎画一条线、一个圆或一个弧，这取决于 set_patch_line ， set_patch_circle 或 set_patch_arc 已调用。“Line like”是默认值。

参数:

axes ： Axes轴线

这个 Axes 包含脊椎的实例。

spine_typeSTR

脊椎类型。

path ： Path路径

这个 Path 用于绘制脊椎的实例。

其他参数:

**kwargs

有效的关键字参数为：

财产	描述
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
animated	布尔
antialiased 或者aa	未知的
capstyle	“对接”、“圆形”、“突出”
clip_box	Bbox
clip_on	布尔
clip_path	面片或（路径、变换）或无
color	颜色
contains	未知的
edgecolor 或ec	颜色或无或“自动”
facecolor 或fc	颜色或无
figure	Figure
fill	布尔
gid	STR
hatch	'/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout	布尔
joinstyle	'miter'、'round'、'bevel'
label	对象
linestyle 或ls	'-'、'-'、'-'、'-'、'：'、'、'、'（偏移量、开/关顺序）、…
linewidth 或lw	浮动或无
path_effects	AbstractPathEffect
picker	无、布尔或可呼叫
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	STR
visible	布尔
zorder	浮动

classmethod arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)

创建并返回圆弧 Spine .

classmethod circular_spine(axes, center, radius, **kwargs)

创建循环并返回 Spine .

cla()

清除当前脊椎。

draw(renderer)

使用给定的渲染器绘制艺术家（及其子对象）。

如果艺术家不可见，则此操作无效 (Artist.get_visible 返回False）。

参数:

渲染器 ： RendererBase 子类。RenderBase子类。

笔记

此方法在Artist子类中被重写。

get_bounds()

得到脊椎的边界。

get_patch_transform()

返回 Transform 实例将面片坐标映射到数据坐标。

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

get_path()

返回此修补程序的路径。

get_position()

返回脊椎位置。

get_smart_bounds()

[Deprecated] 返回脊椎是否有智能边界。

笔记

3.2 版后已移除.

get_spine_transform()

返回脊椎变换。

get_window_extent(renderer=None)

返回显示空间中脊椎的窗口范围，包括记号的填充（但不包括其标签）

参见

matplotlib.axes.Axes.get_tightbbox

matplotlib.axes.Axes.get_window_extent

classmethod linear_spine(axes, spine_type, **kwargs)

创建并返回线性 Spine .

register_axis(axis)

注册轴。

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

set_bounds(low=None, high=None)

设置脊椎边界。

参数:

low浮动或无，可选

下脊椎被束缚。经过 None 保持限制不变。

边界也可以作为元组传递( low ， high )作为第一个位置参数。

high浮动或无，可选

更高的脊椎骨。经过 None 保持限制不变。

set_color(c)

设置边缘颜色。

参数:

c颜色

笔记

与 Patch.set_color 方法在父类中定义。使用 Patch.set_facecolor 设置面颜色。

set_patch_arc(center, radius, theta1, theta2)

将脊椎设置为弧形。

set_patch_circle(center, radius)

将脊椎设置为圆形。

set_patch_line()

将脊椎设置为线性。

set_position(position)

设置脊椎的位置。

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

• “向外”：按指定的点数将脊椎从数据区域向外放置。（负值将脊椎向内放置。）
• “轴”：将脊椎放置在指定的轴坐标（0到1）处。
• “数据”：将脊椎放置在指定的数据坐标处。

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

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

set_smart_bounds(value)

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

笔记

3.2 版后已移除.