mpl_toolkits.mplot3d.axes3d.Axes3D

class mpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, azim=- 60, elev=30, sharez=None, proj_type='persp', box_aspect=None, **kwargs)[源代码]

基类：matplotlib.axes._axes.Axes

3D轴对象。

参数:
fig图形

父图形。

rect（浮动，浮动，浮动，浮动）

这个 (left, bottom, width, height) 轴位置。

azim浮动，默认值：-60

方位视角。

elev浮动，默认值：30

视角仰角。

sharezAxes3D，可选

与共享z限制的其他轴。

proj_type{'persp'，'ortho'}

投影类型，默认为“透视”。

**kwargs

其他可选关键字参数：

财产 描述
adjustable 'box'、'datalim'
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
anchor 2-浮点数或'c'、'sw'、's'、'se'、…
animated 布尔
aspect {auto'}
autoscale_on 布尔
autoscalex_on 布尔
autoscaley_on 布尔
autoscalez_on 布尔
axes_locator 可赎回的 [[轴，渲染器]] Bbox
axisbelow 布尔或“线”
box_aspect 三元组浮点数或无浮点数
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
contains 未知的
facecolor 或fc 颜色
figure Figure
frame_on 布尔
gid STR
in_layout 布尔
label 对象
navigate 布尔
navigate_mode 未知的
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
position [左、下、宽、高] 或 Bbox
proj_type {'persp'，'ortho'}
prop_cycle 未知的
rasterization_zorder 浮动或无
rasterized 布尔或无
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
title STR
transform Transform
url STR
visible 布尔
xbound 未知的
xlabel STR
xlim3d 或xlim 未知的
xmargin 浮动大于-0.5
xscale {“线性”}
xticklabels 未知的
xticks 未知的
ybound 未知的
ylabel STR
ylim3d 或者伊林 未知的
ymargin 浮动大于-0.5
yscale {“线性”}
yticklabels 未知的
yticks 未知的
zbound 未知的
zlabel 未知的
zlim3d 或zlim 未知的
zmargin 未知的
zorder 浮动
zscale {“线性”}
zticklabels 未知的
zticks 未知的

笔记

1.2.1 新版功能: 这个 sharez公司 参数。

__init__(fig, rect=None, *args, azim=- 60, elev=30, sharez=None, proj_type='persp', box_aspect=None, **kwargs)[源代码]
参数:
fig图形

父图形。

rect（浮动，浮动，浮动，浮动）

这个 (left, bottom, width, height) 轴位置。

azim浮动，默认值：-60

方位视角。

elev浮动，默认值：30

视角仰角。

sharezAxes3D，可选

与共享z限制的其他轴。

proj_type{'persp'，'ortho'}

投影类型，默认为“透视”。

**kwargs

其他可选关键字参数：

财产 描述
adjustable 'box'、'datalim'
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
anchor 2-浮点数或'c'、'sw'、's'、'se'、…
animated 布尔
aspect {auto'}
autoscale_on 布尔
autoscalex_on 布尔
autoscaley_on 布尔
autoscalez_on 布尔
axes_locator 可赎回的 [[轴，渲染器]] Bbox
axisbelow 布尔或“线”
box_aspect 三元组浮点数或无浮点数
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
contains 未知的
facecolor 或fc 颜色
figure Figure
frame_on 布尔
gid STR
in_layout 布尔
label 对象
navigate 布尔
navigate_mode 未知的
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
position [左、下、宽、高] 或 Bbox
proj_type {'persp'，'ortho'}
prop_cycle 未知的
rasterization_zorder 浮动或无
rasterized 布尔或无
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
title STR
transform Transform
url STR
visible 布尔
xbound 未知的
xlabel STR
xlim3d 或xlim 未知的
xmargin 浮动大于-0.5
xscale {“线性”}
xticklabels 未知的
xticks 未知的
ybound 未知的
ylabel STR
ylim3d 或者伊林 未知的
ymargin 浮动大于-0.5
yscale {“线性”}
yticklabels 未知的
yticks 未知的
zbound 未知的
zlabel 未知的
zlim3d 或zlim 未知的
zmargin 未知的
zorder 浮动
zscale {“线性”}
zticklabels 未知的
zticks 未知的

笔记

1.2.1 新版功能: 这个 sharez公司 参数。

__module__ = 'mpl_toolkits.mplot3d.axes3d'
add_collection3d(col, zs=0, zdir='z')[源代码]

将三维集合对象添加到绘图中。

通过修改对象并添加Z坐标信息，二维集合类型将转换为三维版本。

支持如下：
  • PolyCollection
  • LineCollection
  • PatchCollection
add_contour_set(cset, extend3d=False, stride=5, zdir='z', offset=None)[源代码]
add_contourf_set(cset, zdir='z', offset=None)[源代码]
apply_aspect(position=None)[源代码]

根据指定的数据纵横比调整轴。

取决于 get_adjustable 这将修改轴框（位置）或视图限制。在前一种情况下， get_anchor 会影响位置。

参见

matplotlib.axes.Axes.set_aspect
有关宽高比处理的说明。
matplotlib.axes.Axes.set_adjustable
设置轴如何调整以达到所需的纵横比。
matplotlib.axes.Axes.set_anchor
设置位置以防多余空间。

笔记

这在绘制每个轴时自动调用。如果需要在绘制图形之前更新轴位置和/或视图限制，您可能需要自己调用它。

auto_scale_xyz(X, Y, Z=None, had_data=None)[源代码]
autoscale(enable=True, axis='both', tight=None)[源代码]

简单轴视图自动缩放的方便方法。见 matplotlib.axes.Axes.autoscale() 为了充分的解释。请注意，此函数的行为相同，但适用于所有三个轴。因此，可以将“z”传递给 axis ，并且“两者”适用于所有三个轴。

1.1.0 新版功能.

autoscale_view(tight=None, scalex=True, scaley=True, scalez=True)[源代码]

使用数据限制自动缩放视图限制。见 matplotlib.axes.Axes.autoscale_view() 文件。请注意，此功能适用于三维轴，因此添加了 斯夸兹 函数参数。

在 1.1.0 版更改: 更改了函数签名以更好地匹配二维版本。 紧的 现在明显是一个夸克人，排在第一位。

在 1.2.1 版更改: 现在这已经完全正常了。

bar(left, height, zs=0, zdir='z', *args, **kwargs)[源代码]

添加2D条（S）。

参数:
left一维阵列状

条左侧的X坐标。

height一维阵列状

栏杆的高度。

zs浮点数或一维数组

钢筋的Z坐标；如果指定单个值，则将对所有钢筋使用该值。

zdir{x'，y'，z}，默认值：“z”

打印二维数据时，使用的方向为z（'x'、'y'或'z'）。

**kwargs

其他参数转发到 matplotlib.axes.Axes.bar .
返回:
mpl_toolkits.mplot3d.art3d.Patch3DCollection
bar3d(x, y, z, dx, dy, dz, color=None, zsort='average', shade=True, lightsource=None, *args, **kwargs)[源代码]

生成三维条形图。

此方法创建三维条形图，其中可以唯一设置条形的宽度、深度、高度和颜色。

参数:
x，y，z类数组

钢筋锚定点的坐标。

DX，DY，DZ浮点数或类似数组的

钢筋的宽度、深度和高度。

color颜色序列，可选

条的颜色可以全局指定，也可以单独指定。此参数可以是：

  • 单一颜色，将所有条形图都涂成相同的颜色。
  • 一个长度为n条的颜色数组，用于单独为每个条上色。
  • 一个长度为6的颜色数组，用于对条形图的面进行类似的着色。
  • 一组长度为6*n条的颜色，分别为每个面着色。

当对盒子表面进行特殊着色时，这是着色顺序：

  1. -Z（框底）
  2. +Z（方框的顶部）
  3. -Y
  4. +Y
  5. -X
  6. +X
zsort可选的STR

Z轴排序方案传递到 Poly3DCollection

shadebool，默认值：True

如果为真，则会使条形图的暗边变暗（相对于绘图的光源）。

光源 ： LightSourceLightSource

使用的光源 阴影 是True。

**kwargs

任何其他关键字参数都将传递到 Poly3DCollection .
返回:
收集 ： Poly3DCollectionPoly3dCollection系列

表示条的三维多边形的集合。
can_pan()[源代码]

返回 True 如果此轴支持“平移/缩放”按钮功能。

三维轴对象不使用“平移/缩放”按钮。

can_zoom()[源代码]

返回 True 如果此轴支持缩放框按钮功能。

三维轴对象不使用“缩放框”按钮。

cla()[源代码]

清除当前轴。

clabel(*args, **kwargs)[源代码]

当前未为三维轴实现，返回 None .

contour(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)[源代码]

创建三维轮廓图。

参数:
x，y，z类数组

输入数据。

extend3dbool，默认值：False

是否在三维中延伸轮廓。

stride利息

延伸轮廓的步长。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.contour .
返回:
matplotlib.contour.QuadContourSet
contour3D(X, Y, Z, *args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)

创建三维轮廓图。

参数:
x，y，z类数组

输入数据。

extend3dbool，默认值：False

是否在三维中延伸轮廓。

stride利息

延伸轮廓的步长。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.contour .
返回:
matplotlib.contour.QuadContourSet
contourf(X, Y, Z, *args, zdir='z', offset=None, **kwargs)[源代码]

创建三维填充等高线图。

参数:
x，y，z类数组

输入数据。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.contourf .
返回:
matplotlib.contour.QuadContourSet

笔记

1.1.0 新版功能: 这个 zdir 和 抵消 参数。

contourf3D(X, Y, Z, *args, zdir='z', offset=None, **kwargs)

创建三维填充等高线图。

参数:
x，y，z类数组

输入数据。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.contourf .
返回:
matplotlib.contour.QuadContourSet

笔记

1.1.0 新版功能: 这个 zdir 和 抵消 参数。

convert_zunits(z)[源代码]

对于轴中的艺术家，如果Zaxis有单位支持，请转换 z 使用Zaxis单元类型

1.2.1 新版功能.

disable_mouse_rotation()[源代码]

禁用鼠标按钮进行三维旋转和缩放。

draw(renderer)[源代码]

使用给定的渲染器绘制艺术家（及其子对象）。

如果艺术家不可见，则此操作无效 (Artist.get_visible 返回False）。

参数:
渲染器 ： RendererBase 子类。RenderBase子类。

笔记

此方法在Artist子类中被重写。

format_coord(xd, yd)[源代码]

假设二维视图坐标试图猜测三维坐标。查找到该点的最近边，然后假定该点与该边上的最近点位于同一Z位置。

format_zdata(z)[源代码]

返回 z 字符串格式。此函数将使用 fmt_zdata 属性如果是可调用的，则返回到zaxis主格式化程序

get_autoscale_on()[源代码]

获取是否对绘图命令上的所有轴应用自动缩放

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

get_autoscalez_on()[源代码]

获取是否在绘图命令上应用Z轴的自动缩放

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

get_axis_position()[源代码]
get_frame_on()[源代码]

获取是否绘制三维轴面板。

get_proj()[源代码]

从当前查看位置创建投影矩阵。

get_tightbbox(renderer, call_axes_locator=True, bbox_extra_artists=None, *, for_layout_only=False)[源代码]

返回轴的紧边界框，包括轴及其装饰器（xlabel、title等）。

艺术家们 artist.set_in_layout(False) 不包括在bbox中。

参数:
渲染器 ： RendererBase 子类RenderBase子类

将用于绘制图形的渲染器（即 fig.canvas.get_renderer() ）

bbox_extra_artists 名单 Artist 或 None名单

要包含在紧边界框中的艺术家列表。如果 None （默认），则轴的所有艺术家子级都包含在紧边界框中。

call_axes_locatorbool，默认值：True

如果 call_axes_locator 是 False ，它不调用 _axes_locator 属性，这是获取正确边界框所必需的。 call_axes_locator=False 如果调用方只对与轴bbox相比的紧密bbox的相对大小感兴趣，则可以使用。

for_layout_only默认值：False

边界框将 not 包括标题的x范围和xlabel，或ylabel的y范围。
返回:
BboxBase

图形像素坐标中的边界框。

参见

matplotlib.axes.Axes.get_window_extent
matplotlib.axis.Axis.get_tightbbox
matplotlib.spines.Spine.get_window_extent
get_w_lims()[源代码]

获取3D世界限制。

get_xlim()

Alias get_xlim3d .

get_xlim3d()[源代码]

返回X轴视图限制。

返回:
左、右（浮标，浮标）

当前X轴限制在数据坐标中。

参见

set_xlim
set_xbound, get_xbound
invert_xaxis, xaxis_inverted

笔记

X轴可以反转，在这种情况下， left 值将大于 正确的 价值。

在 1.1.0 版更改: 这个函数现在正确地引用了3dx极限。

get_ylim()

Alias get_ylim3d .

get_ylim3d()[源代码]

返回Y轴视图限制。

返回:
底部，顶部（浮标，浮标）

当前Y轴限制在数据坐标中。

参见

set_ylim
set_ybound, get_ybound
invert_yaxis, yaxis_inverted

笔记

Y轴可以反转，在这种情况下， 底部 值将大于 top 价值。

在 1.1.0 版更改: 此函数现在正确地引用了三维Y限制。

get_zaxis()[源代码]

Return the ZAxis (Axis) instance.

get_zbound()[源代码]

按递增顺序返回z轴下限和上限。

1.1.0 新版功能.

get_zgridlines()

返回zaxis的网格线作为 Line2D S

get_zlabel()[源代码]

获取Z标签文本字符串。

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

get_zlim()

Alias get_zlim3d .

get_zlim3d()[源代码]

获取三维Z限制。

get_zmajorticklabels()

返回zaxis的主要刻度标签，作为 Text .

get_zminorticklabels()

返回zaxis的次要刻度标签，作为 Text .

get_zscale()[源代码]
get_zticklabels(minor=False, which=None)

得到扎克西的记号标签。

参数:
minor布尔

是返回次要标签还是主要标签。

which无，（‘次要’，‘主要’，‘两个’）

重写 少数的 .

选择要返回的刻度线标签
返回:
名单 Text

笔记

直到 draw 方法已调用。

参见： draw 和 draw .

get_zticklines(minor=False)

返回zaxis的记号行作为 Line2D S

get_zticks(*, minor=False)

返回数据坐标中的zaxis记号位置。

grid(b=True, **kwargs)[源代码]

设置/取消设置三维网格。

注解

当前，此函数的行为与 matplotlib.axes.Axes.grid() 但这最终是为了支持这种行为。

1.1.0 新版功能.

invert_zaxis()[源代码]

反转Z轴。

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

locator_params(axis='both', tight=None, **kwargs)[源代码]

控制刻度定位器的简便方法。

见 matplotlib.axes.Axes.locator_params() 完整的文件。请注意，这是针对axes3d对象的，因此，设置 axis “二者”将导致为所有三个轴设置参数。也， axis 也可以采用“z”值将参数应用于z轴。

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

margins(*margins, x=None, y=None, z=None, tight=True)[源代码]

设置或检索自动调整页边距的简便方法。

呼叫签名：

margins()

返回xmargin、ymargin、zmargin

margins(margin)

margins(xmargin, ymargin, zmargin)

margins(x=xmargin, y=ymargin, z=zmargin)

margins(..., tight=False)

上面的所有表单都设置了xmargin、ymargin和zmargin参数。所有关键字参数都是可选的。单个位置参数指定xmargin、ymargin和zmargin。为xmargin、ymargin和/或zmargin传递位置参数和关键字参数无效。

这个 紧的 参数传递给 autoscale_view() ，在更改保证金后执行；此处的默认值为 True 假定指定了页边距，通常不需要额外的填充来匹配刻度线。设置 紧的 到 None 将保留以前的设置。

指定任何边距只会更改自动缩放；例如，如果 X裕量 不是没有，那么 X裕量 x数据间隔在用于自动缩放之前将添加到该间隔的每一端的次数。

1.1.0 新版功能.

mouse_init(rotate_btn=1, zoom_btn=3)[源代码]

设置用于三维旋转和缩放的鼠标按钮。

参数:
rotate_btnint或int的列表，默认值：1

用于轴的三维旋转的一个或多个鼠标按钮。

zoom_btnint或int的列表，默认值：3

用于缩放三维轴的一个或多个鼠标按钮。
name = '3d'
plot(xs, ys, *args, zdir='z', **kwargs)[源代码]

绘制二维或三维数据。

参数:
xs一维阵列状

顶点的x坐标。

ys一维阵列状

顶点的y坐标。

zs浮点数或一维数组

顶点的z坐标；一个用于所有点或一个用于每个点。

zdir{x'，y'，z}，默认值：“z”

打印二维数据时，使用的方向为z（'x'、'y'或'z'）。

**kwargs

其他参数转发到 matplotlib.axes.Axes.plot .
plot3D(xs, ys, *args, zdir='z', **kwargs)

绘制二维或三维数据。

参数:
xs一维阵列状

顶点的x坐标。

ys一维阵列状

顶点的y坐标。

zs浮点数或一维数组

顶点的z坐标；一个用于所有点或一个用于每个点。

zdir{x'，y'，z}，默认值：“z”

打印二维数据时，使用的方向为z（'x'、'y'或'z'）。

**kwargs

其他参数转发到 matplotlib.axes.Axes.plot .
plot_surface(X, Y, Z, *args, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[源代码]

创建曲面图。

默认情况下，它将以纯色的阴影着色，但它也支持通过提供 cmap 参数。

注解

这个 计数 和 计数 Kwargs（默认值均为50）确定每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。

注解

要最大化渲染速度，请考虑设置 拉斯特里 和 卡斯特里 行数减1和列数减1的除数。例如，给定51行，rstride可以是50的任何除数。

类似地，设置 拉斯特里 和 卡斯特里 等于1（或 计数 和 计数 等于行数和列数）可以使用优化的路径。

参数:
x，y，z二维数组

数据值。

计数利息

每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。默认值为50。

2.0 新版功能.

CStride，CStride公司利息

在每个方向上降低采样幅度。这些论点与 计数 和 计数 . 如果只有一个 拉斯特里 或 卡斯特里 设置，其他默认值为10。

“经典”模式使用默认值 rstride = cstride = 10 而不是新的默认 rcount = ccount = 50 .

color颜色像

表面补片的颜色。

cmap色图

表面补丁的颜色图。

facecolors像数组一样的颜色。

每个补丁的颜色。

norm归一化

颜色映射的规范化。

VMN，Vmax浮动

标准化的界限。

shadebool，默认值：True

是否给脸着色。当 cmap 指定。

光源 ： LightSourceLightSource

使用的光源 阴影 是True。

**kwargs

其他参数转发到 Poly3DCollection .
plot_trisurf(*args, color=None, norm=None, vmin=None, vmax=None, lightsource=None, **kwargs)[源代码]

绘制三角形曲面。

（可选）三角测量可以用以下两种方法之一指定：

plot_trisurf(triangulation, ...)

三角测量是 Triangulation 对象，或：：

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

在这种情况下，将创建一个三角测量对象。见 Triangulation 为了解释这些可能性。

其余参数为：

plot_trisurf(..., Z)

在哪里？ Z 是要轮廓的值数组，在三角测量中每个点一个。

参数:
x，y，z类数组

数据值作为1D数组。

color

表面补片的颜色。

cmap

表面补丁的颜色图。

norm归一化

将值映射到颜色的Normalize实例。

VMN，Vmax浮点，默认值：无

要映射的最小值和最大值。

shadebool，默认值：True

是否给脸着色。当 cmap 指定。

光源 ： LightSourceLightSource

使用的光源 阴影 是True。

**kwargs

所有其他参数都传递给 Poly3DCollection

实例

(Source code _, png ， pdf ）

../../_images/trisurf3d.png

(Source code _, png ， pdf ）

../../_images/trisurf3d_2.png

1.2.0 新版功能.

plot_wireframe(X, Y, Z, *args, **kwargs)[源代码]

绘制三维线框。

注解

这个 计数 和 计数 Kwargs（默认值均为50）确定每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。

参数:
x，y，z二维数组

数据值。

计数利息

每个方向上使用的最大样本数。如果输入数据更大，它将被（通过切片）降到这些点数。将计数设置为零将导致数据不在相应方向上采样，从而生成三维线图而不是线框图。默认值为50。

2.0 新版功能.

CStride，CStride公司利息

在每个方向上降低采样幅度。这些论点与 计数 和 计数 . 如果只有一个 拉斯特里 或 卡斯特里 设置，其他默认值为1。将步幅设置为零会导致数据不按相应方向采样，从而生成三维线图而不是线框图。

“经典”模式使用默认值 rstride = cstride = 1 而不是新的默认 rcount = ccount = 50 .

**kwargs

其他参数转发到 Line3DCollection .
quiver(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs)[源代码]

绘制箭头的三维区域。

参数可以是数组或标量，只要它们可以一起广播。参数也可以是屏蔽数组。如果任何参数中的元素被屏蔽，则不会绘制相应的quiver元素。

参数:
x，y，z类数组

箭头位置的X、Y和Z坐标（默认为箭头的尾部；请参见 枢轴 夸克）。

U、 V、W类数组

箭头向量的x、y和z分量。

length浮点，默认值：1

每个箭袋的长度。

arrow_length_ratio浮点，默认值：0.3

箭头与箭袋的比率。

pivot{'tail'，'middle'，'tip'}，默认值：'tail'

位于网格点的箭头部分；箭头围绕该点旋转，因此命名为 枢轴 .

normalizebool，默认值：False

是否将所有箭头规格化为具有相同的长度，或保留由定义的长度 u ， v 和 w .

**kwargs

任何其他关键字参数都委托给 LineCollection
quiver3D(X, Y, Z, U, V, W, /, length=1, arrow_length_ratio=.3, pivot='tail', normalize=False, **kwargs)

绘制箭头的三维区域。

参数可以是数组或标量，只要它们可以一起广播。参数也可以是屏蔽数组。如果任何参数中的元素被屏蔽，则不会绘制相应的quiver元素。

参数:
x，y，z类数组

箭头位置的X、Y和Z坐标（默认为箭头的尾部；请参见 枢轴 夸克）。

U、 V、W类数组

箭头向量的x、y和z分量。

length浮点，默认值：1

每个箭袋的长度。

arrow_length_ratio浮点，默认值：0.3

箭头与箭袋的比率。

pivot{'tail'，'middle'，'tip'}，默认值：'tail'

位于网格点的箭头部分；箭头围绕该点旋转，因此命名为 枢轴 .

normalizebool，默认值：False

是否将所有箭头规格化为具有相同的长度，或保留由定义的长度 u ， v 和 w .

**kwargs

任何其他关键字参数都委托给 LineCollection
scatter(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs)[源代码]

创建散点图。

参数:
XS，YS类数组

数据位置。

zs浮点或类似数组的，默认值：0

Z位置。数组的长度与 xs 和 ys 或单个值将所有点放置在同一平面中。

zdir{'x'，'y'，'z'，'x'，'y'，'z'}，默认值：'z'

的轴方向 zs . 在三维轴上绘制二维数据时，这很有用。数据必须作为 xs ， ys . 设置 zdir 到“y”，然后将数据绘制到x-z平面。

也见 在三维图上绘制二维数据 .

s浮点或类似数组，默认值：20

以点为单位的标记大小 **2. Either an array of the same length as * XS 和 或单个值，使所有标记的大小相同。

c颜色、顺序或颜色序列，可选

标记颜色。可能值：

  • 单一颜色格式字符串。
  • 长度为n的一系列颜色。
  • 要映射到颜色的n个数字序列，使用 cmap 和 norm .
  • 一种二维数组，其中的行是rgb或rgb a。

有关更多详细信息，请参阅 c 的参数 scatter .

depthshadebool，默认值：True

是否对散布标记进行着色以显示深度的外观。每次呼叫 scatter() 将独立执行其深度着色。

**kwargs

所有其他参数都传递给 scatter .
返回:
路径 ： PathCollectionPathCollection
scatter3D(xs, ys, zs=0, zdir='z', s=20, c=None, depthshade=True, *args, **kwargs)

创建散点图。

参数:
XS，YS类数组

数据位置。

zs浮点或类似数组的，默认值：0

Z位置。数组的长度与 xs 和 ys 或单个值将所有点放置在同一平面中。

zdir{'x'，'y'，'z'，'x'，'y'，'z'}，默认值：'z'

的轴方向 zs . 在三维轴上绘制二维数据时，这很有用。数据必须作为 xs ， ys . 设置 zdir 到“y”，然后将数据绘制到x-z平面。

也见 在三维图上绘制二维数据 .

s浮点或类似数组，默认值：20

以点为单位的标记大小 **2. Either an array of the same length as * XS 和 或单个值，使所有标记的大小相同。

c颜色、顺序或颜色序列，可选

标记颜色。可能值：

  • 单一颜色格式字符串。
  • 长度为n的一系列颜色。
  • 要映射到颜色的n个数字序列，使用 cmap 和 norm .
  • 一种二维数组，其中的行是rgb或rgb a。

有关更多详细信息，请参阅 c 的参数 scatter .

depthshadebool，默认值：True

是否对散布标记进行着色以显示深度的外观。每次呼叫 scatter() 将独立执行其深度着色。

**kwargs

所有其他参数都传递给 scatter .
返回:
路径 ： PathCollectionPathCollection
set_anchor(anchor, share=False)[源代码]

定义定位点位置。

当需要固定面时，轴的实际绘图区域（活动位置）可能小于bbox（原始位置）。定位点定义绘图区域在可用空间内的位置。

参数:
anchor2-浮点数或'c'、'sw'、's'、'se'、…

锚定位置可以是：

  • 序列（一个序列） cx ， cy ） cx 和 cy 可以是0到1，其中0是左或下，1是右或上。

  • 使用基数方向作为缩写的字符串：

    • “C”表示居中
    • 底部中心为“S”（南）
    • 左下角为“西南”（西南）
    • 等。

    以下是可能职位的概述：

    “西北” “N” “NE”
    “W” “C” “e”
    “西南” “S” “SE”
sharebool，默认值：False

如果 True ，将设置应用于所有共享轴。

参见

matplotlib.axes.Axes.set_aspect
关于方面处理的描述。
set_aspect(aspect, adjustable=None, anchor=None, share=False)[源代码]

设置纵横比。

Axes 3D当前不支持任何方面，但支持“自动”，用数据限制填充轴。

若要模拟在数据空间中具有相等的纵横比，请将数据限制的比率设置为与 get_box_aspect . 要控制框纵横比，请使用 set_box_aspect .

参数:
aspect{auto'}

可能值：

价值 描述
“汽车” 自动；用数据填充位置矩形。
adjustable没有

当前被Axes3D忽略

如果没有 None ，这定义了将调整哪些参数以满足所需的方面。见 set_adjustable 更多详情。

anchor无或str或浮点2元组，可选

如果没有 None ，这定义了如果由于方面约束而有额外空间，将在何处绘制轴。指定锚的最常见方法是基本方向的缩写：

价值 描述
“C” 居中的
“西南” 左下角
“S” 底边中间
“SE” 右下角
等。  

见 set_anchor 更多详情。

sharebool，默认值：False

如果 True ，将设置应用于所有共享轴。

参见

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect
set_autoscale_on(b)[源代码]

设置是否对绘图命令应用自动缩放

1.1.0 新版功能: 此功能已添加，但未测试。请报告任何错误。

参数:
b布尔
set_autoscalez_on(b)[源代码]

设置是否在绘图命令上应用Z轴的自动缩放

1.1.0 新版功能.

参数:
b布尔
set_axis_off()[源代码]

关闭X轴和Y轴。

这会影响轴线、刻度线、刻度线标签、网格和轴标签。

set_axis_on()[源代码]

打开X轴和Y轴。

这会影响轴线、刻度线、刻度线标签、网格和轴标签。

set_box_aspect(aspect, *, zoom=1)[源代码]

设置轴框纵横比。

“长方体纵横比”是垂直于长方体的每个面查看时，以显示单位表示的高度与宽度的比率。不要将其与数据方面混淆（对于Axes3D，数据方面始终是“auto”）。默认比率为4:4:3（x:y:z）。

若要模拟在数据空间中具有相等的纵横比，请将长方体纵横比设置为与每个维度中的数据范围相匹配。

zoom 控制图形中Axes3D的总体大小。

参数:
aspect三元组浮点数或无浮点数

更改Axes3D的物理尺寸，以便显示单位中轴长度的比率为x:y:z。

如果没有，则默认为4:4:3

zoom浮动

控制图中Axes3D的总体大小。
set_frame_on(b)[源代码]

设置是否绘制三维轴面板。

参数:
b布尔
set_proj_type(proj_type)[源代码]

设置投影类型。

参数:
proj_type{'persp'，'ortho'}
set_title(label, fontdict=None, loc='center', **kwargs)[源代码]

为轴设置标题。

设置三个可用轴标题之一。可用标题位于中心轴上方，与左边缘齐平，与右边缘齐平。

参数:
labelSTR

用于标题的文本

fontdict双关语

控制标题文本外观的字典，默认值 方块 是：：

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
loc : {{'center', 'left', 'right'}}, default: rcParams["axes.titlelocation"] (default: 'center'){'center'，'left'，'right'}，默认值：

要设置的标题。

y : float, default: rcParams["axes.titley"] (default: None)浮动，默认值：

标题的垂直轴浮动（1.0为顶部）。如果没有（默认值），则自动确定y以避免轴上的装饰器。

pad : float, default: rcParams["axes.titlepad"] (default: 6.0)浮动，默认值：

标题与轴顶部的偏移量，以点为单位。
返回:
Text

表示标题的matplotlib文本实例
其他参数:
**kwargs ： Text 性质文本属性

其他关键字参数是文本属性，请参见 Text 获取有效文本属性的列表。
set_top_view()[源代码]
set_xlim(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)

Alias set_xlim3d .

set_xlim3d(left=None, right=None, emit=True, auto=False, *, xmin=None, xmax=None)[源代码]

设置三维X限制。

见 matplotlib.axes.Axes.set_xlim() 完整文件。

set_xscale(value, **kwargs)[源代码]

设置X轴比例。

参数:
value{“线性”}

要应用的轴比例类型。三维轴当前仅支持线性比例；其他比例产生无意义的结果。

**kwargs

关键字参数名义上被转发到scale类，但它们都不适用于线性比例。
set_ylim(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)

Alias set_ylim3d .

set_ylim3d(bottom=None, top=None, emit=True, auto=False, *, ymin=None, ymax=None)[源代码]

设置三维Y限制。

见 matplotlib.axes.Axes.set_ylim() 完整文件。

set_yscale(value, **kwargs)[源代码]

设置Y轴比例。

参数:
value{“线性”}

要应用的轴比例类型。三维轴当前仅支持线性比例；其他比例产生无意义的结果。

**kwargs

关键字参数名义上被转发到scale类，但它们都不适用于线性比例。
set_zbound(lower=None, upper=None)[源代码]

设置z轴的上下限。

无论参数顺序如何，此方法都将支持轴反转。它不会更改自动缩放设置 (get_autoscalez_on() ）

1.1.0 新版功能.

set_zlabel(zlabel, fontdict=None, labelpad=None, **kwargs)[源代码]

设置ZLabor。参见文档 set_ylabel 用于说明。

set_zlim(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)

Alias set_zlim3d .

set_zlim3d(bottom=None, top=None, emit=True, auto=False, *, zmin=None, zmax=None)[源代码]

设置三维Z限制。

见 matplotlib.axes.Axes.set_ylim() 完整文件

set_zmargin(m)[源代码]

在自动缩放之前设置Z数据限制的填充。

m 数据间隔在用于自动缩放之前将添加到该间隔的每一端的次数。

接受：浮动范围为0到1

1.1.0 新版功能.

set_zscale(value, **kwargs)[源代码]

设置z轴比例。

参数:
value{“线性”}

要应用的轴比例类型。三维轴当前仅支持线性比例；其他比例产生无意义的结果。

**kwargs

关键字参数名义上被转发到scale类，但它们都不适用于线性比例。
set_zticklabels(labels, *, fontdict=None, minor=False, **kwargs)

用字符串标签列表设置zaxis标签。

警告

此方法只能在使用 Axes3D.set_zticks . 否则，标签可能会出现意外的位置。

参数:
labelsstr列表

标签文本。

fontdict可选的

控制滴答标签外观的字典。默认值 方块 是：：

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
minorbool，默认值：False

是否设置次要刻度线标签而不是主要刻度线标签。
返回:
名单 Text

标签。
其他参数:
**kwargs ： Text 性质。文本属性。
set_zticks(ticks, *, minor=False)

设置zaxis的记号位置。

参数:
ticks浮动列表

勾选位置列表。

minorbool，默认值：False

如果 False ，设置主刻度；如果 True ，小滴答声。
text(x, y, z, s, zdir=None, **kwargs)[源代码]

向绘图中添加文本。Kwargs将传递到axes.text，除了 zdir 关键字，设置用作z方向的方向。

text2D(x, y, s, fontdict=None, **kwargs)

将文本添加到轴。

添加文本 s 到位置的轴 x ， y 在数据坐标中。

参数:
x, y浮动

放置文本的位置。默认情况下，这是在数据坐标中。坐标系可以使用 转型 参数。

sSTR

课文。

fontdictdict，默认值：无

用于替代默认文本属性的词典。如果fontdict为None，则默认值由 rcParams .
返回:
Text

创造的 Text 实例。
其他参数:
**kwargs ： Text 性质。文本属性。

其他杂项文本参数。

财产 描述
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
animated 布尔
backgroundcolor 颜色
bbox 带有属性的dict patches.FancyBboxPatch
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
color 或c 颜色
contains 未知的
figure Figure
fontfamily 或是家人 fontname，'serif'、'sans-serif'、'cursive'、'fantasy'、'monospace'
fontproperties 或字体或字体属性 font_manager.FontProperties or str or pathlib.Path
fontsize 或大小 浮点或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch 或者伸展 范围0-1000内的数值，'ultra condensed'、'extra condensed'、'condensed'、'semi condensed'、'normal'、'semi expanded'、'expanded'、'extra expanded'、'extra expanded'、'extra expanded'、'extra exp
fontstyle 或风格 '正常'、'斜体'、'斜体'
fontvariant 或变体 “普通”、“小大写”
fontweight 或重量 范围为0-1000、'ultralight'、'light'、'normal'、'regular'、'book'、'medium'、'roman'、'semibold'、'demi bold'、'demi'、'bold'、'heavy'、'extra bold'、'black'的数值。
gid STR
horizontalalignment 或者哈 “居中”、“右”、“左”
in_layout 布尔
label 对象
linespacing 浮动（字体大小的倍数）
multialignment 或者妈妈 '左'、'右'、'中'
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
position （浮标，浮标）
rasterized 布尔或无
rotation 浮动或{'vertical'，'horizontal'}
rotation_mode 无，'默认值'，'定位点'
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
text 对象
transform Transform
url STR
usetex 布尔或无
verticalalignment 或者弗吉尼亚 ‘中心’、‘顶部’、‘底部’、‘基线’、‘中心基线’；
visible 布尔
wrap 布尔
x 浮动
y 浮动
zorder 浮动

实例

单个关键字参数可用于重写任何给定参数：：

>>> text(x, y, s, fontsize=12)

默认转换指定文本位于数据坐标中，或者，可以指定坐标轴中的文本（（0，0）为左下角，（1，1）为右上角）。以下示例将文本放置在轴的中心：

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

您可以使用关键字在文本实例周围放置一个矩形框（例如，设置背景色）。 bbox . bbox 是一本字典 Rectangle 性质。例如：：

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))
text3D(x, y, z, s, zdir=None, **kwargs)

向绘图中添加文本。Kwargs将传递到axes.text，除了 zdir 关键字，设置用作z方向的方向。

tick_params(axis='both', **kwargs)[源代码]

更改刻度线和刻度线标签外观的方便方法。

见 matplotlib.axes.Axes.tick_params() 有关更完整的文档。

唯一的区别是设置 axis “二者”意味着设置将应用于所有三个轴。此外， axis 参数还接受值“z”，这意味着只应用于z轴。

此外，由于axes3d对象的绘制方式与常规的2d轴非常不同，因此其中一些设置的含义可能不明确。为了简单起见，“Z”轴将接受类似于“Y”轴的设置。

注解

Axes3D当前忽略其中一些设置。

1.1.0 新版功能.

tricontour(*args, extend3d=False, stride=5, zdir='z', offset=None, **kwargs)[源代码]

创建三维轮廓图。

在 1.3.0 版更改: 添加了对自定义三角测量的支持

注解

由于三维多集合渲染中的一个长期缺陷，此方法目前产生了不正确的输出。

参数:
x，y，z类数组

输入数据。

extend3dbool，默认值：False

是否在三维中延伸轮廓。

stride利息

延伸轮廓的步长。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.tricontour .
返回:
matplotlib.tri.tricontour.TriContourSet
tricontourf(*args, zdir='z', offset=None, **kwargs)[源代码]

创建三维填充等高线图。

注解

由于三维多集合渲染中的一个长期缺陷，此方法目前产生了不正确的输出。

参数:
x，y，z类数组

输入数据。

zdir{x'，y'，z}，默认值：“z”

使用说明。

offset可选浮动

如果指定，在垂直于zdir的平面上绘制此位置等高线的投影。

*args, ** 夸克

其他参数转发到 matplotlib.axes.Axes.tricontourf .
返回:
matplotlib.tri.tricontour.TriContourSet

笔记

1.1.0 新版功能: 这个 zdir 和 抵消 参数。

在 1.3.0 版更改: 添加了对自定义三角测量的支持

tunit_cube(vals=None, M=None)[源代码]
tunit_edges(vals=None, M=None)[源代码]
unit_cube(vals=None)[源代码]
update_datalim(xys, **kwargs)[源代码]

扩展 dataLim Bbox包含给定的点。

如果当前没有设置数据，Bbox将忽略其限制并将绑定设置为xydata的边界( xys ）否则，它将计算当前数据和 xys .

参数:
xys二维数组

要包含在数据限制Bbox中的点。它可以是（x，y）元组的列表，也可以是Nx2数组。

更新x，更新ybool，默认值：True

是否更新X/Y限制。
view_init(elev=None, azim=None)[源代码]

以度（而不是弧度）设置轴的仰角和方位角。

这可用于以编程方式旋转轴。

角度存储在“elev”中）azim'存储（x，y）平面的方位角（以度为单位）。

如果“elev”或“azim”为无（默认），则使用在中指定的初始值 Axes3D 建造师。

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

绘制一组填充体素

所有体素在轴上绘制为1x1x1立方体 filled[0, 0, 0] 放在原点的下角。不打印被遮挡的面。

2.1 新版功能.

参数:
filledBool的3D NP.阵列

三维值数组，其中Truthy值指示要填充的体素

x，y，z3D NP.阵列，可选

体素角的坐标。这应该传播到比 填满 . 这些可用于绘制非立方体素。

如果未指定，则默认为沿每个轴增加整数，如 indices() . 如所示 / 在函数签名中，这些参数只能按位置传递。

面色、边色类似数组，可选

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

  • 单个颜色值，以使所有体素的颜色相同。这可以是一个字符串，也可以是1d rgb/rgb a数组
  • None ，默认设置为面使用单一颜色，边使用默认样式。
  • 一个三维的颜色名称数组，每个项目对应的体素的颜色。大小必须与体素匹配。
  • 一个4d的RGB/RGBA数据数组，组件沿着最后一个轴。
shadebool，默认值：True

是否给脸着色。当 cmap 指定。

3.1 新版功能.

光源 ： LightSourceLightSource

使用的光源 阴影 是True。

3.1 新版功能.

**kwargs

要传递到的其他关键字参数 Poly3DCollection .
返回:
faces双关语

按坐标索引的字典，其中 faces[i, j, k] 是一个 Poly3DCollection 为体素绘制的面 filled[i, j, k] . 如果没有为给定的体素绘制任何面，要么是因为没有要求绘制，要么是完全封闭，那么 (i, j, k) not in faces .

实例

(Source code _, png ， pdf ）

../../_images/voxels.png

(Source code _, png ， pdf ）

../../_images/voxels_rgb.png

(Source code _, png ， pdf ）

../../_images/voxels_torus.png

(Source code _, png ， pdf ）

../../_images/voxels_numpy_logo.png
property w_xaxis
property w_yaxis
property w_zaxis
zaxis_date(tz=None)

设置轴记号和标签，将沿Z轴的数据视为日期。

参数:
tz : str or datetime.tzinfo, default: rcParams["timezone"] (default: 'UTC')str或

用于创建日期标签的时区。
zaxis_inverted()[源代码]

如果Z轴反转，则返回“真”。

1.1.0 新版功能.

使用实例 mpl_toolkits.mplot3d.axes3d.Axes3D