matplotlib.pyplot.stem#

matplotlib.pyplot.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

容器可以像元组 (markerline, stemlines, baseline) 一样处理

注释

备注

这是 axes.Axes.stempyplot 封装

参见

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

使用 matplotlib.pyplot.stem 的示例#

Stem plot

Stem plot