matplotlib.pyplot.stem#
- matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, orientation='vertical', data=None)[源代码]#
创建一个茎叶图。
茎图在每个 *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。
