mpl_toolkits.mplot3d.axes3d.Axes3D

mpl_toolkits.mplot3d.axes3d类。Axes3D ( fig , rect = None , * args , elev = 30 , azim = -60 , roll = 0 , sharez = None , proj_type = 'persp' , box_aspect = None , computed_zorder = True , focus_length = None , ** kwargs )

基地：Axes

3D 轴对象。

参数：

无花果图

父图。

矩形元组（左、下、宽、高），默认值：无。

坐标轴位置。(left, bottom, width, height)

高度浮动，默认值：30

仰角以度为单位在 xy 平面上方和下方旋转相机，正角对应于平面上方的位置。

azim浮点数，默认值：-60

以度为单位的方位角使相机围绕 z 轴旋转，正角对应于右手旋转。换句话说，正方位角使相机围绕原点从其沿+x 轴的位置向+y 轴旋转。

滚动浮动，默认值：0

以度为单位的滚动角使相机围绕观察轴旋转。正角度使相机顺时针旋转，导致场景逆时针旋转。

sharez Axes3D，可选

与其他轴共享 z 限制。

proj_type {'persp', 'ortho'}

投影类型，默认为'persp'。

box_aspect 三元组浮点数，默认值：无

更改 Axes3D 的物理尺寸，以使显示单位中的轴长度比为 x:y:z。如果没有，默认为 4:4:3

computed_zorder布尔值，默认值：True

Artist如果为 True，则根据s 沿视图方向的平均位置计算绘制顺序。如果您想使用zorder 属性手动控制艺术家在彼此之上绘制的顺序，请设置为 False 。如果自动订单没有产生预期的结果，这可以用于微调。但是请注意，手动 zorder 仅适用于有限的视角。如果图形被用户旋转，从某些角度看它是错误的。

auto_add_to_figure布尔值，默认值：False

在 Matplotlib 3.4 之前，Axes3D 会在初始化时将自己添加到它们的主机图形中。其他 Axes 类不这样做。

此行为在 3.4 中已弃用，默认值在 3.6 中更改为 False。在 3.7 中，该关键字将是未记录的，并且非 False 值将是一个错误。

focus_length浮点数，默认值：无

对于“透视”的投影类型，虚拟相机的焦距。必须 > 0。如果没有，默认为 1。对于“正交”投影类型，必须设置为无或无穷大 (numpy.inf)。如果没有，默认为无穷大。焦距可以通过以下等式从所需的视场计算：focal_length = 1/tan(FOV/2)

**kwargs

其他可选关键字参数：

财产	描述
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	布尔
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalz'}
autoscale_on	布尔
autoscalex_on	未知
autoscaley_on	未知
autoscalez_on	未知
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或“线”
box_aspect	浮点数的三元组或无
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
facecolor或 fc	颜色
figure	Figure
frame_on	布尔
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
navigate	布尔
navigate_mode	未知
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高] 或Bbox
proj_type	{'persp', '正交'}
prop_cycle	未知
rasterization_zorder	浮动或无
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	未知
transform	Transform
url	字符串
visible	布尔
xbound	未知
xlabel	字符串
xlim或 xlim3d	（底部：浮动，顶部：浮动）
xlim3d	（底部：浮动，顶部：浮动）
xmargin	浮动大于 -0.5
xscale	未知
xticklabels	未知
xticks	未知
ybound	未知
ylabel	字符串
ylim或 ylim3d	（底部：浮动，顶部：浮动）
ylim3d	（底部：浮动，顶部：浮动）
ymargin	浮动大于 -0.5
yscale	未知
yticklabels	未知
yticks	未知
zbound	未知
zlabel	未知
zlim或 zlim3d	未知
zmargin	浮动大于 -0.5
zorder	漂浮
zscale	未知
zticklabels	未知
zticks	未知

add_collection3d ( col , zs = 0 , zdir = 'z' )

将 3D 集合对象添加到绘图中。

通过修改对象并添加 z 坐标信息，将 2D 集合类型转换为 3D 版本。

支持的是：

• 多集合

• 线集

• 补丁集合

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会影响位置。

参数：

位置无或 .Bbox

如果不是None，则将图中轴的位置定义为 Bbox。有关详细信息，请参阅get_position 。

也可以看看

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 )

自动缩放（启用=真，轴= '两者'，紧密=无）

简单轴视图自动缩放的便捷方法。

有关Axes.autoscale完整文档，请参阅。因为此功能适用于 3D 轴，所以也可以将轴设置为“z”，将轴设置 为“两者”会自动缩放所有三个轴。

autoscale_view (紧= None , scalex = True , scaley = True , scalez = True )

使用数据限制自动缩放视图限制。

有关Axes.autoscale_view完整文档，请参阅。因为这个函数适用于 3D 轴，所以它也需要一个scalez参数。

bar ( left , height , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs )

添加二维条。

参数：

左一维数组

条形左侧的 x 坐标。

高度一维数组

条的高度。

zs浮点数或一维数组

条的 Z 坐标；如果指定了单个值，它将用于所有柱。

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

绘制 2D 数据时，用作 z 的方向（'x'、'y' 或 'z'）。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

**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 , data = None , ** kwargs )

生成 3D 条形图。

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

参数：

x, y, z类数组

钢筋锚点的坐标。

dx, dy, dz浮点数或类似数组

分别为条的宽度、深度和高度。

颜色的颜色顺序，可选

条的颜色可以全局或单独指定。该参数可以是：

• 单一颜色，将所有条形着色为相同颜色。

• 一个长度为 N 条的颜色数组，用于为每个条单独着色。

• 长度为 6 的颜色数组，用于对条形的面进行类似的着色。

• 一组长度为 6 * N 条的颜色，用于独立为每个面着色。

当专门为盒子的面着色时，这是着色的顺序：

1. -Z（盒子底部）

2. +Z（箱顶）

3. -Y

4. +Y

5. -X

6. +X

zsort str，可选

z 轴排序方案传递给Poly3DCollection

阴影布尔值，默认值：True

如果为真，这会遮蔽条形的暗面（相对于绘图的光源）。

光源LightSource

当shade为 True 时使用的光源。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

**kwargs

任何额外的关键字参数都被传递到 Poly3DCollection.

返回：

收藏Poly3DCollection

代表条形的三维多边形的集合。

can_pan ( )

返回此轴是否支持平移/缩放按钮功能。

Axes3d 对象不使用平移/缩放按钮。

can_zoom ( )

返回此轴是否支持缩放框按钮功能。

Axes3D 对象不使用缩放框按钮。

clabel ( * args , ** kwargs )

目前未针对 3D 轴实现，并返回None。

清除( )

清除轴。

轮廓( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

创建 3D 等高线图。

参数：

X、Y、Z阵列状，

输入数据。查看Axes.contour支持的数据形状。

extend3d布尔值，默认值：False

是否在 3D 中扩展轮廓。

步幅_

扩展轮廓的步长。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到matplotlib.axes.Axes.contour.

返回：

matplotlib.contour.QuadContourSet

contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

创建 3D 等高线图。

参数：

X、Y、Z阵列状，

输入数据。查看Axes.contour支持的数据形状。

extend3d布尔值，默认值：False

是否在 3D 中扩展轮廓。

步幅_

扩展轮廓的步长。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到matplotlib.axes.Axes.contour.

返回：

matplotlib.contour.QuadContourSet

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

创建一个 3D 填充等值线图。

参数：

X、Y、Z类阵列

输入数据。查看Axes.contourf支持的数据形状。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到matplotlib.axes.Axes.contourf.

返回：

matplotlib.contour.QuadContourSet

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

创建一个 3D 填充等值线图。

参数：

X、Y、Z类阵列

输入数据。查看Axes.contourf支持的数据形状。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到matplotlib.axes.Axes.contourf.

返回：

matplotlib.contour.QuadContourSet

convert_zunits ( z )

对于 Axes 中的艺术家，如果 zaxis 支持单位，则使用 zaxis 单位类型转换z

disable_mouse_rotation ( )

禁用鼠标按钮进行 3D 旋转和缩放。

属性 dist

绘制（渲染器）

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

如果艺术家不可见，这将无效（Artist.get_visible 返回 False）。

参数：

渲染器RendererBase子类。

笔记

此方法在 Artist 子类中被覆盖。

errorbar ( x , y , z , zerr = None , yerr = None , xerr = None , fmt = '' , barabove = False , errorevery = 1 , ecolor = None , elinewidth = None , capsize = None , capthick = None , xlolims =假, xuplims= False , ylolims = False , yuplims = False , zlolims = False , zuplims = False , * , data = None , ** kwargs )

绘制线条和/或带有误差线的标记。

x / y / z定义数据位置，xerr / yerr / zerr定义误差条大小。默认情况下，这会绘制数据标记/线以及误差线。使用 fmt='none' 仅绘制误差线。

参数：

x、y、z浮点数或类似数组

数据位置。

xerr, yerr, zerr float or array-like, shape (N,) or (2, N), optional

误差条大小：

• 标量：所有数据点的对称 +/- 值。

• shape(N,)：每个数据点的对称 +/- 值。

• shape(2, N)：为每个条形分隔 - 和 + 值。第一行包含较低的错误，第二行包含较高的错误。

• 无：没有错误栏。

请注意，所有错误数组都应具有正值。

fmt str，默认值：''

数据点/数据线的格式。详情请参阅plot。

使用“无”（不区分大小写）绘制没有任何数据标记的误差线。

ecolor颜色，默认：无

误差线的颜色。如果没有，则使用连接标记的线的颜色。

elinewidth浮点数，默认值：无

误差线的线宽。如果为 None，则使用当前样式的线宽。

翻船浮动，默认值：（rcParams["errorbar.capsize"]默认值0.0：）

误差线上限的长度（以磅为单位）。

capthick浮动，默认值：无

关键字参数markeredgewidth的别名（又名mew）。此设置是控制误差线帽厚度（以磅为单位）的属性的更合理名称。为了向后兼容，如果给定了mew或markeredgewidth，那么它们将覆盖capthick。这可能会在未来的版本中改变。

barabove bool，默认值：False

如果为 True，将在绘图符号上方绘制误差线。默认如下。

xlolims, ylolims, zlolims布尔值，默认值：False

这些参数可用于指示一个值仅给出下限。在这种情况下，使用插入符号来表示这一点。lims -参数可以是标量，或者与错误长度相同的数组。要使用反转轴的限制， set_xlim或者set_ylim必须在之前调用 errorbar。注意棘手的参数名称：将例如 ylolims设置为 True 意味着 y 值是 True 值的下限，因此，只会绘制一个向上的箭头！

xuplims, yuplims, zuplims布尔值，默认值：False

同上，但用于控制上限。

errorevery int 或 (int, int)，默认值：1

在数据子集上绘制误差线。errorevery =N 在点 (x[::N], y[::N], z[::N]) 上绘制误差线。 errorevery =(start, N) 在点 (x[start::N], y[start::N], z[start::N]) 上绘制误差线。例如，errorevery=(6, 3) 在 (x[6], x[9], x[12], x[15], ...) 处的数据中添加误差线。当两个系列共享 x 轴值时，用于避免重叠误差线。

返回：

错误列表

实例列表，Line3DCollection每个实例都包含一条误差线。

帽线列表

Line3D每个实例都包含一个 capline 对象的列表。

界限清单

Line3D每个实例都包含一个带有上限或下限的标记的列表。

其他参数：

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

x , y , z , xerr ,耶尔,泽尔

**kwargs

样式错误栏行的所有其他关键字参数都被传递 Line3DCollection。

例子

（源代码，png）

format_coord ( xd , yd )

给定 2D 视图坐标尝试猜测 3D 坐标。寻找离该点最近的边缘，然后假设该点与边缘上的最近点位于相同的 z 位置。

format_zdata ( z )

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

get_autoscalez_on ( )

返回 zaxis 是否自动缩放。

get_axis_position ( )

get_frame_on ( )

获取是否绘制了 3D 轴面板。

get_proj ( )

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

get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False )

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

artist.set_in_layout(False)未包含在 bbox 中的艺术家。

参数：

渲染器RendererBase子类

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

bbox_extra_artists列表Artist或None

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

call_axes_locator布尔值，默认值：True

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

for_layout_only默认值：False

边界框将不包括标题和 xlabel 的 x 范围，或 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 ( )

返回 x 轴视图范围。

返回：

左，右（浮动，浮动）

数据坐标中的当前 x 轴范围。

也可以看看

Axes.set_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

笔记

x 轴可以反转，在这种情况下，左侧值将大于右侧值。

get_xlim3d ( )

的别名get_xlim。

get_ylim ( )

返回 y 轴视图范围。

返回：

底部，顶部（浮动，浮动）

数据坐标中的当前 y 轴范围。

也可以看看

Axes.set_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

笔记

y 轴可以反转，在这种情况下，底部值将大于顶部值。

get_ylim3d ( )

的别名get_ylim。

get_zaxis ( )

返回ZAxis( Axis) 实例。

get_zbound ( )

按升序返回 z 轴上下界。

get_zgridlines ( )

将 zaxis 的网格线作为Line2Ds 的列表返回。

get_zlabel ( )

获取 z-label 文本字符串。

get_zlim ( )

获取 3D z 限制。

get_zlim3d ( )

的别名get_zlim。

get_zmajorticklabels ( )

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

get_zminorticklabels ( )

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

get_zscale ( )

返回 zaxis 的比例（作为 str）。

get_zticklabels ( minor = False , which = None )

获取 zaxis 的刻度标签。

参数：

小布尔

是否返回次要或主要刻度标签。

其中无，（“次要”，“主要”，“两者”）

覆盖未成年人。

选择要返回的刻度标签

返回：

清单Text

get_zticklines ( minor = False )

将 zaxis 的刻度线作为Line2Ds 列表返回。

get_zticks ( * , minor = False )

在数据坐标中返回 zaxis 的刻度位置。

这些位置未裁剪到当前轴限制，因此可能包含在输出中不可见的位置。

参数：

次要布尔值，默认值：False

True 返回次要刻度方向，False 返回主要刻度方向。

返回：

刻度位置的numpy数组

grid ( visible = True , ** kwargs )

设置/取消设置 3D 网格。

笔记

目前，此函数的行为与 不同 axes.Axes.grid，但它旨在最终支持该行为。

invert_zaxis ( )

反转 z 轴。

边距（*边距， x = None， y = None， z = None， tight = True）

设置或检索自动缩放边距。

有关Axes.margins完整文档，请参阅。因为这个函数适用于 3D 轴，所以它也接受一个z参数，并返回 .(xmargin, ymargin, zmargin)

mouse_init ( rotate_btn = 1 , zoom_btn = 3 )

设置鼠标按钮进行 3D 旋转和缩放。

参数：

rotate_btn int 或 int 列表，默认值：1

用于轴的 3D 旋转的鼠标按钮。

zoom_btn int 或 int 列表，默认值：3

用于缩放 3D 轴的鼠标按钮。

名称= '3d'

plot ( xs , ys , * args , zdir = 'z' , ** kwargs )

绘制 2D 或 3D 数据。

参数：

xs 1D 类数组

顶点的 x 坐标。

ys一维数组

y 顶点坐标。

zs浮点数或一维数组

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

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

绘制 2D 数据时，用作 z 的方向（'x'、'y' 或 'z'）。

**kwargs

其他参数被转发到matplotlib.axes.Axes.plot.

plot3D ( xs , ys , * args , zdir = 'z' , ** kwargs )

绘制 2D 或 3D 数据。

参数：

xs 1D 类数组

顶点的 x 坐标。

ys一维数组

y 顶点坐标。

zs浮点数或一维数组

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

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

绘制 2D 数据时，用作 z 的方向（'x'、'y' 或 'z'）。

**kwargs

其他参数被转发到matplotlib.axes.Axes.plot.

plot_surface ( X , Y , Z , * , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs )

创建曲面图。

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

笔记

rcount和ccount kwargs都默认为 50，确定每个方向使用的最大样本数。如果输入数据较大，则会将其下采样（通过切片）到这些点数。

笔记

为了最大限度地提高渲染速度，请考虑将rstride和cstride分别设置 为行数减 1 和列数减 1 的除数。例如，给定 51 行 rstride 可以是 50 的任何除数。

类似地，设置rstride和cstride等于 1（或 rcount和ccount等于行数和列数）可以使用优化路径。

参数：

X、Y、Z二维数组

数据值。

rcount, 计数int

每个方向使用的最大样本数。如果输入数据较大，则会将其下采样（通过切片）到这些点数。默认为 50。

rstride, cstride int

每个方向的下采样步幅。这些参数与rcount和ccount 互斥。如果只设置了 rstride或cstride之一，则另一个默认为 10。

“经典”模式使用默认值代替新的默认值。rstride = cstride = 10rcount = ccount = 50

颜色类似颜色

表面补丁的颜色。

cmap颜色图

表面补丁的颜色图。

facecolors 类似数组的颜色。

每个单独补丁的颜色。

规范化_

颜色图的规范化。

vmin, vmax浮点数

规范化的界限。

阴影布尔值，默认值：True

是否对 facecolors 进行着色。指定cmap时，始终禁用着色 。

光源LightSource

当shade为 True 时使用的光源。

**kwargs

其他参数被转发到Poly3DCollection.

plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs )

绘制三角曲面。

（可选）三角剖分可以通过以下两种方式之一指定；任何一个：

plot_trisurf(triangulation, ...)

其中 triangulation 是一个Triangulation对象，或者：

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

在这种情况下，将创建一个 Triangulation 对象。有关 Triangulation这些可能性的说明，请参阅 。

剩下的论点是：

plot_trisurf(..., Z)

其中Z是要等高线的值数组，三角剖分中的每个点一个。

参数：

X、Y、Z类阵列

数据值作为一维数组。

颜色

表面补丁的颜色。

地图

表面补丁的颜色图。

规范化_

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

vmin, vmax浮点数，默认值：无

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

阴影布尔值，默认值：True

是否对 facecolors 进行着色。指定cmap时，始终禁用着色 。

光源LightSource

当shade为 True 时使用的光源。

**kwargs

所有其他参数都传递给 Poly3DCollection

例子

（源代码，png）

（源代码，png）

plot_wireframe ( X , Y , Z , ** kwargs )

绘制 3D 线框。

笔记

rcount和ccount kwargs都默认为 50，确定每个方向使用的最大样本数。如果输入数据较大，则会将其下采样（通过切片）到这些点数。

参数：

X、Y、Z二维数组

数据值。

rcount, 计数int

每个方向使用的最大样本数。如果输入数据较大，则会将其下采样（通过切片）到这些点数。将计数设置为零会导致不在相应方向上对数据进行采样，从而生成 3D 线图而不是线框图。默认为 50。

rstride, cstride int

每个方向的下采样步幅。这些参数与rcount和ccount 互斥。如果仅设置了 rstride或cstride中的一个，则另一个默认为 1。将步幅设置为零会导致数据不在相应方向上采样，从而生成 3D 线图而不是线框图。

“经典”模式使用默认值代替新的默认值。rstride = cstride = 1rcount = ccount = 50

**kwargs

其他参数被转发到Line3DCollection.

颤动( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

绘制一个 3D 箭头场。

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

参数：

X、Y、Z类阵列

箭头位置的 x、y 和 z 坐标（默认是箭头的尾部；请参阅pivot kwarg）。

U、V、W类阵列

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

长度浮点数，默认值：1

每个箭袋的长度。

arrow_length_ratio浮点数，默认值：0.3

箭头相对于箭袋的比例。

枢轴{'tail'，'middle'，'tip'}，默认值：'tail'

箭头在网格点处的部分；箭头围绕这一点旋转，因此得名pivot。

标准化布尔值，默认值：False

是否将所有箭头标准化为具有相同的长度，或者保持由u、v和w定义的长度。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

**kwargs

任何其他关键字参数都委托给 LineCollection

quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

绘制一个 3D 箭头场。

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

参数：

X、Y、Z类阵列

箭头位置的 x、y 和 z 坐标（默认是箭头的尾部；请参阅pivot kwarg）。

U、V、W类阵列

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

长度浮点数，默认值：1

每个箭袋的长度。

arrow_length_ratio浮点数，默认值：0.3

箭头相对于箭袋的比例。

枢轴{'tail'，'middle'，'tip'}，默认值：'tail'

箭头在网格点处的部分；箭头围绕这一点旋转，因此得名pivot。

标准化布尔值，默认值：False

是否将所有箭头标准化为具有相同的长度，或者保持由u、v和w定义的长度。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

**kwargs

任何其他关键字参数都委托给 LineCollection

scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs )

创建散点图。

参数：

xs, ys类数组

数据位置。

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

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

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

zs的轴方向。这在 3D 轴上绘制 2D 数据时很有用。数据必须作为xs，ys传递。将 zdir设置为 'y' 然后将数据绘制到 xz 平面。

另请参阅在 3D 图上绘制 2D 数据。

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

以点为单位的标记大小**2。与xs和ys长度相同的数组或单个值以使所有标记的大小相同。

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

标记颜色。可能的值：

• 单一颜色格式字符串。

• 长度为 n 的颜色序列。

• 使用cmap和 norm映射到颜色的 n 个数字序列。

• 一个二维数组，其中的行是 RGB 或 RGBA。

有关更多详细信息，请参见 的c参数scatter。

depthshade布尔值，默认值：True

是否对散点标记进行着色以显示深度。每次调用都scatter()将独立执行其深度着色。

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

xs , ys , zs , s , edgecolors , c , facecolor , facecolors ,颜色

**kwargs

所有其他参数都传递给scatter.

返回：

路径PathCollection

scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs )

创建散点图。

参数：

xs, ys类数组

数据位置。

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

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

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

zs的轴方向。这在 3D 轴上绘制 2D 数据时很有用。数据必须作为xs，ys传递。将 zdir设置为 'y' 然后将数据绘制到 xz 平面。

另请参阅在 3D 图上绘制 2D 数据。

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

以点为单位的标记大小**2。与xs和ys长度相同的数组或单个值以使所有标记的大小相同。

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

标记颜色。可能的值：

• 单一颜色格式字符串。

• 长度为 n 的颜色序列。

• 使用cmap和 norm映射到颜色的 n 个数字序列。

• 一个二维数组，其中的行是 RGB 或 RGBA。

有关更多详细信息，请参见 的c参数scatter。

depthshade布尔值，默认值：True

是否对散点标记进行着色以显示深度。每次调用都scatter()将独立执行其深度着色。

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

xs , ys , zs , s , edgecolors , c , facecolor , facecolors ,颜色

**kwargs

所有其他参数都传递给scatter.

返回：

路径PathCollection

设置( * ,可调=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> ,锚点=<UNSET> ,动画=<UNSET> , aspect=<UNSET > , autoscale_on=<UNSET > , autoscalex_on= <UNSET > , autoscaley_on =<UNSET> , autoscalez_on=<UNSET> , axes_locator,, box_aspect=< UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> ,脸色=<UNSET> , frame_on=<UNSET>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , navigate=<UNSET> , path_effects=<UNSET > , picker=< UNSET> , position=<UNSET> , proj_type =<UNSET> , prop_cycle=<UNSET> , rasterization_zorder=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , title=<UNSET> , transform=<UNSET> , url=<未设置>，可见=<未设置>, xbound=<UNSET> ,xlabel=<UNSET> , xlim=<UNSET> , xlim3d=<UNSET> , xmargin=<UNSET> , xscale=<UNSET> , xticklabels=<UNSET> , xticks=<UNSET> , ybound=<UNSET> , ylabel= <UNSET> , ylim=<UNSET> , ylim3d=<UNSET> , ymargin=<UNSET> , yscale=<UNSET> , yticklabels=<UNSET> , yticks=<UNSET> , zbound=<UNSET> , zlabel=<UNSET > , zlim=<UNSET> , zlim3d=<UNSET>, zmargin=<UNSET> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
adjustable	{'box', 'datalim'}
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
anchor	(float, float) 或 {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	布尔
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalz'}
autoscale_on	布尔
autoscalex_on	未知
autoscaley_on	未知
autoscalez_on	未知
axes_locator	可调用[[轴，渲染器]，Bbox]
axisbelow	布尔或“线”
box_aspect	浮点数的三元组或无
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
facecolor或 fc	颜色
figure	Figure
frame_on	布尔
gid	字符串
in_layout	布尔
label	目的
mouseover	布尔
navigate	布尔
navigate_mode	未知
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	[左、下、宽、高] 或Bbox
proj_type	{'persp', '正交'}
prop_cycle	未知
rasterization_zorder	浮动或无
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	未知
transform	Transform
url	字符串
visible	布尔
xbound	未知
xlabel	字符串
xlim	（底部：浮动，顶部：浮动）
xlim3d	（底部：浮动，顶部：浮动）
xmargin	浮动大于 -0.5
xscale	未知
xticklabels	未知
xticks	未知
ybound	未知
ylabel	字符串
ylim	（底部：浮动，顶部：浮动）
ylim3d	（底部：浮动，顶部：浮动）
ymargin	浮动大于 -0.5
yscale	未知
yticklabels	未知
yticks	未知
zbound	未知
zlabel	未知
zlim	未知
zlim3d	未知
zmargin	浮动大于 -0.5
zorder	漂浮
zscale	未知
zticklabels	未知
zticks	未知

set_aspect (方面,可调整= None , anchor = None , share = False )

设置纵横比。

参数：

方面{'auto'，'equal'，'equalxy'，'equalxz'，'equalyz'}

可能的值：

价值	描述
'汽车'	自动的; 用数据填充位置矩形。
'平等的'	调整所有轴以具有相等的纵横比。
'平等'	调整 x 和 y 轴以具有相等的纵横比。
'平等'	调整 x 和 z 轴以具有相等的纵横比。
'均衡'	调整 y 和 z 轴以具有相等的纵横比。

可调节无

当前被 Axes3D 忽略

如果不是None，这定义了将调整哪个参数以满足所需的方面。有关详细信息，请参阅set_adjustable。

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

如果不是None，这定义了如果由于方面限制而存在额外空间，则将在何处绘制 Axes。指定锚点的最常见方法是基本方向的缩写：

价值	描述
'C'	居中
'西南'	左下角
'S'	底边中间
'SE'	右下角
等等

有关详细信息，请参阅set_anchor。

共享布尔值，默认值：False

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

也可以看看

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscalez_on ( b )

设置 zaxis 是在绘制时自动缩放还是按 Axes.autoscale_view.

参数：

b布尔值

set_axis_off ( )

关闭 x 轴和 y 轴。

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

set_axis_on ( )

打开 x 轴和 y 轴。

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

set_box_aspect ( aspect , * , zoom = 1 )

设置轴框纵横比。

盒子纵横比是垂直于盒子的每个面看时，以显示单位表示的高度与宽度的比率。这不应与数据方面（对于 Axes3D 始终为“自动”）相混淆。默认比率为 4:4:3 (x:y:z)。

要模拟在数据空间中具有相同的纵横比，请设置框纵横比以匹配每个维度中的数据范围。

zoom控制图中Axes3D的整体大小。

参数：

方面3 元组的浮点数或无

更改 Axes3D 的物理尺寸，以使显示单位中的轴长度比为 x:y:z。如果没有，默认为 (4,4,3)。

缩放浮动，默认：1

控制图中 Axes3D 的整体大小。必须 > 0。

set_frame_on ( b )

设置是否绘制 3D 轴面板。

参数：

b布尔值

set_proj_type ( proj_type , focus_length = None )

设置投影类型。

参数：

proj_type {'persp', 'ortho'}

投影类型。

focus_length浮点数，默认值：无

对于“透视”的投影类型，虚拟相机的焦距。必须 > 0。如果没有，则默认为 1。焦距可以通过以下等式从所需的视场计算：focal_length = 1/tan(FOV/2)

set_title ( label , fontdict = None , loc = 'center' , ** kwargs )

为轴设置标题。

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

参数：

标签str

用于标题的文本

字体字典

一个控制标题文本外观的字典，默认的fontdict是：

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc {'center', 'left', 'right'}，默认值：（rcParams["axes.titlelocation"]默认值'center'：）

要设置的标题。

y浮点数，默认值：（rcParams["axes.titley"]默认值None：）

标题的垂直轴位置（1.0 为顶部）。如果 None（默认值）和rcParams["axes.titley"]（默认值None：）也是 None，则自动确定 y 以避免轴上的装饰器。

填充浮动，默认值：（rcParams["axes.titlepad"]默认值6.0：）

标题与轴顶部的偏移量，以磅为单位。

返回：

Text

表示标题的 matplotlib 文本实例

其他参数：

**kwargsText属性

其他关键字参数是文本属性，请参阅Text有效文本属性列表。

set_top_view ( )

set_xlim3d ( left = None , right = None , * , emit = True , auto = False , xmin = None , xmax = None )

设置 x 轴视图限制。

参数：

左浮动，可选

数据坐标中的左侧 xlim。通过None使限制保持不变。

left 和 right xlims 也可以作为元组（left , right）作为第一个位置参数（或作为left关键字参数）传递。

右浮动，可选

数据坐标中的右 xlim。通过None使限制保持不变。

发出布尔值，默认值：True

是否通知观察者限制变化。

auto bool 或 None，默认值：False

是否开启 x 轴的自动缩放。True 开启，False 关闭，None 保持不变。

xmin, xmax浮点数，可选

它们分别相当于 left 和 right ，同时传递xmin和left或xmax和right是错误的。

返回：

左，右（浮动，浮动）

数据坐标中的新 x 轴限制。

也可以看看

get_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

笔记

左值可能大于右值，在这种情况下，x 轴值将从左向右递减。

例子

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

一个限制可以保持不变。

>>> set_xlim(right=right_lim)

可以以相反的顺序传递限制以翻转 x 轴的方向。例如，假设x表示现在之前的年数。x 轴限制可能如下设置，因此 5000 年前在图的左侧，现在在右侧。

>>> set_xlim(5000, 0)

set_xscale ( value , ** kwargs )

设置 x 轴刻度。

参数：

值{“线性”}

要应用的轴刻度类型。3D 轴目前仅支持线性刻度；其他尺度会产生荒谬的结果。

**kwargs

关键字参数名义上被转发到比例类，但它们都不适用于线性比例。

set_ylim3d ( bottom = None , top = None , * , emit = True , auto = False , ymin = None , ymax = None )

设置 y 轴视图范围。

参数：

底部浮子，可选

数据坐标中的底部 ylim。通过None使限制保持不变。

底部和顶部 ylim 也可以作为元组（底部，顶部）作为第一个位置参数（或底部关键字参数）传递。

顶部浮动，可选

数据坐标中的顶部 ylim。通过None使限制保持不变。

发出布尔值，默认值：True

是否通知观察者限制变化。

auto bool 或 None，默认值：False

是否开启 y 轴的自动缩放。True开启， False关闭，None保持不变。

ymin, ymax浮点数，可选

它们分别相当于底部和顶部，同时传递ymin和bottom或ymax和top是错误的。

返回：

底部，顶部（浮动，浮动）

数据坐标中的新 y 轴限制。

也可以看看

get_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

笔记

底部值可能大于顶部值，在这种情况下，y 轴值将从底部减小到顶部。

例子

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

一个限制可以保持不变。

>>> set_ylim(top=top_lim)

可以以相反的顺序通过限制以翻转 y 轴的方向。例如，假设y以 m 表示海洋的深度。y 轴限制可能如下设置，因此 5000 m 深度位于绘图底部，而表面 0 m 位于顶部。

>>> set_ylim(5000, 0)

set_yscale ( value , ** kwargs )

设置 y 轴刻度。

参数：

值{“线性”}

要应用的轴刻度类型。3D 轴目前仅支持线性刻度；其他尺度会产生荒谬的结果。

**kwargs

关键字参数名义上被转发到比例类，但它们都不适用于线性比例。

set_zbound ( lower = None , upper = None )

设置 z 轴的数值下限和上限。

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

set_zlabel ( zlabel , fontdict = None , labelpad = None , ** kwargs )

设置 zlabel。有关说明，请参见文档set_ylabel。

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

设置 3D z 限制。

查看Axes.set_ylim完整文档

set_zlim3d（底部=无，顶部=无， *，发射=真，自动=假， zmin =无， zmax =无）

的别名set_zlim。

set_zmargin ( m )

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

m次数据间隔将被添加到该间隔的每一端，然后再用于自动缩放。如果m为负数，这将剪切数据范围而不是扩展它。

例如，如果您的数据在 [0, 2] 范围内，则边距 0.1 将导致范围 [-0.2, 2.2]；-0.1 的边距将导致范围为 [0.2, 1.8]。

参数：

m浮动大于 -0.5

set_zscale ( value , ** kwargs )

设置 z 轴刻度。

参数：

值{“线性”}

要应用的轴刻度类型。3D 轴目前仅支持线性刻度；其他尺度会产生荒谬的结果。

**kwargs

关键字参数名义上被转发到比例类，但它们都不适用于线性比例。

set_zticklabels ( labels , * , fontdict = None , minor = False , ** kwargs )

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

警告

此方法仅应在使用 固定刻度位置后使用Axes3D.set_zticks。否则，标签可能会出现在意想不到的位置。

参数：

str的标签列表

标签文本。

fontdict字典，可选

控制刻度标签外观的字典。默认字体字典是：

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

次要布尔值，默认值：False

是否设置次要刻度标签而不是主要刻度标签。

返回：

清单Text

标签。

其他参数：

**kwargsText属性。

set_zticks ( ticks , labels = None , * , minor = False , ** kwargs )

设置 zaxis 的刻度位置和可选的标签。

如有必要，将扩展 Axis 的视图范围，以便所有给定的刻度都可见。

参数：

刻度线列表

刻度位置列表。轴Locator被替换为 FixedLocator。

一些刻度格式化程序不会标记任意刻度位置；例如，默认情况下，日志格式化程序仅标记十年刻度。Axis.set_major_formatter在这种情况下，您可以使用或自己提供格式化 标签在轴上显式设置格式化程序。

str的标签列表，可选

刻度标签列表。如果未设置，则使用轴刻度生成标签Formatter。

次要布尔值，默认值：False

如果False，设置主要刻度；如果True, 次要刻度。

**kwargs

Text标签的属性。这些只有在您传递标签时才会生效。在其他情况下，请使用tick_params.

笔记

视图限制的强制扩展是一种有意的设计选择，以防止出现不可见的勾号。如果您需要其他限制，则应在设置刻度后明确设置限制。

sharez (其他)

与其他人共享 z 轴。

这相当于sharex=other在构建 Axes 时传递，如果 z 轴已经与另一个 Axes 共享，则不能使用。

茎（x、 y、 z、 *、 linefmt = ' C0-' 、 markerfmt = 'C0o'、 basefmt = 'C3-'、底部= 0、标签=无、方向= 'z'、数据=无）

创建 3D 茎图。

茎图绘制垂直于基线的线，并在头部放置标记。默认情况下，基线由x和y定义，茎从底部垂直绘制到z。

参数：

x, y, z类数组

茎头的位置。茎沿从底部基线（在 方向坐标中）到头部的方向方向绘制。默认情况下，x和y 位置用于基线，z用于头部位置，但这可以通过方向更改。

linefmt str，默认值：'C0-'

定义垂直线属性的字符串。通常，这将是一种颜色或一种颜色和一种线条样式：

特点	线型
'-'	实线
'--'	虚线
'-.'	点划线
':'	虚线

注意：虽然在技术上可以指定除颜色或颜色和线型以外的有效格式（例如“rx”或“-.”），但这超出了方法的意图，很可能不会产生合理的绘图。

markerfmt str，默认值：'C0o'

一个字符串，用于定义词干头部标记的属性。

basefmt str，默认值：'C3-'

定义基线属性的格式字符串。

底部浮动，默认值：0

基线的位置，以方向坐标为单位。

标签str，默认值：无

用于图例中的词干的标签。

方向{'x', 'y', 'z'}，默认值：'z'

绘制茎的方向。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

返回：

StemContainer

可以将容器视为元组（markerline、stemlines、baseline）

例子

（源代码，png）

（PNG）

（PNG）

stem3D ( x , y , z , * , linefmt = ' C0-' , markerfmt = 'C0o' , basefmt = 'C3-' ,底部= 0 , label = None ,方向= 'z' , data = None )

创建 3D 茎图。

茎图绘制垂直于基线的线，并在头部放置标记。默认情况下，基线由x和y定义，茎从底部垂直绘制到z。

参数：

x, y, z类数组

茎头的位置。茎沿从底部基线（在 方向坐标中）到头部的方向方向绘制。默认情况下，x和y 位置用于基线，z用于头部位置，但这可以通过方向更改。

linefmt str，默认值：'C0-'

定义垂直线属性的字符串。通常，这将是一种颜色或一种颜色和一种线条样式：

特点	线型
'-'	实线
'--'	虚线
'-.'	点划线
':'	虚线

注意：虽然在技术上可以指定除颜色或颜色和线型以外的有效格式（例如“rx”或“-.”），但这超出了方法的意图，很可能不会产生合理的绘图。

markerfmt str，默认值：'C0o'

一个字符串，用于定义词干头部标记的属性。

basefmt str，默认值：'C3-'

定义基线属性的格式字符串。

底部浮动，默认值：0

基线的位置，以方向坐标为单位。

标签str，默认值：无

用于图例中的词干的标签。

方向{'x', 'y', 'z'}，默认值：'z'

绘制茎的方向。

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

返回：

StemContainer

可以将容器视为元组（markerline、stemlines、baseline）

例子

（源代码，png）

（PNG）

（PNG）

text ( x , y , z , s , zdir = None , ** kwargs )

在绘图中添加文本。kwargs 将被传递给 Axes.text，除了zdir关键字，它将方向设置为 z 方向。

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

将文本添加到轴。

将文本s添加到数据坐标中x、y位置的 Axes 中。

参数：

x, y浮动

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

字符串_

文本。

fontdict字典，默认值：无

用于覆盖默认文本属性的字典。如果 fontdict 为 None，则默认值由 确定rcParams。

返回：

Text

创建的Text实例。

其他参数：

**kwargsText属性。

其他杂项文本参数。

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	布尔
backgroundcolor	颜色
bbox	具有属性的字典patches.FancyBboxPatch
clip_box	未知
clip_on	未知
clip_path	未知
color或 c	颜色
figure	Figure
fontfamily或家人	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties或字体或字体属性	font_manager.FontProperties或str或pathlib.Path
fontsize或尺寸	浮动或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}
fontstretch或拉伸	{0-1000 范围内的数值，'超压缩'，'超压缩'，'压缩'，'半压缩'，'普通'，'半扩展'，'扩展'，'超扩展', '超膨胀'}
fontstyle或风格	{'正常'，'斜体'，'斜体'}
fontvariant或变体	{'正常', '小型大写字母'}
fontweight或重量	{0-1000 范围内的数值, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', '粗体'，'重'，'超粗体'，'黑色'}
gid	字符串
horizontalalignment或哈	{'左'，'中心'，'右'}
in_layout	布尔
label	目的
linespacing	浮动（字体大小的倍数）
math_fontfamily	字符串
mouseover	布尔
multialignment或马	{'左'，'右'，'中心'}
parse_math	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
position	（浮动，浮动）
rasterized	布尔
rotation	浮动或{'垂直'，'水平'}
rotation_mode	{无，'默认'，'锚点'}
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
text	目的
transform	Transform
transform_rotates_text	布尔
url	字符串
usetex	布尔或无
verticalalignment或 va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
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 )

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

有关Axes.tick_params完整文档，请参阅。因为此功能适用于 3D 轴，所以也可以将轴设置为“z”，将轴设置 为“两者”会自动缩放所有三个轴。

此外，由于 Axes3D 对象的绘制方式与常规 2D 轴的绘制方式非常不同，因此其中一些设置的含义可能不明确。为简单起见，“z”轴将像“y”轴一样接受设置。

笔记

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

tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

创建 3D 等高线图。

笔记

由于 3D PolyCollection 渲染中的长期错误，此方法当前会产生不正确的输出。

参数：

X、Y、Z类阵列

输入数据。查看Axes.tricontour支持的数据形状。

extend3d布尔值，默认值：False

是否在 3D 中扩展轮廓。

步幅_

扩展轮廓的步长。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到matplotlib.axes.Axes.tricontour.

返回：

matplotlib.tri.tricontour.TriContourSet

tricontourf ( * args , zdir = 'z' , offset = None , data = None , ** kwargs )

创建一个 3D 填充等值线图。

笔记

由于 3D PolyCollection 渲染中的长期错误，此方法当前会产生不正确的输出。

参数：

X、Y、Z类阵列

输入数据。查看Axes.tricontourf支持的数据形状。

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

使用方向。

偏移浮动，可选

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

*args, **kwargs

其他参数被转发到 matplotlib.axes.Axes.tricontourf.

返回：

matplotlib.tri.tricontour.TriContourSet

tunit_cube ( vals = None , M = None )

tunit_edges ( vals = None , M = None )

unit_cube ( vals = None )

update_datalim ( xys , ** kwargs )

扩展dataLimBbox 以包含给定的点。

如果当前没有设置数据，Bbox 将忽略其限制并将边界设置为 xydata ( xys ) 的边界。否则，它将计算其当前数据和 xys中数据的并集范围。

参数：

xys二维数组

要包含在数据限制 Bbox 中的点。这可以是 (x, y) 元组的列表或 Nx2 数组。

updatex, updatey bool, 默认: True

是否更新 x/y 限制。

view_init ( elev = None , azim = None , roll = None , vertical_axis = 'z' )

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

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

为了看起来垂直于主平面，可以使用以下仰角和方位角。0、90、180 或 270 度的滚动角将旋转这些视图，同时保持轴成直角。

查看平面	电梯	阿齐姆
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

参数：

高度浮动，默认值：无

以度为单位的仰角使相机在垂直轴穿过的平面上方旋转，正角对应于该平面上方的位置。例如，使用默认垂直轴“z”，仰角定义了 xy 平面上方相机位置的角度。Axes3D 如果为 None，则使用构造函数中指定的初始值。

azim浮动，默认值：无

以度为单位的方位角使相机围绕垂直轴旋转，正角对应于右手旋转。例如，在默认垂直轴“z”的情况下，正方位角使相机围绕原点从其沿 +x 轴的位置向 +y 轴旋转。Axes3D 如果为 None，则使用构造函数中指定的初始值。

滚动浮动，默认：无

以度为单位的滚动角使相机围绕观察轴旋转。正角度使相机顺时针旋转，导致场景逆时针旋转。Axes3D 如果为 None，则使用构造函数中指定的初始值。

垂直轴{“z”，“x”，“y”}，默认值：“z”

要垂直对齐的轴。azim围绕该轴旋转。

体素( [ x , y , z , ] / ,填充, facecolors=None , edgecolors=None , **kwargs )

绘制一组填充体素

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

参数：

填充3D np.array of bool

一个 3D 值数组，真实值指示要填充的体素

x, y, z 3D np.array，可选

体素角的坐标。这应该广播到一个在每个维度上都比填充的形状大一个的形状 。这些可用于绘制非立方体素。

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

facecolors, edgecolors 类数组，可选

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

• 单个颜色值，为所有体素着色相同的颜色。这可以是字符串，也可以是一维 rgb/rgba 数组

• None，默认值，面使用单一颜色，边缘使用默认样式。

• 颜色名称的 3D ndarray，每个项目都是相应体素的颜色。大小必须与体素匹配。

• rgb/rgba 数据的 4D ndarray，组件沿最后一个轴。

阴影布尔值，默认值：True

是否对 facecolors 进行着色。指定cmap时，始终禁用着色 。

光源LightSource

当shade为 True 时使用的光源。

**kwargs

要传递给 Poly3DCollection.

返回：

面对字典

由坐标索引的字典，其中是 为体素绘制的面中的 一个。如果没有为给定体素绘制任何面，或者是因为它没有被要求绘制，或者它被完全遮挡，那么.faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

例子

（源代码，png）

（源代码，png）

（源代码，png）

（源代码，png）

属性 w_xaxis

属性 w_yaxis

属性 w_zaxis

zaxis_date ( tz = None )

设置轴刻度和标签以将沿 z 轴的数据视为日期。

参数：

tz str 或datetime.tzinfo, 默认值: rcParams["timezone"](默认值: 'UTC')

用于创建日期标签的时区。

笔记

此功能仅用于完整性，但 3D 轴不支持刻度日期，因此可能无法按预期工作。

zaxis_inverted ( )

如果 z 轴反转，则返回 True。