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个条形的颜色数组,用于独立着色每个面。

当专门为箱体着色时,颜色顺序如下:

  1. -Z(箱体底部)

  2. +Z(箱体顶部)

  3. -Y

  4. +Y

  5. -X

  6. +X

zsort{'average', 'min', 'max'},默认值:'average'

传递给 Poly3DCollection 的z轴排序方案。

shade布尔值,默认值:True

当为True时,这将为条形的暗面(相对于绘图的光源)着色。

lightsourceLightSource,可选

当 *shade* 为 True 时使用的光源。

axlim_clip布尔值, 默认值: False

是否隐藏轴视图限制之外的条形。

自 3.10 版本新增。

data可索引对象,可选

如果给定,所有参数也接受一个字符串 s,如果 sdata 中的键,则将其解释为 data[s]

**kwargs

任何附加的关键字参数都将传递给 Poly3DCollection

返回:
collectionPoly3DCollection

表示条形图的三维多边形集合。

使用 mpl_toolkits.mplot3d.axes3d.Axes3D.bar3d 的示例#

三维条形图演示

三维条形图演示

创建二维数据的三维直方图

创建二维数据的三维直方图

bar3d(x, y, z, dx, dy, dz)

bar3d(x, y, z, dx, dy, dz)