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
)