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类数组
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
。