matplotlib.axes.Axes.step#

Axes.step(x, y, *args, where='pre', data=None, **kwargs)[源]#

绘制阶梯图。

调用签名

step(x, y, [fmt], *, data=None, where='pre', **kwargs)
step(x, y, [fmt], x2, y2, [fmt2], ..., *, where='pre', **kwargs)

这只是一个围绕 plot 的轻量级封装,它改变了一些格式选项。plot 的大部分概念和参数也可在此处使用。

注意

此方法使用具有阶梯绘制样式的标准绘图:x 值是参考位置,阶梯线根据 where 参数向左/向右/向两侧延伸。

对于已知阶梯值的常见情况,请改用 stairs

参数:
x类数组

x 位置的一维序列。假定(但未检查)其均匀递增。

y类数组

y 级别的一维序列。

fmtstr,可选

格式字符串,例如 'g' 表示绿线。有关更详细的说明,请参见 plot

注意:虽然接受完整的格式字符串,但建议仅指定颜色。线型目前被忽略(请改用关键字参数 linestyle)。标记被接受并绘制在给定位置上,然而,这对于阶梯图来说是一个很少需要的功能。

where{'pre', 'post', 'mid'}, 默认值: 'pre'

定义阶梯线应放置的位置

  • 'pre':y 值在每个 x 位置处向左持续不变,即区间 (x[i-1], x[i]] 的值为 y[i]

  • 'post':y 值在每个 x 位置处向右持续不变,即区间 [x[i], x[i+1]) 的值为 y[i]

  • 'mid': 阶梯发生在 x 位置的中间。

data可索引对象,可选

一个带标签数据的对象。如果给出,则提供要在 *x* 和 *y* 中绘制的标签名称。

**kwargs

附加参数与 plot 的参数相同。

返回:
Line2D 列表

表示绘制数据的对象。

使用示例 matplotlib.axes.Axes.step#

步进图演示

步进图演示

stairs(values)

stairs(values)