matplotlib.figure.Figure

class matplotlib.figure.Figure(figsize=None, dpi=None, facecolor=None, edgecolor=None, linewidth=0.0, frameon=None, subplotpars=None, tight_layout=None, constrained_layout=None)

基类：matplotlib.artist.Artist

所有绘图元素的顶级容器。

Figure实例支持通过 回调 属性是 CallbackRegistry 实例。您可以连接到的事件是'dpi_changed'，将用调用回调 func(fig) 无花果在哪里 Figure 实例。

属性:

patch

这个 Rectangle 表示图形背景修补程序的实例。

suppressComposite

对于多个体形图像，该体形将根据渲染器选项_image_nocomposite函数生成复合图像。如果 抑制复合 是布尔值，这将覆盖渲染器。

参数:

图幅 : 2-tuple of floats, default: rcParams["figure.figsize"] (default: [6.4, 4.8])2元组浮点数，默认值：

图尺寸 (width, height) 英寸

dpi : float, default: rcParams["figure.dpi"] (default: 100.0)浮动，默认值：

每英寸点数。

脸色 : default: rcParams["figure.facecolor"] (default: 'white')违约：

图形补丁facecolor。

变色染料 : default: rcParams["figure.edgecolor"] (default: 'white')违约：

图形补丁边缘颜色。

linewidth浮动

框架的线条宽度（即图形面片的边缘线条宽度）。

框架 : bool, default: rcParams["figure.frameon"] (default: True)布尔，默认值：

如果 False ，禁止绘制地物背景面片。

次绘图 ： SubplotParamsSubplotParams

子批次参数。如果未给出，则默认子批次参数 rcParams["figure.subplot.*"] 被使用。

tight_layout : bool or dict, default: rcParams["figure.autolayout"] (default: False)bool或dict，默认值：

如果 False 使用 次绘图 .如果 True 使用调整子批次参数 tight_layout 使用默认填充。提供包含键的dict时 pad ， w_pad ， h_pad 和 rect ，默认的 tight_layout 填充将被覆盖。

constrained_layout : bool, default: rcParams["figure.constrained_layout.use"] (default: False)布尔，默认值：

如果 True 使用受约束的布局调整绘图元素的位置。喜欢 tight_layout 但设计得更灵活。见 受约束的布局参考线 举个例子。（注：不适用于 add_subplot 或 subplot2grid ）

__getstate__()

__init__(figsize=None, dpi=None, facecolor=None, edgecolor=None, linewidth=0.0, frameon=None, subplotpars=None, tight_layout=None, constrained_layout=None)

参数:

图幅 : 2-tuple of floats, default: rcParams["figure.figsize"] (default: [6.4, 4.8])2元组浮点数，默认值：

图尺寸 (width, height) 英寸

dpi : float, default: rcParams["figure.dpi"] (default: 100.0)浮动，默认值：

每英寸点数。

脸色 : default: rcParams["figure.facecolor"] (default: 'white')违约：

图形补丁facecolor。

变色染料 : default: rcParams["figure.edgecolor"] (default: 'white')违约：

图形补丁边缘颜色。

linewidth浮动

框架的线条宽度（即图形面片的边缘线条宽度）。

框架 : bool, default: rcParams["figure.frameon"] (default: True)布尔，默认值：

如果 False ，禁止绘制地物背景面片。

次绘图 ： SubplotParamsSubplotParams

子批次参数。如果未给出，则默认子批次参数 rcParams["figure.subplot.*"] 被使用。

tight_layout : bool or dict, default: rcParams["figure.autolayout"] (default: False)bool或dict，默认值：

如果 False 使用 次绘图 .如果 True 使用调整子批次参数 tight_layout 使用默认填充。提供包含键的dict时 pad ， w_pad ， h_pad 和 rect ，默认的 tight_layout 填充将被覆盖。

constrained_layout : bool, default: rcParams["figure.constrained_layout.use"] (default: False)布尔，默认值：

如果 True 使用受约束的布局调整绘图元素的位置。喜欢 tight_layout 但设计得更灵活。见 受约束的布局参考线 举个例子。（注：不适用于 add_subplot 或 subplot2grid ）

__module__ = 'matplotlib.figure'

__repr__()

返回repr（self）。

__setstate__(state)

__str__()

返回str（self）。

add_artist(artist, clip=False)

添加一个 Artist 达到这个数字。

通常艺术家被添加到轴对象使用 Axes.add_artist ；此方法可用于极少数情况，即需要直接将艺术家添加到图形中。

参数:

艺术家 ： Artist艺术家

要添加到图形中的艺术家。如果添加的艺术家之前没有设置转换，则其转换将设置为 figure.transFigure .

clipbool，默认值：False

添加的艺术家是否应该被人物补丁剪辑。

返回:

Artist

添加的艺术家。

add_axes(*args, **kwargs)

向图形中添加轴。

呼叫签名：

add_axes(rect, projection=None, polar=False, **kwargs)
add_axes(ax)

参数:

rect浮动顺序

尺寸 [左、下、宽、高] 新的轴。所有数量都是图形宽度和高度的分数。

projection无，'aitoff'、'hammer'、'lambert'、'mollweide'、'polar'、'rectlinear'、str，可选

的投影类型 Axes . str 是自定义投影的名称，请参见 projections . 默认的“无”将导致“直线”投影。

polarbool，默认值：False

如果为真，则相当于投影='polar'。

斯莱西 ： Axes 可选可选轴

共享X或Y axis 使用sharex和/或sharey。轴将具有与共享轴的轴相同的限制、刻度和比例。

labelSTR

返回轴的标签。

返回:

Axes, or a subclass of Axes

返回的轴类取决于使用的投影。它是 Axes 如果使用直线投影 projections.polar.PolarAxes 如果使用极轴投影。

其他参数:

**kwargs

此方法还接受返回的axs类的关键字参数。直线轴类的关键字参数 Axes 可以在下表中找到，但如果使用其他投影，也可能有其他关键字参数，请参见实际的轴类。

财产	描述
adjustable	'box'、'datalim'
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
anchor	2-浮点数或'c'、'sw'、's'、'se'、…
animated	布尔
aspect	{auto}或num
autoscale_on	布尔
autoscalex_on	布尔
autoscaley_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
prop_cycle	未知的
rasterization_zorder	浮动或无
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	STR
transform	Transform
url	STR
visible	布尔
xbound	未知的
xlabel	STR
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于-0.5
xscale	“Linear”，“Log”，“SymLog”，“Logit”，…
xticklabels	未知的
xticks	未知的
ybound	未知的
ylabel	STR
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于-0.5
yscale	“Linear”，“Log”，“SymLog”，“Logit”，…
yticklabels	未知的
yticks	未知的
zorder	浮动

参见

Figure.add_subplot

pyplot.subplot

pyplot.axes

Figure.subplots

pyplot.subplots

笔记

如果图形已经有带键的轴（ args ， 关键字参数 ）然后它将简单地使该轴成为当前轴并返回它。此行为已被弃用。同时，如果您不希望此行为（即，您希望强制创建新轴），则必须使用一组唯一的args和kwargs。轴心 标签 为此，已公开属性：如果要将两个相同的轴添加到图形中，请确保为它们提供唯一的标签。

在极少数情况下， add_axes 可以用单个参数调用，该参数是已经在当前图形中创建但不在图形的轴列表中的轴实例。

实例

一些简单的例子：

rect = l, b, w, h
fig = plt.figure()
fig.add_axes(rect, label=label1)
fig.add_axes(rect, label=label2)
fig.add_axes(rect, frameon=False, facecolor='g')
fig.add_axes(rect, polar=True)
ax = fig.add_axes(rect, projection='polar')
fig.delaxes(ax)
fig.add_axes(ax)

add_axobserver(func)

每当轴状态改变时， func(self) 将被调用。

add_gridspec(nrows=1, ncols=1, **kwargs)

返回A GridSpec 把这个数字作为父级。这使得图形中的轴可以进行复杂的布局。

参数:

nrowsint，默认值：1

网格中的行数。

ncolsint，默认值：1

网格中的数字或列。

返回:

GridSpec

其他参数:

**kwargs

关键字参数传递给 GridSpec .

参见

matplotlib.pyplot.subplots

实例

添加跨越两行的子批次：

fig = plt.figure()
gs = fig.add_gridspec(2, 2)
ax1 = fig.add_subplot(gs[0, 0])
ax2 = fig.add_subplot(gs[1, 0])
# spans two rows:
ax3 = fig.add_subplot(gs[:, 1])

add_subplot(*args, **kwargs)

添加一个 Axes 作为子批次安排的一部分。

呼叫签名：

add_subplot(nrows, ncols, index, **kwargs)
add_subplot(pos, **kwargs)
add_subplot(ax)
add_subplot()

参数:

*args ：int，（int，int， 指数 ） SubplotSpec ，默认值：（1，1，1）内特，（内特，内特，

其中一个描述的子图的位置

• 三个整数( 诺尔斯 ， 恩科斯 ， 指数 ). 子地块将接受 指数 在网格上的位置 诺尔斯 行和 恩科斯 柱。 指数 从左上角的1开始，向右增加。 指数 也可以是指定( 第一 ， last )指数（以1为基础，包括 last )子地块的，例如。， fig.add_subplot(3, 1, (1, 2)) 生成一个子图，该子图跨越图形的上2/3。
• 三位整数。这些数字被解释为三个独立的整数，即。 fig.add_subplot(235) 是一样的 fig.add_subplot(2, 3, 5) . 请注意，仅当子批次不超过9个时，才可以使用此选项。
• A SubplotSpec .

在极少数情况下， add_subplot 可以用单个参数调用，子批次轴实例已在当前图中创建，但不在图的轴列表中。

projection无，'aitoff'、'hammer'、'lambert'、'mollweide'、'polar'、'rectlinear'、str，可选

子批次的投影类型 (Axes ） str 是自定义投影的名称，请参见 projections . 默认的“无”将导致“直线”投影。

polarbool，默认值：False

如果为真，则相当于投影='polar'。

斯莱西 ： Axes 可选可选轴

共享X或Y axis 使用sharex和/或sharey。轴将具有与共享轴的轴相同的限制、刻度和比例。

labelSTR

返回轴的标签。

返回:

axes.SubplotBase, or another subclass of Axes

子批次的轴。返回的axes基类取决于使用的投影。它是 Axes 如果使用直线投影 projections.polar.PolarAxes 如果使用极轴投影。然后，返回的轴是基类的子批子类。

其他参数:

**kwargs

此方法还接受返回的Axis基类的关键字参数；除了 图形 争论。直线基类的关键字参数 Axes 可以在下表中找到，但如果使用其他投影，也可能存在其他关键字参数。

财产	描述
adjustable	'box'、'datalim'
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
anchor	2-浮点数或'c'、'sw'、's'、'se'、…
animated	布尔
aspect	{auto}或num
autoscale_on	布尔
autoscalex_on	布尔
autoscaley_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
prop_cycle	未知的
rasterization_zorder	浮动或无
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	STR
transform	Transform
url	STR
visible	布尔
xbound	未知的
xlabel	STR
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于-0.5
xscale	“Linear”，“Log”，“SymLog”，“Logit”，…
xticklabels	未知的
xticks	未知的
ybound	未知的
ylabel	STR
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于-0.5
yscale	“Linear”，“Log”，“SymLog”，“Logit”，…
yticklabels	未知的
yticks	未知的
zorder	浮动

参见

Figure.add_axes

pyplot.subplot

pyplot.axes

Figure.subplots

pyplot.subplots

笔记

如果数字已经有带键的子批次（ args ， 关键字参数 )然后它将简单地将该子批次置为当前并返回它。此行为已弃用。同时，如果您不希望这种行为（即，您想强制创建一个新的子批次），则必须使用一组唯一的arg和kwarg。轴 标签 为此，已公开了属性：如果要将两个相同的子批次添加到图中，请确保为它们提供唯一的标签。

实例

fig = plt.figure()

fig.add_subplot(231)
ax1 = fig.add_subplot(2, 3, 1)  # equivalent but more general

fig.add_subplot(232, frameon=False)  # subplot with no frame
fig.add_subplot(233, projection='polar')  # polar subplot
fig.add_subplot(234, sharex=ax1)  # subplot sharing x-axis with ax1
fig.add_subplot(235, facecolor="red")  # red subplot

ax1.remove()  # delete ax1 from the figure
fig.add_subplot(ax1)  # add ax1 back to the figure

align_labels(axs=None)

如果标签对齐是自动进行的（即标签位置不是手动设置的），则将子批次的xlabels和ylabels分别与相同的子批次行或列对齐。

调用draw事件后，将继续对齐。

参数:

axs 名单 Axes名单

可选列表（或ndarray） Axes 对齐标签。默认为对齐图形上的所有轴。

参见

matplotlib.figure.Figure.align_xlabels

matplotlib.figure.Figure.align_ylabels

align_xlabels(axs=None)

如果标签对齐是自动完成的（即标签位置不是手动设置的），则对齐同一子批次列中子批次的xlabel。

调用draw事件后，将继续对齐。

如果标签位于底部，它将与轴上的标签对齐，这些轴的标签也位于底部，并且具有相同的最底部子批次行。如果标签位于顶部，则与具有相同最顶端行的轴上的标签对齐。

参数:

axs 名单 Axes名单

可选列表（或ndarray） Axes 对齐XL标签。默认为对齐图形上的所有轴。

参见

matplotlib.figure.Figure.align_ylabels

matplotlib.figure.Figure.align_labels

笔记

这假设 axs 都来自同一个地方 GridSpec 让他们 SubplotSpec 位置与图形位置相对应。

实例

旋转Xtick标签示例：

fig, axs = plt.subplots(1, 2)
for tick in axs[0].get_xticklabels():
    tick.set_rotation(55)
axs[0].set_xlabel('XLabel 0')
axs[1].set_xlabel('XLabel 1')
fig.align_xlabels()

align_ylabels(axs=None)

如果标签对齐是自动进行的（即标签位置不是手动设置的），则对齐同一子批次列中子批次的ylabels。

调用draw事件后，将继续对齐。

如果标签位于左侧，则它与轴上的标签对齐，这些轴的标签也位于左侧，并且具有相同的最左侧子批次列。如果标签位于右侧，则与具有相同最右侧列的轴上的标签对齐。

参数:

axs 名单 Axes名单

可选列表（或ndarray） Axes 对准依拉贝尔。默认为对齐图形上的所有轴。

参见

matplotlib.figure.Figure.align_xlabels

matplotlib.figure.Figure.align_labels

笔记

这假设 axs 都来自同一个地方 GridSpec 让他们 SubplotSpec 位置与图形位置相对应。

实例

带有大Ytick标签的示例：

fig, axs = plt.subplots(2, 1)
axs[0].plot(np.arange(0, 1000, 50))
axs[0].set_ylabel('YLabel 0')
axs[1].set_ylabel('YLabel 1')
fig.align_ylabels()

autofmt_xdate(bottom=0.2, rotation=30, ha='right', which='major')

日期刻度标签经常重叠，因此旋转它们并右对齐它们很有用。此外，一个常见的用例是具有共享XAX的多个子块，其中X轴是日期数据。滴答标签通常很长，它有助于在底部子批次上旋转它们，并在其他子批次上关闭它们，以及关闭XL标签。

参数:

bottom浮动，默认值：0.2

子批次的底部 subplots_adjust .

rotation浮动，默认值：30度

xtick标签的旋转角度（以度为单位）。

ha{'left'、'center'、'right'}，默认值：'right'

XtickLabels的水平对齐方式。

which{'major'，'minor'，'both'}，默认值：'major'

选择要旋转的标签。

property axes

图中的轴列表。您可以通过此列表访问和修改图形中的轴。

不要修改列表本身。相反，使用“添加u轴, add_subplot 或 delaxes 添加或删除轴。

clear(keep_observers=False)

清除图形--同义词 clf .

clf(keep_observers=False)

清除数字。

集合 keep_observers 例如，如果图形用户界面小部件正在跟踪图中的轴，则返回true。

colorbar(mappable, cax=None, ax=None, use_gridspec=True, **kw)

为scalarmapable实例创建颜色栏， 可映射的 .

Pyplot薄型包装的文档：

在绘图中添加颜色条。

的函数签名 pyplot 接口；除第一个外，所有都是 colorbar 方法：

colorbar(**kwargs)
colorbar(mappable, **kwargs)
colorbar(mappable, cax=cax, **kwargs)
colorbar(mappable, ax=ax, **kwargs)

参数:

mappable

这个 matplotlib.cm.ScalarMappable （即， AxesImage ， ContourSet 等等）由这个颜色条描述。此参数对于 Figure.colorbar 方法，但对于 pyplot.colorbar 函数，将默认值设置为当前图像。

注意，可以创建一个 ScalarMappable “动态”生成未附加到先前绘制的艺术家的色条，例如：

fig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)

cax ： Axes 可选可选轴

将要绘制颜色条的轴。

ax ： Axes ，轴列表，可选轴，轴列表，可选

将从中窃取新颜色条轴空间的父轴。如果给定了轴列表，则所有轴都将调整大小，以便为颜色条轴留出空间。

use_gridspec可选的布尔

如果 cax 是 None ，一个新的 cax 创建为轴的实例。如果 ax 是子批次的实例，并且 use_gridspec 是 True ， cax 使用 gridspec 模块。

返回:

彩条 ： Colorbar测控条

另请参见它的基类， ColorbarBase .

笔记

其他关键字参数有两种：

轴属性：

分数浮动，默认值：0.15

用于色条的原始轴的分数。

收缩浮动，默认值：1.0

要乘以色条大小的分数。

方面浮动，默认值：20

长短尺寸比。

衬垫浮动，默认值：垂直时为0.05，水平时为0.15

色条和新图像轴之间原始轴的分数。

锚（浮动，浮动）可选

颜色条轴的定位点。如果垂直，则默认为（0.0，0.5）；如果水平，则默认为（0.5，1.0）。

panchor：（float，float）或 假 可选（浮动，浮动），或

点颜色条的父颜色条。如果 假 ，父轴的定位将保持不变。如果垂直，则默认为（1.0，0.5）；如果水平，则默认为（0.5，0.0）。

颜色条属性：

财产	描述
延伸	{'never'、'both'、'min'、'max'}如果不是'never'，为超出范围的值指定一个或多个端点。这些是使用colormap set_under和set_over方法为给定colormap设置的。
扩展压裂	{ None ，'auto'，length，length}如果设置为 None ，最小和最大三角形颜色条延长线的长度为内部颜色条长度的5%（这是默认设置）。如果设置为“自动”，则使三角形颜色条延长与内部框的长度相同（当 间距 设置为“统一”或与相应的相邻内箱相同的长度（当 间距 设置为“成比例”）。如果是标量，则指示作为内部颜色条长度的一部分的最小和最大三角形颜色条扩展的长度。还可以给出分数的两个元素序列，分别表示作为内部颜色条长度的分数的最小和最大颜色条扩展的长度。
扩展码	布尔若 假 最小和最大颜色条扩展将是三角形的（默认）。如果 True 延伸部分应为矩形。
间距	{'uniform'，'proportional'}均匀间距为每个离散颜色提供相同的空间；proportional使空间与数据间隔成比例。
蜱类	None 或记号或定位器列表如果没有，则从输入自动确定记号。
格式	None或str或Formatter如果没有， ScalarFormatter 使用。如果给定格式字符串，例如“%.3f”，则使用该字符串。另一种选择 Formatter 可能会被取代。
排水楔	bool是否在颜色边界绘制线条。
标签	在colorbar的长轴上设置标签。

以下内容可能只在索引颜色的上下文（即，当可映射表具有norm=nonorm（）时）或其他异常情况下有用。

财产	描述
边界	无或序列
价值观	无或序列的长度必须小于 边界 . 对于由中相邻条目分隔的每个区域 边界 ，将使用映射到值中相应值的颜色。

如果 可映射的 是一个 ContourSet 它的 延伸 Kwarg自动包含在内。

这个 收缩 Kwarg提供了一种简单的方法来根据轴缩放颜色条。注意如果 cax ，它确定colorbar和 收缩 和 方面 夸克被忽略了。

要获得更精确的控制，可以手动指定轴对象的位置，其中绘制了可映射和颜色条。在这种情况下，不要使用任何轴属性Kwargs。

众所周知，一些矢量图形查看器（svg和pdf）呈现colorbar段之间的空白。这是由于查看器中的错误，而不是Matplotlib。作为解决方法，可以使用重叠的线段渲染colorbar:：

cbar = colorbar()
cbar.solids.set_edgecolor("face")
draw()

然而，这在其他情况下会产生负面影响，例如半透明图像（alpha<1）和colorbar扩展；因此，默认情况下不使用此解决方案（见问题1188）。

contains(mouseevent)

测试鼠标事件是否发生在图形上。

返回:

布尔，{}

delaxes(ax)

Remove the Axes ax from the figure; update the current axes.

property dpi

以每英寸点数表示的分辨率。

draw(renderer)

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

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

参数:

渲染器 ： RendererBase 子类。RenderBase子类。

笔记

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

draw_artist(a)

画 Artist 实例 a 只有。

这只能在绘制完图形后调用。

execute_constrained_layout(renderer=None)

使用 layoutbox 确定轴内的位置。

也见 set_constrained_layout_pads .

figimage(X, xo=0, yo=0, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, origin=None, resize=False, **kwargs)

将未重新采样的图像添加到图中。

图像附加到左下角或左上角，具体取决于 起源 .

参数:

X

图像数据。这是下列形状之一的数组：

• mxn：亮度（灰度）值
• MXNX3:RGB值
• MXNX4:RGBA值

XO，YO利息

这个 x / y 以像素为单位的图像偏移。

alpha无或浮动

alpha混合值。

norm ： matplotlib.colors.Normalizematplotlib.colors.Normalize

A Normalize 将亮度映射到间隔的实例 [0, 1] .

cmap : str or matplotlib.colors.Colormap, default: rcParams["image.cmap"] (default: 'viridis')str或

要使用的颜色映射。

VMN，Vmax浮动

如果 norm 如果没有给定，这些值将设置颜色映射的数据限制。

起源 : {{'upper', 'lower'}}, default: rcParams["image.origin"] (default: 'upper'){'upper'，'lower'}，默认值：

指示 [0, 0] 数组的索引位于轴的左上角或左下角。

resize布尔

如果 True ，调整图形大小以匹配给定的图像大小。

返回:

matplotlib.image.FigureImage

其他参数:

**kwargs

额外的禁运是 Artist 夸格斯转给了 FigureImage .

笔记

FigImage补充了轴图像 (imshow ）将重新采样以适合当前轴。如果希望重新采样的图像填充整个图形，可以定义 Axes 程度上 [0, 0, 1，1] .

实例

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()

property frameon

返回图形的背景补丁可见性，即是否绘制图形背景。相当于 Figure.patch.get_visible() .

gca(**kwargs)

获取当前轴，必要时创建一个。

为确保返回的轴与给定投影等保持一致，以及在不存在活动轴的情况下创建轴，支持以下Kwarg：

财产	描述
adjustable	'box'、'datalim'
agg_filter	一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha	浮动或无
anchor	2-浮点数或'c'、'sw'、's'、'se'、…
animated	布尔
aspect	{auto}或num
autoscale_on	布尔
autoscalex_on	布尔
autoscaley_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
prop_cycle	未知的
rasterization_zorder	浮动或无
rasterized	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
title	STR
transform	Transform
url	STR
visible	布尔
xbound	未知的
xlabel	STR
xlim	（底部：浮动，顶部：浮动）
xmargin	浮动大于-0.5
xscale	“Linear”，“Log”，“SymLog”，“Logit”，…
xticklabels	未知的
xticks	未知的
ybound	未知的
ylabel	STR
ylim	（底部：浮动，顶部：浮动）
ymargin	浮动大于-0.5
yscale	“Linear”，“Log”，“SymLog”，“Logit”，…
yticklabels	未知的
yticks	未知的
zorder	浮动

get_axes()

返回图中的轴列表。您可以通过此列表访问和修改图中的轴。

不要修改列表本身。相反，使用 add_axes ， add_subplot 或 delaxes 添加或删除轴。

注意：这相当于该属性 axes .

get_children()

获取包含在图中的艺术家列表。

get_constrained_layout()

返回是否正在使用受约束的布局。

见 受约束的布局参考线 .

get_constrained_layout_pads(relative=False)

获得填充 constrained_layout .

返回的列表 w_pad, h_pad 英寸和 wspace 和 hspace 作为子批次的一部分。

见 受约束的布局参考线 .

参数:

relative布尔

如果 True ，然后从英寸转换为相对图形。

get_default_bbox_extra_artists()

get_dpi()

以每英寸点数为单位返回浮动分辨率。

get_edgecolor()

获取图形矩形的边缘颜色。

get_facecolor()

获取图形矩形的面色。

get_figheight()

返回以英寸为单位的数字高度。

get_figwidth()

返回图形宽度（英寸）。

get_frameon()

返回图形的背景补丁可见性，即是否绘制图形背景。相当于 Figure.patch.get_visible() .

get_size_inches()

返回图形的当前大小（以英寸为单位）。

返回:

恩达雷

图形的大小（宽度、高度）以英寸为单位。

参见

matplotlib.figure.Figure.set_size_inches

matplotlib.figure.Figure.get_figwidth

matplotlib.figure.Figure.get_figheight

笔记

以像素为单位的大小可以通过乘以 Figure.dpi .

get_tight_layout()

返回是否 tight_layout 在绘制时调用。

get_tightbbox(renderer, bbox_extra_artists=None)

返回图形的（紧）边界框（以英寸为单位）。

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

参数:

渲染器 ： RendererBase 子类RenderBase子类

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

bbox_extra_artists 名单 Artist 或 None名单

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

返回:

BboxBase

包含边界框（以英寸为单位）。

get_window_extent(*args, **kwargs)

返回显示空间中的图形边界框。参数被忽略。

ginput(n=1, timeout=30, show_clicks=True, mouse_add=<MouseButton.LEFT: 1>, mouse_pop=<MouseButton.RIGHT: 3>, mouse_stop=<MouseButton.MIDDLE: 2>)

阻止调用以与图形交互。

等待直到用户单击 n 在图上的时间，并在列表中返回每次单击的坐标。

有三种可能的相互作用：

• 添加一个点。
• 删除最近添加的点。
• 停止交互并返回到目前为止添加的点数。

操作通过参数分配给鼠标按钮 mouse_add ， mouse_pop 和 mouse_stop .

参数:

nint，默认值：1

要累积的鼠标单击次数。如果为负，则累积单击直到手动终止输入。

timeout浮动，默认值：30秒

超时前等待的秒数。如果为零或为负，则不会超时。

show_clicksbool，默认值：True

如果为真，则在每次单击的位置显示一个红色十字。

mouse_add ： MouseButton 或无，默认值： MouseButton.LEFT鼠标按钮或无，默认值：鼠标按钮。左

用于添加点的鼠标按钮。

mouse_pop ： MouseButton 或无，默认值： MouseButton.RIGHT鼠标按钮或无，默认值：鼠标按钮。对

用于删除最近添加的点的鼠标按钮。

mouse_stop ： MouseButton 或无，默认值： MouseButton.MIDDLE鼠标按钮或无，默认值：鼠标按钮。中

用于停止输入的鼠标按钮。

返回:

元组列表

单击（x，y）坐标的列表。

笔记

如果鼠标没有一个或多个按钮，也可以使用键盘选择点。删除键和退格键的作用类似于右键单击（即删除最后一个点），Enter键终止输入，任何其他键（窗口管理器尚未使用）选择一个点。

init_layoutbox()

初始化layoutbox以在受约束的布局中使用。

legend(*args, **kwargs)

在图形上放置一个图例。

要从每个轴上的现有艺术家制作图例，请执行以下操作：

legend()

要为线条和标签列表制作图例，请执行以下操作：

legend(
    (line1, line2, line3),
    ('label1', 'label2', 'label3'),
    loc='upper right')

这些也可以通过以下关键字指定：

legend(
    handles=(line1, line2, line3),
    labels=('label1', 'label2', 'label3'),
    loc='upper right')

参数:

把手 名单 Artist 可选名单

要添加到图例中的艺术家（线条、面片）列表。和这个一起使用 标签 如果您需要完全控制图例中所示内容，并且上述自动机制还不够。

在这种情况下，手柄和标签的长度应该相同。如果不是，则将其截断为较小的长度。

labelsstr列表，可选

要在艺术家旁边显示的标签列表。和这个一起用 把手 如果您需要完全控制图例中所示内容，并且上述自动机制还不够。

返回:

Legend

其他参数:

loc : str or pair of floats, default: rcParams["legend.loc"] (default: 'best') （轴为“最佳”，数字为“右上角”）。str或float对，默认值：

图例的位置。

弦乐 'upper left', 'upper right', 'lower left', 'lower right' 将图例放在轴/图形的相应角上。

弦乐 'upper center', 'lower center', 'center left', 'center right' 将图例放置在轴/图形对应边缘的中心。

弦 'center' 将图例放置在轴/图形的中心。

弦 'best' 将图例放置在到目前为止定义的九个位置中，与其他绘制的艺术家的重叠最少。对于包含大量数据的打印，此选项可能会非常慢；提供特定位置可能会使打印速度受益。

位置也可以是2元组，以轴坐标表示图例左下角的坐标（在这种情况下 bbox_to_anchor 将被忽略）。

为了背部的兼容性， 'center right' （但没有其他位置）也可以拼写 'right' ，并且每个“字符串”位置也可以指定为一个数值：

位置字符串	位置代码
“最好”	0
右上角	1
“左上角”	2
“左下角”	3
右下角	4
“对”	5
“左中锋”	6
“中间偏右”	7
“下中心”	8
“上中心”	9
“中心”	10

bbox_to_anchor ： BboxBase ，2元组，或4元组浮点数bboxbase、2元组或4元组浮点数

用于将图例与 loc .默认为 axes.bbox （如果作为方法调用 Axes.legend 或 figure.bbox （如果 Figure.legend ）此参数允许任意放置图例。

bbox坐标在以下坐标系中解释： bbox_transform ，使用默认的变换轴或图形坐标，具体取决于 legend 被称为。

如果是4元组或 BboxBase 指定，然后指定bbox (x, y, width, height) 放置图例的位置。要将图例放置在轴（或图形）右下象限的最佳位置，请执行以下操作：

loc='best', bbox_to_anchor=(0.5, 0., 0.5, 0.5)

2-元组 (x, y) 放置由指定的图例角 loc 例如，要将图例的右上角置于轴（或图）的中心，可以使用以下关键字：

loc='upper right', bbox_to_anchor=(0.5, 0.5)

ncolint，默认值：1

图例的列数。

prop ：无或 matplotlib.font_manager.FontProperties 或DICT无或

图例的字体属性。如果没有（默认），则当前 matplotlib.rcParams 将被使用。

fontsizeint或{'xx-small'，'x-small'，'small'，'medium'，'large'，'x-large'，'xx-large'}

图例的字体大小。如果该值是数值，则大小将是以磅为单位的绝对字体大小。字符串值相对于当前默认字体大小。此参数仅在以下情况下使用 prop 未指定。

labelcolorstr或list

设置图例中文本的颜色。可以是有效的颜色字符串（例如“red”），也可以是颜色字符串列表。labelcolor还可以使用“linecolor”、“markerfacecolor”（或“mfc”）或“markeredgecolor”（或“mec”）使其与线条或标记的颜色匹配。

点数 : int, default: rcParams["legend.numpoints"] (default: 1)int，默认值：

为创建图例项时，图例中标记点的数目 Line2D （行）。

散乱点 : int, default: rcParams["legend.scatterpoints"] (default: 1)int，默认值：

为创建图例项时，图例中标记点的数目 PathCollection （散点图）。

散乱偏移 ：iterable of float，默认值： [0.375, 0.5, 0.3125]浮动的iterable，默认值：

为散点图图例项创建的标记的垂直偏移量（相对于字体大小）。0.0位于图例文本的底部，1.0位于顶部。若要在同一高度绘制所有标记，请设置为 [0.5] .

马氏标度 : float, default: rcParams["legend.markerscale"] (default: 1.0)浮动，默认值：

与最初绘制的图例标记相比，图例标记的相对大小。

markerfirstbool，默认值：True

如果 True ，图例标记放置在图例标签的左侧。如果 假 ，将图例的标签放置在图例的右侧。

框架 : bool, default: rcParams["legend.frameon"] (default: True)布尔，默认值：

图例是否应绘制在补片（框架）上。

软盒 : bool, default: rcParams["legend.fancybox"] (default: True)布尔，默认值：

是否应在 FancyBboxPatch 构成了传说的背景。

阴影 : bool, default: rcParams["legend.shadow"] (default: False)布尔，默认值：

是否在传说背后画上阴影。

框架α : float, default: rcParams["legend.framealpha"] (default: 0.8)浮动，默认值：

传说背景的透明度。如果 阴影 激活并 框架α 是 None ，默认值将被忽略。

脸色 : "inherit" or color, default: rcParams["legend.facecolor"] (default: 'inherit')“inherit”或“color”，默认值：

图例的背景色。如果 "inherit" 使用 rcParams["axes.facecolor"] (default: 'white') .

变色染料 : "inherit" or color, default: rcParams["legend.edgecolor"] (default: '0.8')“inherit”或“color”，默认值：

图例的背景面片边缘颜色。如果 "inherit" ，使用take rcParams["axes.edgecolor"] (default: 'black') .

mode“展开”，无

如果 mode 设置为 "expand" 图例将水平展开以填充轴区域（或 bbox_to_anchor 如果定义了图例的大小）。

bbox_transform ：无或 matplotlib.transforms.Transform无或

边界框的变换( bbox_to_anchor ）对于一个值 None （默认）轴' transAxes 将使用转换。

titleSTR或无

图例人物的头衔。默认为无标题 (None ）

title_fontsize : int or {{'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}}, default: rcParams["legend.title_fontsize"] (default: None)int或{'xx-small'、'x-small'、'small'、'medium'、'large'、'x-large'、'xx-large'}，默认值：

图例标题的字体大小。

边界焊盘 : float, default: rcParams["legend.borderpad"] (default: 0.4)浮动，默认值：

图例边框内的分数空格，以字体大小为单位。

标签间距 : float, default: rcParams["legend.labelspacing"] (default: 0.5)浮动，默认值：

图例项之间的垂直间距，以字体大小为单位。

手长 : float, default: rcParams["legend.handlelength"] (default: 2.0)浮动，默认值：

图例句柄的长度，以字体大小为单位。

手持插件 : float, default: rcParams["legend.handletextpad"] (default: 0.8)浮动，默认值：

图例句柄和文本之间的填充区，以字体大小为单位。

边界轴焊盘 : float, default: rcParams["legend.borderaxespad"] (default: 0.5)浮动，默认值：

轴和图例边框之间的填充区，以字体大小为单位。

柱间距 : float, default: rcParams["legend.columnspacing"] (default: 2.0)浮动，默认值：

列之间的间距，以字体大小为单位。

handler_map不记名

将实例或类型映射到图例处理程序的自定义字典。这个 handler_map 更新在中找到的默认处理程序映射 matplotlib.legend.Legend.get_legend_handler_map .

笔记

此函数不支持某些艺术家。看到了吗 图例指南 有关详细信息。

savefig(fname, *, transparent=None, **kwargs)

保存当前图形。

呼叫签名：

savefig(fname, dpi=None, facecolor='w', edgecolor='w',
        orientation='portrait', papertype=None, format=None,
        transparent=False, bbox_inches=None, pad_inches=0.1,
        frameon=None, metadata=None)

可用的输出格式取决于所使用的后端。

参数:

fnamestr或path like或file like

路径，或者类似Python文件的对象，或者可能是一些后端相关的对象，例如 matplotlib.backends.backend_pdf.PdfPages .

如果 格式 设置时，它确定输出格式，并将文件另存为 文件名 .注意 文件名 是逐字使用的，并且没有试图对 文件名 比赛 格式 ，不追加扩展名。

如果 格式 则从 文件名 ，如果有的话。如果 格式 未设置和 文件名 没有扩展名，则文件将与一起保存 rcParams["savefig.format"] (default: 'png') 并将适当的扩展附加到 文件名 .

其他参数:

dpi : float or 'figure', default: rcParams["savefig.dpi"] (default: 'figure')float或'figure'，默认值：

以每英寸点数为单位的分辨率。如果是“figure”，则使用数字的dpi值。

**** : int, default: rcParams["savefig.jpeg_quality"] (default: 95)int，默认值：

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

图像质量，从1（最差）到95（最佳）。应该避免95以上的值；100会禁用JPEG压缩算法的某些部分，并导致大文件的图像质量几乎没有任何提高。

此参数已弃用。

optimizebool，默认值：False

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

编码器是否应该对图像进行额外的传递，以便选择最佳编码器设置。

此参数已弃用。

progressivebool，默认值：False

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

是否应将图像存储为渐进式JPEG文件。

此参数已弃用。

脸色 : color or 'auto', default: rcParams["savefig.facecolor"] (default: 'auto')颜色或“自动”，默认值：

人物的脸色。如果为“自动”，则使用当前地物颜色。

变色染料 : color or 'auto', default: rcParams["savefig.edgecolor"] (default: 'auto')颜色或“自动”，默认值：

人物的边缘颜色。如果为“自动”，则使用当前地物边颜色。

orientation‘横向’，‘纵向’

目前只有PostScript后端支持。

papertypeSTR

“Letter”、“Legal”、“Executive”、“Ledger”、“A0”到“A10”、“B0”到“B10”之一。仅支持PostScript输出。

formatSTR

文件格式，例如“png”、“pdf”、“svg”。。。未设置此选项时的行为记录在下 文件名 .

transparent布尔

如果 True ，轴补丁都将是透明的；图形补丁也将是透明的，除非通过Kwargs指定了面颜色和/或边缘颜色。例如，这对于在网页的彩色背景顶部显示绘图很有用。退出此功能后，这些补丁的透明度将恢复为其原始值。

bbox_inches : str or Bbox, default: rcParams["savefig.bbox"] (default: None)str或

以英寸为单位的边界框：仅保存图形的给定部分。如果“紧”，试着找出这个数字的紧框。

pad_inches : float, default: rcParams["savefig.pad_inches"] (default: 0.1)浮动，默认值：

当bboxu英寸“紧”时，图形周围的填充量。

bbox_extra_artists 名单 Artist 可选名单

当计算Tight BBox时将考虑的额外艺术家列表。

backend可选的STR

使用非默认后端渲染文件，例如，使用“cairo”后端而不是默认的“agg”渲染png文件，或使用“pgf”后端而不是默认的“pdf”渲染pdf文件。请注意，默认后端通常是足够的。看到了吗 内置后端 获取每个文件格式的有效后端列表。自定义后端可以引用为“模块：//。。。".

metadata可选的

要存储在图像元数据中的键/值对。支持的密钥和默认值取决于图像格式和后端：

• 带agg后端的“png”：参见参数 metadata 属于 print_png .
• 带PDF后端的“pdf”：请参见参数 metadata 属于 PdfPages .
• 带有svg后端的“svg”：请参见参数 metadata 属于 print_svg .
• “eps”和“ps”与ps后端：仅支持“creator”。

pil_kwargs可选的

传递给的其他关键字参数 PIL.Image.Image.save 保存图形时。

sca(a)

将当前轴设置为 a 然后返回 a .

set_canvas(canvas)

设置包含图形的画布

参数:

canvasFigureCanvas

set_constrained_layout(constrained)

设置是否 constrained_layout 在绘图时使用。如果没有， rcParams["figure.constrained_layout.use"] (default: False) 将使用值。

提供包含键的dict时 w_pad ， h_pad 默认值 constrained_layout 填充将被覆盖。这些衬垫以英寸为单位，默认值为3.0/72.0。 w_pad 是宽度填充和 h_pad 是高度填充。

见 受约束的布局参考线 .

参数:

constrainedbool或dict或none

set_constrained_layout_pads(**kwargs)

设置填充 constrained_layout . 注意：Kwargs可以作为字典传递 fig.set_constrained_layout(**paddict) .

见 受约束的布局参考线 .

参数:

w_pad浮动

宽度填充（英寸）。这是围绕轴的垫子，旨在确保有足够的空间让字体看起来更漂亮。默认为3点=0.04167英寸

h_pad浮动

高度填充（英寸）。默认为3分。

wspace浮动

子批次之间的宽度填充，表示为子批次宽度的分数。总填充量最终是w_pad+wspace。

hspace浮动

子批次之间的高度填充，表示为子批次宽度的分数。最后填充的总空间为h_pad+hspace。

set_dpi(val)

设置图形的分辨率（以每英寸点数为单位）。

参数:

val浮动

set_edgecolor(color)

设置图形矩形的边缘颜色。

参数:

color颜色

set_facecolor(color)

设置图形矩形的面颜色。

参数:

color颜色

set_figheight(val, forward=True)

以英寸为单位设置图形的高度。

参数:

val浮动

forward布尔

见 set_size_inches .

参见

matplotlib.figure.Figure.set_figwidth

matplotlib.figure.Figure.set_size_inches

set_figwidth(val, forward=True)

以英寸为单位设置图形的宽度。

参数:

val浮动

forward布尔

见 set_size_inches .

参见

matplotlib.figure.Figure.set_figheight

matplotlib.figure.Figure.set_size_inches

set_frameon(b)

设置图形的背景补丁可见性，即是否绘制图形背景。相当于 Figure.patch.set_visible() .

参数:

b布尔

set_size_inches(w, h=None, forward=True)

以英寸为单位设置图形大小。

呼叫签名：

fig.set_size_inches(w, h)  # OR
fig.set_size_inches((w, h))

参数:

w（浮动，浮动）或浮动

以英寸为单位的宽度和高度（如果高度未指定为单独的参数）或宽度。

h浮动

高度（英寸）。

forwardbool，默认值：True

如果 True ，画布大小会自动更新，例如，您可以从shell中调整图形窗口的大小。

参见

matplotlib.figure.Figure.get_size_inches

matplotlib.figure.Figure.set_figwidth

matplotlib.figure.Figure.set_figheight

笔记

从像素到英寸除以 Figure.dpi .

set_tight_layout(tight)

设置是否以及如何 tight_layout 在绘制时调用。

参数:

tight带“pad”、“w_pad”、“h_pad”、“rect”或无键的bool或dict

如果是bool，设置是否调用 tight_layout 绘画时。如果 None 使用 figure.autolayout 改为RCPARAM。如果是口述，就把它当作禁忌传给 tight_layout ，覆盖默认填充。

show(warn=True)

如果将GUI后端与Pyplot一起使用，则显示Figure窗口。

如果图形不是使用 figure ，它将缺少 FigureManagerBase ，此方法将引发AttributeError。

警告

这不管理GUI事件循环。因此，如果您或您的环境没有管理事件循环，则该图可能只会短暂显示或根本不显示。

适当的用例 Figure.show 包括从一个GUI应用程序或ipythonshell运行它。

如果您正在运行纯pythonshell或执行非GUI python脚本，那么应该使用 matplotlib.pyplot.show 相反，它负责为您管理事件循环。

参数:

warnbool，默认值：True

如果 True 而且我们没有运行headless（即在带有未设置显示的Linux上），在非GUI后端调用时发出警告。

subplot_mosaic(layout, *, subplot_kw=None, gridspec_kw=None, empty_sentinel='.')

基于ASCII艺术或嵌套列表构建轴布局。

这是一个帮助函数，可以直观地构建复杂的GridSpec布局。

注解

此API是临时的，将来可能会根据早期用户反馈进行修订。

参数:

layout{hashable or nested}或str的列表

一个可视化的布局，你希望你的轴如何排列标记为字符串。例如：：

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

产生4个轴：

• “一个面板”，一行高，横跨前两列
• “边缘”为2行高，位于右侧边缘
• “C面板”，左下角1行1列宽
• 底部中间有一行一列宽的空格

布局中的任何条目都可以是相同形式的列表列表，以创建嵌套布局。

如果输入是str，则其格式必须为：

'''
AAE
C.E
'''

其中每个字符是一列，每行是一行。这只允许单字符轴标签，不允许嵌套，但非常简洁。

subplot_kw可选的

关键字传递到 Figure.add_subplot 用于创建每个子批次的调用。

gridspec_kw可选的

关键字传递到 GridSpec 用于创建子批次所在的网格的构造函数。

empty_sentinel对象，可选

布局中的条目表示“将此空间留空”。默认为 '.' . 注意，如果 布局 是字符串，通过 inspect.cleandoc 删除前导空格，这可能会干扰将空格用作空哨兵。

返回:

双关语 [标签，轴]

将标签映射到轴对象的字典。

subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, subplot_kw=None, gridspec_kw=None)

在此图中添加一组子图。

这个实用程序包装器使在一次调用中创建子块的公共布局变得方便。

参数:

恩罗int，默认值：1

子批次网格的行/列数。

斯莱西bool或'none'、'all'、'row'、'col'，默认值：false

控制x之间的属性共享( 股票 )或y( 共享 轴：

• “全部”或“全部”：X轴或Y轴将在所有子批次之间共享。
• 假或“无”：每个子批次X轴或Y轴都是独立的。
• “row”：每个子批次行将共享一个X轴或Y轴。
• “col”：每个子批次列将共享一个x轴或y轴。

当子批次沿列具有共享的X轴时，仅创建底部子批次的X记号标签。同样，当子批次沿行具有共享的Y轴时，只创建第一列子批次的Y记号标签。要稍后打开其他子批次的标记标签，请使用 tick_params .

squeezebool，默认值：True

• 如果为真，则从返回的轴数组中挤出额外的尺寸：
  • 如果只构造了一个子块（nrows=ncols=1），则生成的单轴对象将作为标量返回。
  • 对于nx1或1xm子批次，返回的对象是轴对象的1d numpy对象数组。
  • 对于nxm，n>1和m>1的子批次作为二维数组返回。
• 如果为false，则根本不进行压缩：返回的axes对象始终是包含axes实例的2d数组，即使它最终是1x1。

subplot_kw可选的

将关键字传递给 Figure.add_subplot 用于创建每个子批次的调用。

gridspec_kw可选的

将关键字传递给 GridSpec 用于创建子批次所在的网格的构造函数。

返回:

Axes 或轴阵列

一个单人间 Axes 对象或轴对象数组（如果创建了多个子图）。可以使用 挤压 关键字，见上文。

参见

pyplot.subplots

Figure.add_subplot

pyplot.subplot

实例

# First create some toy data:
x = np.linspace(0, 2*np.pi, 400)
y = np.sin(x**2)

# Create a figure
plt.figure()

# Create a subplot
ax = fig.subplots()
ax.plot(x, y)
ax.set_title('Simple plot')

# Create two subplots and unpack the output array immediately
ax1, ax2 = fig.subplots(1, 2, sharey=True)
ax1.plot(x, y)
ax1.set_title('Sharing Y axis')
ax2.scatter(x, y)

# Create four polar axes and access them through the returned array
axes = fig.subplots(2, 2, subplot_kw=dict(polar=True))
axes[0, 0].plot(x, y)
axes[1, 1].scatter(x, y)

# Share a X axis with each column of subplots
fig.subplots(2, 2, sharex='col')

# Share a Y axis with each row of subplots
fig.subplots(2, 2, sharey='row')

# Share both X and Y axes with all subplots
fig.subplots(2, 2, sharex='all', sharey='all')

# Note that this is the same as
fig.subplots(2, 2, sharex=True, sharey=True)

subplots_adjust(left=None, bottom=None, right=None, top=None, wspace=None, hspace=None)

调整子地块布局参数。

未设置的参数保持不变；初始值由 rcParams["figure.subplot.[name]"] .

参数:

left可选浮动

子图左边缘的位置，作为图形宽度的一部分。

right可选浮动

子图右边缘的位置，作为图形宽度的一部分。

bottom可选浮动

子图底边的位置，作为图形高度的一部分。

top可选浮动

子图顶部边缘的位置，作为图形高度的一部分。

wspace可选浮动

子插槽之间填充的宽度，作为平均轴宽度的一部分。

hspace可选浮动

子插槽之间的填充高度，作为平均轴高度的分数。

suptitle(t, **kwargs)

在图形中添加居中的标题。

参数:

tSTR

标题文本。

x浮动，默认为0.5

文本在图形坐标中的X位置。

y浮动，默认为0.98

文本在图形坐标中的Y位置。

水平信号，ha'center'、'left'、'right'，默认值：'center'

文本相对于（ x ， y ）

垂直对准，VA'top'、'center'、'bottom'、'baseline'，默认值：'top'

文本相对于（ x ， y ）

尺寸大小 : default: rcParams["figure.titlesize"] (default: 'large')违约：

文本的字体大小。见 Text.set_size 对于可能的值。

字体重量，重量 : default: rcParams["figure.titleweight"] (default: 'normal')违约：

文本的字体粗细。见 Text.set_weight 对于可能的值。

返回:

文本

这个 Text 标题的实例。

其他参数:

fontproperties无或听写，可选

字体属性的字典。如果 字体属性 给定的字体大小和粗细的默认值取自 FontProperties 默认值。 rcParams["figure.titlesize"] (default: 'large') 和 rcParams["figure.titleweight"] (default: 'normal') 在这种情况下被忽略。

**kwargs

额外的禁运是 matplotlib.text.Text 性质。

实例

>>> fig.suptitle('This is the figure title', fontsize=12)

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

将文本添加到图中。

参数:

x, y浮动

放置文本的位置。默认情况下，这是在图形坐标中，浮动在 [0, 1] . 坐标系可以使用 转型 关键字。

sSTR

文本字符串。

fontdict可选的

用于替代默认文本属性的词典。如果未给出，则默认值由 rcParams["font.*"] . 传递为的属性 关键字参数 覆盖中给出的相应值 方块 .

返回:

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	浮动

参见

Axes.text

pyplot.text

tight_layout(renderer=<deprecated parameter>, pad=1.08, h_pad=None, w_pad=None, rect=None)

调整子批次之间和周围的填充。

要从确定子地块参数（即图例或注释）的边界框计算中排除轴上的艺术家，请设置 a.set_in_layout(False) 为了那个艺术家。

参数:

渲染器 子类 RendererBase 可选亚类

默认为地物的渲染器。已弃用。

pad浮动，默认值：1.08

在图形边缘和子批次边缘之间填充，作为字体大小的一部分。

h_pad, w_pad ：float，默认值： pad浮动，默认值：

相邻子块边缘之间的填充（高度/宽度），作为字体大小的一部分。

rect元组（左、下、右、上），默认值：（0、0、1、1）

标准化图形坐标中的一个矩形，整个子图区域（包括标签）将适合该矩形。

参见

Figure.set_tight_layout

pyplot.tight_layout

waitforbuttonpress(timeout=- 1)

阻止调用以与图形交互。

等待用户输入，如果按了键，则返回True；如果按了鼠标按钮，则返回False；如果没有输入，则返回None 超时 秒。负值停用 超时 .

使用实例 matplotlib.figure.Figure

使用导航工具栏嵌入GTK3

嵌入GTK3

QT中的嵌入

嵌入Tk

嵌入wx#2

嵌入wx#3

嵌入wx#4

嵌入wx#5

嵌入webagg

傅立叶演示

GTK电子表格

数学文本

带Glade 3的Matplotlib

Wx游标演示