matplotlib.spines

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

基类： Patch

轴脊 — 指示数据区域边界的线条。

轴脊是连接坐标轴刻度标记并指示数据区域边界的线条。它们可以放置在任意位置。有关更多信息，请参阅 set_position。

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

轴脊是 Patch 的子类，并继承了其大部分行为。

轴脊根据是否调用了 set_patch_line、 set_patch_circle 或 set_patch_arc 来绘制线条、圆形或弧线。默认是线条类型。

示例请参见 Spines。

参数:

axesAxes

包含此轴脊的 Axes 实例。

spine_typestr

轴脊类型。

pathPath

用于绘制轴脊的 Path 实例。

其他参数:

**kwargs

有效的关键字参数有：

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	未知
animated	布尔值
antialiased 或 aa	布尔值或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color	color
edgecolor 或 ec	颜色 或 None
facecolor 或 fc	颜色 或 None
figure	Figure 或 SubFigure
fill	布尔值
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 ls	{'-', '--', '-.', ':', '', (偏移量, 开/关序列), ...}
linewidth 或 lw	浮点数或 None
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
visible	布尔值
zorder	浮点数

类方法 arc_spine(axes, spine_type, center, radius, theta1, theta2, **kwargs)

创建并返回一个弧形 Spine。

类方法 circular_spine(axes, center, radius, **kwargs)

创建并返回一个圆形 Spine。

clear()

清除当前轴脊。

draw(renderer)

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

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

参数:

rendererRendererBase 子类。

备注

此方法在 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

类方法 linear_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	浮点数或 None
animated	布尔值
antialiased 或 aa	布尔值或 None
bounds	(低: 浮点数, 高: 浮点数)
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color	color
edgecolor 或 ec	颜色 或 None
facecolor 或 fc	颜色 或 None
figure	Figure 或 SubFigure
fill	布尔值
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 ls	{'-', '--', '-.', ':', '', (偏移量, 开/关序列), ...}
linewidth 或 lw	浮点数或 None
mouseover	布尔值
patch_arc	未知
patch_circle	未知
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
position	未知
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
visible	布尔值
zorder	浮点数

set_bounds(low=None, high=None)

设置轴脊边界。

参数:

low浮点数 或 None，可选

轴脊的下边界。传入 None 则不改变此限制。

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

high浮点数 或 None，可选

轴脊的上边界。传入 None 则不改变此限制。

set_color(c)

设置边线颜色。

参数:

c颜色

备注

与父类中定义的 Patch.set_color 方法不同，此方法不修改填充颜色（默认值为“none”）。使用 Patch.set_facecolor 来设置填充颜色。

set_patch_arc(center, radius, theta1, theta2)

将轴脊设置为弧形。

set_patch_circle(center, radius)

将轴脊设置为圆形。

set_patch_line()

将轴脊设置为线性。

set_position(position)

设置轴脊的位置。

轴脊位置由一个包含 (位置类型, 量) 的 2 元组指定。位置类型包括：

• 'outward'：将轴脊从数据区域向外放置指定点数。（负值将轴脊向内放置。）

• 'axes'：将轴脊放置在指定的 Axes 坐标处（0 到 1）。

• 'data'：将轴脊放置在指定的数据坐标处。

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

• 'center' -> ('axes', 0.5)

• 'zero' -> ('data', 0.0)

示例

坐标轴脊线放置

类 matplotlib.spines.Spines(**kwargs)

基类： MutableMapping

Axes 中所有 Spine 的容器。

该接口类似于字典，将名称（例如“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() 调用广播到其成员，但不能用于任何其他操作。

类方法 from_dict(d)

类 matplotlib.spines.SpinesProxy(spine_dict)

基类: object

一个代理，用于将 set_*() 和 set() 方法调用广播到所包含的 Spines。

此代理不能用于对其成员进行任何其他操作。

支持的方法是根据所包含的轴脊动态确定的。如果并非所有轴脊都支持给定方法，则仅在支持该方法的轴脊子集上执行。