mpl_toolkits.mplot3d.axes3d.Axes3D.stem3D#
- Axes3D.stem3D(x, y, z, *, linefmt='C0-', markerfmt='C0o', basefmt='C3-', bottom=0, label=None, orientation='z', axlim_clip=False, data=None)[源]#
创建一个 3D 茎叶图。
杆状图绘制垂直于基线的线条,并在顶端放置标记。默认情况下,基线由 x 和 y 定义,杆线从 bottom 垂直绘制到 z。
- 参数:
- x, y, z类数组对象
杆线顶端的位置。杆线沿着 orientation 方向从 bottom 处的基线(在 orientation 坐标中)绘制到顶端。默认情况下,x 和 y 位置用于基线,z 用于顶端位置,但这可以通过 orientation 参数进行更改。
- linefmt字符串,默认值: 'C0-'
定义垂直线条属性的字符串。通常,这会是一个颜色或颜色与线条样式的组合。
字符
线型
'-'
实线
'--'
虚线
'-.'
点划线
':'
点线
注意:虽然技术上可以指定除颜色或颜色和线条样式之外的有效格式(例如 'rx' 或 '-.'),但这超出了此方法的意图,并且很可能无法生成合理的绘图。
- markerfmt字符串,默认值: 'C0o'
定义杆线顶端标记属性的字符串。
- basefmt字符串,默认值: '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)
示例