matplotlib.patches.StepPatch

class matplotlib.patches.StepPatch(values, edges, *, orientation='vertical', baseline=0, **kwargs)

基类：PathPatch

描述阶梯常数函数的补丁路径。

默认情况下，路径不闭合，并且从基线值开始和结束。

参数:

值类似数组

台阶高度。

边缘类似数组

边缘位置，其中 len(edges) == len(vals) + 1，曲线在这些位置之间取 vals 值。

方向{'垂直', '水平'}, 默认: '垂直'

步骤的方向。垂直意味着 值 沿着 y 轴，而边沿着 x 轴。

基线float, array-like 或 None, 默认值: 0

边界边缘的底部值，或者当 fill=True 时，下边缘的位置。如果 fill 为 True 或传递给 baseline 的是一个数组，则绘制一个闭合路径。

**kwargs

补丁 属性：

属性	描述
agg_filter	一个过滤函数，它接收一个 (m, n, 3) 的浮点数数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量。
alpha	未知
animated	布尔
抗锯齿 或 aa	布尔值或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
颜色	color
edgecolor 或 ec	color or None
facecolor 或 fc	color or None
figure	Figure 或 SubFigure
fill	布尔
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
线型 或 ls	{'-', '--', '-.', ':', '', (偏移, 开-关-序列), ...}
linewidth 或 lw	浮点数或无
鼠标悬停	布尔
path_effects	AbstractPathEffect 的列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

get_data()

获取 StepPatch 的值、边缘和基线作为命名元组。

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, data=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, path=<UNSET>, path_effects=<UNSET>, picker=<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	标量或无
animated	布尔
抗锯齿 或 aa	布尔值或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
颜色	color
数据	一维数组类或无
edgecolor 或 ec	color or None
facecolor 或 fc	color or None
figure	Figure 或 SubFigure
fill	布尔
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
线型 或 ls	{'-', '--', '-.', ':', '', (偏移, 开-关-序列), ...}
linewidth 或 lw	浮点数或无
鼠标悬停	布尔
路径	未知
path_effects	AbstractPathEffect 的列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_data(values=None, edges=None, baseline=None)

设置 StepPatch 的值、边缘和基线。

参数:

值一维数组类或无

如果传递 None，将不会更新值

边缘一维数组类，可选

基线浮点数、一维类数组或无

使用 matplotlib.patches.StepPatch 的示例

楼梯演示

Stairs Demo