matplotlib.axes.Axes.stem #
- 轴。stem ( *args , linefmt=None , markerfmt=None , basefmt=None , bottom=0 , label=None , use_line_collection=<deprecated parameter> , orientation='vertical' , data=None ) [来源] #
创建一个茎图。
茎图在从基线到头的每个位置绘制垂直于基线 的线,并在那里放置一个标记。对于垂直茎图(默认),位置是x位置,头部是y值。对于水平茎图,位置是 y位置,头部是x值。
来电签名:
stem([locs,] heads, linefmt=None, markerfmt=None, basefmt=None)
locs位置是可选的。格式可以作为位置或关键字参数提供。自 Matplotlib 3.5 起,不推荐按位置传递markerfmt和basefmt 。
- 参数:
- locs类数组,默认:(0, 1, ..., len(heads) - 1)
对于垂直茎图,茎的 x 位置。对于水平茎图,茎的 y 位置。
- 头阵列状
对于垂直茎图,茎头的 y 值。对于水平茎图,茎头的 x 值。
- linefmt str,可选
定义垂直线的颜色和/或线条样式的字符串:
特点
线型
'-'
实线
'--'
虚线
'-.'
点划线
':'
虚线
默认值:'C0-',即颜色循环的第一种颜色的实线。
注意:通过此参数指定的标记(例如“x”)将被静默忽略(除非使用
use_line_collection=False
)。相反,应使用markerfmt指定标记。- markerfmt str,可选
定义茎头处标记的颜色和/或形状的字符串。如果没有给出标记,请使用标记“o”,即实心圆圈。如果没有给出颜色,请使用linefmt中的颜色。
- basefmt str,默认值:'C3-'(经典模式下为'C2-')
定义基线属性的格式字符串。
- 方向str,默认值:'垂直'
如果'vertical',将产生一个茎垂直方向的图,否则茎将水平方向。
- 底部浮动,默认值:0
基线的 y/x 位置(取决于方向)。
- 标签str,默认值:无
用于图例中的词干的标签。
- use_line_collection布尔值,默认值:True
自 3.6 起已弃用
如果
True
,将主干线存储和绘制为 aLineCollection
而不是单独的线,这会显着提高性能。如果False
, 默认为使用Line2D
对象列表的旧行为。- 数据可索引对象,可选
如果给定,所有参数也接受一个字符串
s
,它被解释为data[s]
(除非这引发异常)。
- 返回:
StemContainer
可以将容器视为元组(markerline、stemlines、baseline)
笔记
也可以看看
启发这种方法的 MATLAB 函数 stem 。