mpl_toolkits.mplot3d.axes3d.Axes3D.bar3d#
- Axes3D.bar3d(x, y, z, dx, dy, dz, color=None, zsort='average', shade=True, lightsource=None, *args, axlim_clip=False, data=None, **kwargs)[source]#
生成一个 3D 条形图。
此方法创建一个三维条形图,其中条形的宽度、深度、高度和颜色都可以唯一设置。
- 参数:
- x, y, z类数组对象
条形图锚点的坐标。
- dx, dy, dz浮点数或类数组对象
分别为条形的宽度、深度和高度。
- color颜色序列,可选
条形的颜色可以全局指定,也可以单独指定。此参数可以是:
单一颜色,用于将所有条形着色为相同颜色。
长度为N个条形的颜色数组,用于独立着色每个条形。
长度为6的颜色数组,用于类似地着色条形的各个面。
长度为6*N个条形的颜色数组,用于独立着色每个面。
当专门为箱体着色时,颜色顺序如下:
-Z(箱体底部)
+Z(箱体顶部)
-Y
+Y
-X
+X
- zsort{'average', 'min', 'max'},默认值:'average'
传递给
Poly3DCollection
的z轴排序方案。- shade布尔值,默认值:True
当为True时,这将为条形的暗面(相对于绘图的光源)着色。
- lightsource
LightSource
,可选 当 *shade* 为 True 时使用的光源。
- axlim_clip布尔值, 默认值: False
是否隐藏轴视图限制之外的条形。
自 3.10 版本新增。
- data可索引对象,可选
如果给定,所有参数也接受一个字符串
s
,如果s
是data
中的键,则将其解释为data[s]
。- **kwargs
任何附加的关键字参数都将传递给
Poly3DCollection
。
- 返回:
- collection
Poly3DCollection
表示条形图的三维多边形集合。
- collection