matplotlib.pyplot.stem

matplotlib.pyplot.stem(*args, linefmt=None, markerfmt=None, basefmt=None, bottom=0, label=None, use_line_collection=True, data=None)[源代码]

创建一个茎图。

在每一个图上绘制垂直线。 x 从基线到 y 并在那里放置一个标记。

呼叫签名:

stem([x,] y, linefmt=None, markerfmt=None, basefmt=None)

X位置是可选的。格式可以作为位置参数或关键字参数提供。

参数:
x类似数组,可选

茎的X位置。默认值:(0,1,…,len(y)-1)。

y类数组

杆头的Y值。

linefmt可选的STR

定义垂直线属性的字符串。通常,这将是一种颜色或颜色和线条样式:

性格 线型
'-' 实线
'--' 虚线
'-.' 点划线
':' 虚线

默认值:“c0-”,即具有颜色循环的第一个颜色的实线。

注:虽然在技术上可以指定除颜色或颜色和线型以外的有效格式(例如“rx”或“-”),但这超出了方法的意图,很可能不会产生合理的绘图。

markerfmt可选的STR

在茎头上定义标记特性的字符串。默认值:“c0o”,即用颜色循环的第一个颜色填充圆。

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

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

bottom浮点,默认值:0

基线的Y位置。

labelstr,默认值:无

用于图例中的词干的标签。

use_line_collectionbool,默认值:True

如果 True ,存储并绘制干线作为 LineCollection 而不是单独的行,这将显著提高性能。如果 False ,默认为使用 Line2D 物体。以后可能会弃用此参数。

返回:
StemContainer

容器可以像元组一样处理( 标记线茎线基线

笔记

参见

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

注解

除了上述参数外,此函数还可以 data 关键字参数。如果这样的话 data 参数,其他每个参数也可以是字符串 s ,解释为 data[s] (除非引起例外)。

作为传递的对象 data 必须支持项目访问 (data[s] )和会员资格测试 (s in data

使用实例 matplotlib.pyplot.stem