matplotlib.pyplot.stem#
- matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, orientation='vertical', data=None)[source]#
创建一个茎叶图。
针状图（stem plot）在每个位置 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 值。
- linefmt字符串，可选
定义垂直线条颜色和/或线型的字符串
字符
线型
'-'实线
'--'虚线
'-.'点划线
':'点线
默认值：'C0-'，即颜色循环中第一种颜色的实线。
注意：通过此参数指定的标记（例如 'x'）将被静默忽略。标记应改用 markerfmt 指定。
- markerfmt字符串，可选
定义针头标记颜色和/或形状的字符串。如果未给出标记，则使用 'o'，即实心圆。如果未给出颜色，则使用 linefmt 中的颜色。
- basefmt字符串，默认值：'C3-'（经典模式下为 'C2-'）
定义基线属性的格式字符串。
- orientation{'vertical', 'horizontal'}，默认值: 'vertical'
针的朝向。
- bottomfloat, 默认值: 0
基线的 y/x 位置（取决于 orientation）。
- labelstr, 可选
在图例中用于茎的标签。
- data可索引对象，可选
如果提供，所有参数也接受字符串
s，如果s是data中的键，则将其解释为data[s]。
- 返回:
StemContainer该容器可被视为一个元组 (markerline, stemlines, baseline)
备注
注意
这是 pyplot 包装器，对应
axes.Axes.stem。另请参阅
MATLAB 函数 stem，此方法即受其启发。
