Version 3.1.1
Matplotlib is hiring a Research Software Engineering Fellow! See discourse for details. Apply by January 3, 2020
使用mplot3d工具包生成三维绘图。
使用projection='3d'关键字创建axes3d对象与其他轴一样。创建新的 matplotlib.figure.Figure 并向其添加类型为的新轴 Axes3D ：：
import matplotlib.pyplot as plt
from mpl_toolkits.mplot3d import Axes3D
fig = plt.figure()
ax = fig.add_subplot(111, projection='3d')
1.0.0 新版功能: 此方法是创建三维轴的首选方法。
注解
在1.0.0版本之前，创建三维轴的方法是不同的。对于使用Matplotlib旧版本的用户，请更改 ax = fig.add_subplot(111, projection='3d') 到 ax = Axes3D(fig) .
见 MPLOT3D FAQ 有关mplot3d工具包的更多信息。
Axes3D.plot(xs, ys, *args, zdir='z', **kwargs)[源代码]¶绘制二维或三维数据。
| 论证 | 描述 |
|---|---|
| xs ， ys | 顶点的X、Y坐标 |
| zs | Z值，可以是一个表示所有点，也可以是一个表示每个点。 |
| zdir | 绘制二维集时用作z（“x”、“y”或“z”）的方向。 |
其他参数传递给 plot()
线三维
Axes3D.scatter(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs)[源代码]¶创建散点图。
| 参数: |
|
|---|---|
| 返回: |
|
散射三维
Axes3D.plot_wireframe(X, Y, Z, *args, **kwargs)[源代码]¶绘制三维线框。
注解
这个 计数 和 计数 Kwargs（默认值均为50）确定每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。
| 参数: |
|
|---|
线三维
Axes3D.plot_surface(X, Y, Z, *args, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[源代码]¶创建曲面图。
默认情况下，它将以纯色的阴影着色，但它也支持通过提供 cmap 争论。
注解
这个 计数 和 计数 Kwargs（默认值均为50）确定每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。
| 参数: |
|
|---|
表面三维
表面三维2
表面三维3
Axes3D.plot_trisurf(*args, color=None, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[源代码]¶| 论证 | 描述 |
|---|---|
| X ， Y ， Z | 作为一维数组的数据值 |
| 颜色 | 表面贴片的颜色 |
| cmap | 表面补丁的颜色图。 |
| norm | Normalize的一个实例，用于将值映射到颜色 |
| vmin | 要映射的最小值 |
| vmax | 要映射的最大值 |
| 阴影 | 是否为面色加阴影 |
（可选）三角测量可以用以下两种方法之一指定：
plot_trisurf(triangulation, ...)
三角测量是 Triangulation 对象，或：：
plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)
在这种情况下，将创建一个三角测量对象。见 Triangulation 为了解释这些可能性。
其余参数为：
plot_trisurf(..., Z)
在哪里？ Z 是要轮廓的值数组，在三角测量中每个点一个。
其他参数传递给 Poly3DCollection
例子：
(Source code （）
(Source code （）
1.2.0 新版功能: 此绘图功能是为v1.2.0版本添加的。
TrISURF3D
Axes3D.contour(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)[源代码]¶创建三维轮廓图。
| 论证 | 描述 |
|---|---|
| X ， Y ， | 作为numpy.array的数据值 |
| Z | |
| 扩展三维 | 是否在三维中扩展轮廓（默认值：假） |
| 步幅 | 用于延伸轮廓的步幅（步长） |
| zdir | 使用方向：x、y或z（默认） |
| 抵消 | 如有规定，在垂直于Zdir的平面上绘制该位置上轮廓线的投影。 |
位置参数和其他关键字参数传递给 contour()
返回A contour
轮廓三维
CONTUR3D 2
CONTUR3D 3
Axes3D.contourf(X, Y, Z, *args, zdir='z', offset=None, **kwargs)[源代码]¶创建三维轮廓图。
| 论证 | 描述 |
|---|---|
| X ， Y ， | 作为numpy.array的数据值 |
| Z | |
| zdir | 使用方向：x、y或z（默认） |
| 抵消 | 如有规定，在垂直于Zdir的平面上，在此位置绘制填充轮廓的投影。 |
位置参数和关键字参数传递给 contourf()
返回A contourf
在 1.1.0 版更改: 这个 zdir 和 抵消 加入了Kwargs。
CONTURF3D
1.1.0 新版功能: 第二个Contourf3d示例中演示的功能由于1.1.0版的错误修复而启用。
Axes3D.add_collection3d(col, zs=0, zdir='z')[源代码]¶将三维集合对象添加到绘图中。
通过修改对象并添加Z坐标信息，二维集合类型将转换为三维版本。
聚硅氧烷
Axes3D.bar(left, height, zs=0, zdir='z', *args, **kwargs)[源代码]¶添加2D条（S）。
| 论证 | 描述 |
|---|---|
| left | 条左侧的X坐标。 |
| 高度 | 栏杆的高度。 |
| zs | 钢筋的Z坐标，如果指定了一个值，它们都将放置在同一个Z上。 |
| zdir | 绘制二维集时用作z（“x”、“y”或“z”）的方向。 |
关键字参数传递到 bar() .
BARS3D
Axes3D.quiver(*args, length=1, arrow_length_ratio=0.3, pivot='tail', normalize=False, **kwargs)[源代码]¶绘制箭头的三维区域。
呼叫签名：
quiver(X, Y, Z, U, V, W, **kwargs)
争论：
- X ， Y ， Z ：
- 箭头位置的X、Y和Z坐标（默认为箭头的尾部；请参见 枢轴 克瓦格
- U ， V ， W ：
- 箭头向量的x、y和z分量
参数可以是数组或标量，只要它们可以一起广播。参数也可以是屏蔽数组。如果任何参数中的元素被屏蔽，则不会绘制相应的quiver元素。
关键字参数：
- 长度 ： [1乘浮标]
- 每个震颤的长度，默认为1.0，单位与轴相同。
- arrow_length_ratio ： [0.3乘浮标]
- 箭头相对于箭袋的比率，默认为0.3。
- 枢轴 ： [“尾部”“中间”“尖端”]
- 位于网格点的箭头部分；箭头围绕该点旋转，因此命名为 枢轴 . 默认为“tail”
- 归一化 布尔
- 如果为真，则所有箭头的长度都相同。这将默认为“假”，其中箭头的长度将根据u、v、w的值而不同。
任何其他关键字参数都委托给 LineCollection
奎维3D
2D采集
Axes3D.text(x, y, z, s, zdir=None, **kwargs)[源代码]¶向绘图中添加文本。Kwargs将传递到axes.text，除了 zdir 关键字，设置用作z方向的方向。
文本三维
在一个图形中有多个三维图形与在二维图形中相同。此外，您可以在同一个图形中同时使用二维和三维绘图。
1.0.0 新版功能: 在v1.0.0中添加了子绘图3D绘图。早期版本不能这样做。
亚三维