mpl_toolkits.mplot3d.art3d.Poly3DCollection

class mpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort='average', shade=False, lightsource=None, **kwargs)

基类：PolyCollection

一组三维多边形。

备注

填充3D多边形

除非多边形是平面的，否则没有对三维多边形封闭表面的简单定义。

在实践中，Matplotlib 填充了多边形的二维投影。这仅对平面多边形提供了正确的填充外观。对于所有其他多边形，您会发现某些方向下，多边形的边在投影中相交。这将导致三维区域的不正确可视化。

如果你需要填充区域，建议通过 plot_trisurf 来创建它们，这将创建一个三角剖分，从而生成一致的表面。

参数:

verts列表形式的 (N, 3) 数组

多边形的序列 [verts0, verts1, ...] ，其中每个元素 verts_i 定义了多边形 i 的顶点，作为一个形状为 (N, 3) 的二维类数组。

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

z-order 的计算方法。详情请参见 set_zsort。

阴影bool, 默认: False

是否为 facecolors 和 edgecolors 添加阴影。当启用 shade 时，必须提供 facecolors 和/或 edgecolors。

Added in version 3.7.

光源 : LightSource, 可选LightSource, 可选

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

Added in version 3.7.

*args, **kwargs

所有其他参数都会传递给 PolyCollection。

注释

注意，这个类对 _facecolors 和 _edgecolors 属性进行了一些魔法操作。

do_3d_projection()

执行此对象的3D投影。

get_edgecolor()

get_facecolor()

get_vector(segments3d)

[已弃用]

注释

自 3.10 版本弃用:

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, sort_zpos=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<UNSET>, visible=<UNSET>, zorder=<UNSET>, zsort=<UNSET>)

一次性设置多个属性。

支持的属性是

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	未知
animated	布尔
抗锯齿 或 aa 或 antialiaseds	布尔值或布尔值列表
数组	类似数组或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
颜色	color 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	未知
facecolor 或 facecolors 或 fc	未知
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
linestyle 或虚线或线型或 ls	str 或 tuple 或其列表
线宽 或 linewidths 或 lw	浮点数或浮点数列表
鼠标悬停	布尔
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
偏移量	(N, 2) 或 (2,) 的类数组
path_effects	AbstractPathEffect 列表
路径	类数组列表
picker	None 或 bool 或 float 或 callable
pickradius	float
光栅化	布尔
sizes	numpy.ndarray 或 None
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
sort_zpos	未知
transform	Transform
url	str
urls	list of str 或 None
verts	列表形式的 (N, 3) 数组
verts_and_codes	未知
可见	布尔
zorder	float
zsort	{'平均', '最小', '最大'}

set_3d_properties()

set_alpha(alpha)

设置用于混合的 alpha 值 - 并非所有后端都支持。

参数:

alpha类似数组或标量或无

所有值必须在 0-1 范围内，包括 0 和 1。不支持掩码值和 nans。

set_edgecolor(colors)

设置集合的边缘颜色。

参数:

c : color 或 color 列表 或 'face'颜色或颜色列表或'face'

集合边缘颜色。如果是序列，补丁会循环使用它。如果是 'face'，则匹配面颜色。

set_facecolor(colors)

设置集合的 facecolor(s)。c 可以是一种颜色（所有补丁具有相同的颜色），或者是一个颜色序列；如果它是一个序列，补丁将循环通过该序列。

如果 c 是 'none'，补丁将不会被填充。

参数:

c : color 或 color 列表颜色或颜色列表

set_sort_zpos(val)

设置用于z排序的位置。

set_verts(verts, closed=True)

设置3D顶点。

参数:

verts列表形式的 (N, 3) 数组

多边形的序列 [verts0, verts1, ...] ，其中每个元素 verts_i 定义了多边形 i 的顶点，作为一个形状为 (N, 3) 的二维类数组。

关闭bool, 默认: True

是否应在末尾添加 CLOSEPOLY 连接以闭合多边形。

set_verts_and_codes(verts, codes)

使用路径代码设置3D顶点。

set_zsort(zsort)

设置 z-order 的计算方法。

参数:

zsort{'平均', '最小', '最大'}

在查看器的坐标系统中，应用于顶点的 z 坐标的函数，以确定 z 顺序。

使用 mpl_toolkits.mplot3d.art3d.Poly3DCollection 的示例

3D 表面图中的自定义山体阴影

Custom hillshading in a 3D surface plot

同一图中的2D和3D轴

2D and 3D Axes in same figure

生成3D多边形

Generate 3D polygons

3D 子图作为子图

3D plots as subplots

3D 表面（色图）

3D surface (colormap)

3D 表面（棋盘格）

3D surface (checkerboard)