matplotlib.axes.Axes.stem#
- Axes.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位置。
- 头部类似数组
对于垂直茎图,茎头的y值。对于水平茎图,茎头的x值。
- linefmtstr, 可选
定义垂直线条颜色和/或线条样式的字符串:
角色
线条样式
'-'
实线
'--'
虚线
'-.'
虚线
':'
虚线
默认值:'C0-',即使用颜色循环中的第一种颜色绘制实线。
注意:通过此参数指定的标记(例如 'x')将被静默忽略。相反,应使用 markerfmt 指定标记。
- markerfmtstr, 可选
定义茎头标记的颜色和/或形状的字符串。如果未指定标记,则使用标记 'o',即实心圆。如果未指定颜色,则使用 linefmt 中的颜色。
- basefmtstr, 默认值: 'C3-' (经典模式下为 'C2-')
定义基线属性的格式字符串。
- 方向{'vertical', 'horizontal'}, 默认: 'vertical'
茎的取向。
- 底部float, 默认值: 0
基线的y/x位置(取决于*方向*)。
- 标签str, 可选
用于图例中茎的标签。
- 数据可索引对象,可选
如果给出,所有参数也接受一个字符串
s
,如果s
是data
中的一个键,则解释为data[s]
。
- 返回:
StemContainer
容器可以被视为一个元组(markerline,stemlines,baseline)
注释
参见
MATLAB 函数 stem 启发了这种方法。