mpl_toolkits.mplot3d.axes3d.Axes3D.plot_surface#
- Axes3D.plot_surface(X, Y, Z, *, norm=None, vmin=None, vmax=None, lightsource=None, axlim_clip=False, **kwargs)[source]#
创建一个曲面图。
默认情况下,它将以纯色的阴影着色,但通过提供 cmap 参数也支持色彩映射。
注意
rcount 和 ccount 关键字参数(默认为 50)决定了每个方向上使用的最大样本数。如果输入数据更大,它将被降采样(通过切片)到这些点数。
注意
为了最大化渲染速度,请考虑将 rstride 和 cstride 设置为行数减 1 和列数减 1 的除数。例如,给定 51 行,rstride 可以是 50 的任何除数。
同样,将 rstride 和 cstride 设置为 1(或 rcount 和 ccount 等于行数和列数)可以使用优化路径。
- 参数:
- X, Y, Z2D 数组
数据值。
- rcount, ccount整型
每个方向上使用的最大样本数。如果输入数据更大,它将被降采样(通过切片)到这些点数。默认为 50。
- rstride, cstride整型
每个方向上的降采样步幅。这些参数与 rcount 和 ccount 互斥。如果只设置了 rstride 或 cstride 中的一个,另一个默认为 10。
“经典”模式使用
rstride = cstride = 10
作为默认值,而不是新的默认值rcount = ccount = 50
。- color颜色
曲面补丁的颜色。
- cmapColormap,可选
曲面补丁的色彩映射。
- facecolors颜色列表,例如 颜色
每个独立补丁的颜色。
- norm
Normalize
,可选 色彩映射的归一化。
- vmin, vmax浮点型,可选
归一化的边界。
- shade布尔值,默认值:True
是否对表面颜色进行着色。当指定 cmap 时,着色总是禁用。
- lightsource
LightSource
,可选 当 *shade* 为 True 时使用的光源。
- axlim_clip布尔值, 默认值: False
是否隐藏顶点在坐标轴视图限制之外的补丁。
自 3.10 版本新增。
- **kwargs
其他关键字参数将转发给
Poly3DCollection
。