matplotlib.axes.Axes.stem#
- Axes.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, orientation='vertical', data=None)[source]#
创建一个茎叶图。
茎叶图在每个位置 locs 处绘制垂直于基线的线,从基线到 heads,并在那里放置一个标记。对于垂直茎叶图(默认),locs 是 x 坐标,heads 是 y 值。对于水平茎叶图,locs 是 y 坐标,heads 是 x 值。
调用签名
stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)
locs 位置是可选的。linefmt 可以作为位置参数提供,但所有其他格式都必须作为关键字参数提供。
- 参数:
- locs类数组对象,默认值: (0, 1, ..., len(heads) - 1)
对于垂直茎叶图,茎的 x 坐标。对于水平茎叶图,茎的 y 坐标。
- heads类数组对象
对于垂直茎叶图,茎头部的 y 值。对于水平茎叶图,茎头部的 x 值。
- linefmtstr, 可选
定义垂直线的颜色和/或线型的字符串
字符
线型
'-'
实线
'--'
虚线
'-.'
点划线
':'
点线
默认值: 'C0-',即颜色循环中的第一个颜色的实线。
注意: 通过此参数指定的标记(例如 'x')将被静默忽略。标记应改用 markerfmt 指定。
- markerfmtstr, 可选
定义茎头部标记的颜色和/或形状的字符串。如果未给出标记,则使用标记 'o',即实心圆。如果未给出颜色,则使用 linefmt 中的颜色。
- basefmtstr, 默认值: 'C3-'(经典模式下为 'C2-')
定义基线属性的格式字符串。
- orientation{'vertical', 'horizontal'},默认值: 'vertical'
茎的方向。
- bottomfloat, 默认值: 0
基线的 y/x 坐标(取决于 orientation)。
- labelstr, 可选
在图例中用于茎的标签。
- data可索引对象,可选
如果给出,所有参数也接受一个字符串
s
,如果s
是data
中的一个键,则将其解释为data[s]
。
- 返回:
StemContainer
该容器可被视为一个元组 (markerline, stemlines, baseline)
备注
另请参阅
启发此方法的 MATLAB 函数 stem。