mpl_toolkits.mplot3d.axes3d.Axes3D.voxels#

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

绘制一组填充的体素

所有体素都以1x1x1的立方体绘制在轴上,其中 filled[0, 0, 0] 以其下角放置在原点。被遮挡的面不会被绘制。

参数:
填充3D np.array of bool

一个三维的值数组,其中真值表示要填充的体素。

x, y, z3D np.array,可选

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

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

facecolors, edgecolors类似数组, 可选

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

  • 单一颜色值,用于将所有体素着色为相同颜色。这可以是一个字符串,或一个一维的 RGB/RGBA 数组。

  • None,默认情况下,使用单一颜色表示面,使用默认样式表示边。

  • 一个颜色名称的 3D ndarray,每个元素对应相应体素的颜色。尺寸必须与体素匹配。

  • 一个包含 RGB/RGBA 数据的 4D ndarray,其组件沿最后一个轴排列。

阴影bool, 默认值: True

是否为面颜色添加阴影。

光源 : LightSource, 可选LightSource, 可选

shade 为 True 时要使用的光源。

**kwargs

传递给 Poly3DCollection 的其他关键字参数。

返回:
面孔dict

一个按坐标索引的字典,其中 faces[i, j, k] 是绘制给体素 filled[i, j, k] 的面 Poly3DCollection 。如果未为给定体素绘制面,则可能是因为未要求绘制,或者它被完全遮挡,那么 (i, j, k) not in faces

示例

(Source code, 2x.png, png)

(Source code, 2x.png, png)

(Source code, 2x.png, png)

(Source code, 2x.png, png)

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

3D 体素 / 体积图

3D voxel / volumetric plot

NumPy 标志的 3D 体素图

3D voxel plot of the NumPy logo

带有RGB颜色的3D体素/体积图

3D voxel / volumetric plot with RGB colors

3D 体素 / 体积图与圆柱坐标

3D voxel / volumetric plot with cylindrical coordinates

voxels([x, y, z], filled)

voxels([x, y, z], filled)