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 级别的 1D 序列。

fmtstr, 可选

格式字符串,例如 'g' 表示绿色线条。更多详细描述请参见 plot

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

哪里{'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 位置之间的中间。

数据可索引对象,可选

带有标签数据的对象。如果提供,请提供要在 xy 中绘制的标签名称。

**kwargs

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

返回:
Line2D 的列表

表示绘制数据的物体。

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

步骤演示

Step Demo

stairs(values)

stairs(values)