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 位置的 1D 序列。假设其为均匀递增(未进行检查)。

y类数组

y 水平值的 1D 序列。

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 列表

表示绘制数据的对象。

备注

注意

这是 axes.Axes.step 的 pyplot 封装。

使用 matplotlib.pyplot.step 的示例#

阶梯图演示

阶梯图演示

步进图演示

步进图演示