mpl_toolkits.mplot3d.axes3d.Axes3D.voxels#

Axes3D.voxels([x, y, z, ]/, filled, facecolors=None, edgecolors=None, **kwargs)[source]#

绘制一组实心体素。

所有体素都作为 1x1x1 的立方体绘制在坐标轴上，其中 filled[0, 0, 0] 的下角位于原点。被遮挡的面不会被绘制。

参数:

filled3D np.array of bool

一个 3D 布尔值数组，其中真值表示要填充的体素。

x, y, z3D np.array, 可选

体素角的坐标。其形状应在每个维度上比 filled 的形状大一。这些参数可用于绘制非立方体体素。

如果未指定，则默认为沿每个轴递增的整数，类似于 indices() 返回的值。如函数签名中的 / 所示，这些参数只能按位置传递。

facecolors, edgecolorsarray-like, 可选

用于绘制体素面和边缘的颜色。只能作为关键字参数传递。这些参数可以是：

shade布尔值，默认值：True

是否对表面颜色进行着色。

lightsourceLightSource, 可选

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

axlim_clip布尔值, 默认值: False

是否隐藏坐标轴视图限制之外的体素点。

自 3.10 版本新增。

**kwargs

传递给 Poly3DCollection 的附加关键字参数。

返回:

facesdict: 一个以坐标为索引的字典，其中 faces[i, j, k] 是为体素 filled[i, j, k] 绘制的面的 Poly3DCollection。如果某个体素未绘制任何面（可能是因为未要求绘制，或完全被遮挡），则 (i, j, k) not in faces。