mpl_toolkits.mplot3d.axes3d.Axes3D.stem#
- Axes3D.stem(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', axlim_clip=False, data=None)[source]#
创建一个 3D 茎叶图。
茎叶图绘制垂直于基线的线条,并在顶部放置标记。默认情况下,基线由 x 和 y 定义,茎叶从 bottom 垂直绘制到 z。
- 参数:
- x, y, z类数组对象
茎叶顶端的位置。茎叶沿 orientation 方向从 bottom 处的基线(在 orientation 坐标中)绘制到顶端。默认情况下,x 和 y 位置用于基线,z 用于顶端位置,但这可以通过 orientation 进行更改。
- linefmtstr, 默认值: 'C0-'
一个字符串,定义垂直线的属性。通常,这会是颜色或颜色与线型的组合。
字符
线型
'-'
实线
'--'
虚线
'-.'
点划线
':'
点线
注意:虽然在技术上可以指定颜色或颜色和线型以外的有效格式(例如 'rx' 或 '-.'),但这超出了方法的意图,并且很可能不会产生合理的绘图。
- markerfmtstr, 默认值: 'C0o'
一个字符串,定义茎叶顶端标记的属性。
- basefmtstr, 默认值: 'C3-'
定义基线属性的格式字符串。
- bottomfloat, 默认值: 0
基线的位置,在 orientation 坐标中。
- labelstr, 可选
在图例中用于茎的标签。
- orientation{'x', 'y', 'z'}, 默认值: 'z'
茎叶绘制的方向。
- axlim_clip布尔值, 默认值: False
是否隐藏超出坐标轴限制的茎叶。
自 3.10 版本新增。
- data可索引对象,可选
如果给定,所有参数也接受字符串
s
,如果s
是data
中的一个键,则将其解释为data[s]
。
- 返回:
StemContainer
该容器可被视为一个元组 (markerline, stemlines, baseline)
示例