matplotlib.pyplot.step#

matplotlib.pyplot.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 列表

表示绘制数据的对象。

备注

注意

这是 pyplot 封装,用于 axes.Axes.step

使用 matplotlib.pyplot.step 的示例#

阶梯图演示

阶梯图演示

步进图演示

步进图演示