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`¶

目录

Related Topics

matplotlib.figure.Figure¶

使用实例 `matplotlib.figure.Figure`¶

财产	描述
延伸	{'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的长轴上设置标签。

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

matplotlib.figure.Figure¶

使用实例 matplotlib.figure.Figure¶

使用实例 `matplotlib.figure.Figure`¶