matplotlib.patches.StepPatch

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

基类：PathPatch

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

默认情况下，路径不闭合，并在基线值处开始和停止。

参数:

values类数组

阶梯的高度。

edges类数组

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

orientation{'vertical', 'horizontal'}，默认值: 'vertical'

阶梯的方向。`Vertical` 表示 `values` 沿 y 轴，`edges` 沿 x 轴。

baseline浮点数、类数组或 None，默认值：0

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

**kwargs

Patch 属性

属性	描述
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	字符串
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	对象
linestyle 或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth 或 lw	浮点数或 None
mouseover	布尔值
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	字符串
visible	布尔值
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>, hatch_linewidth=<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	浮点数或 None
animated	布尔值
antialiased 或 aa	布尔值或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color	color
data	一维类数组或 None
edgecolor 或 ec	颜色 或 None
facecolor 或 fc	颜色 或 None
figure	Figure 或 SubFigure
fill	布尔值
gid	字符串
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	对象
linestyle 或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth 或 lw	浮点数或 None
mouseover	布尔值
path	未知
path_effects	AbstractPathEffect 列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	字符串
visible	布尔值
zorder	浮点数

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

设置 StepPatch 值、边缘和基线。

参数:

values一维类数组或 None

如果传入 None，将不更新值

edges一维类数组，可选

baseline浮点数，一维类数组或 None

使用 matplotlib.patches.StepPatch 的示例

阶梯图演示

阶梯图演示