matplotlib.axes.Axes.stem#

Axes.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, orientation='vertical', data=None)[source]#

创建一个茎叶图。

茎叶图在每个位置 locs 处绘制垂直于基线的线,从基线到 heads,并在那里放置一个标记。对于垂直茎叶图(默认),locsx 坐标,headsy 值。对于水平茎叶图,locsy 坐标,headsx 值。

调用签名

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,如果 sdata 中的一个键,则将其解释为 data[s]

返回:
StemContainer

该容器可被视为一个元组 (markerline, stemlines, baseline)

备注

另请参阅

启发此方法的 MATLAB 函数 stem

使用 matplotlib.axes.Axes.stem 的示例#

茎叶图

茎叶图

三维茎叶图

三维茎叶图

图例演示

图例演示

stem(x, y, z)

stem(x, y, z)

stem(x, y)

stem(x, y)