matplotlib.axes.Axes.stem#

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

创建一个茎叶图。

茎图在基线上的每个位置 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位置。

头部类似数组

对于垂直茎图,茎头的y值。对于水平茎图,茎头的x值。

linefmtstr, 可选

定义垂直线条颜色和/或线条样式的字符串:

角色

线条样式

'-'

实线

'--'

虚线

'-.'

虚线

':'

虚线

默认值:'C0-',即使用颜色循环中的第一种颜色绘制实线。

注意:通过此参数指定的标记(例如 'x')将被静默忽略。相反,应使用 markerfmt 指定标记。

markerfmtstr, 可选

定义茎头标记的颜色和/或形状的字符串。如果未指定标记,则使用标记 'o',即实心圆。如果未指定颜色,则使用 linefmt 中的颜色。

basefmtstr, 默认值: 'C3-' (经典模式下为 'C2-')

定义基线属性的格式字符串。

方向{'vertical', 'horizontal'}, 默认: 'vertical'

茎的取向。

底部float, 默认值: 0

基线的y/x位置(取决于*方向*)。

标签str, 可选

用于图例中茎的标签。

数据可索引对象,可选

如果给出,所有参数也接受一个字符串 s,如果 sdata 中的一个键,则解释为 data[s]

返回:
StemContainer

容器可以被视为一个元组(markerlinestemlinesbaseline

注释

参见

MATLAB 函数 stem 启发了这种方法。

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

Stem plot

Stem plot

图例演示

Legend Demo

3D 茎

3D stem

stem(x, y)

stem(x, y)

stem(x, y, z)

stem(x, y, z)