matplotlib.pyplot.figure

matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, facecolor=None, edgecolor=None, frameon=True, FigureClass=<class 'matplotlib.figure.Figure'>, clear=False, **kwargs)[源代码]

创建新地物或激活现有地物。

参数:
numint或str，可选

地物的唯一标识符。

如果具有该标识符的地物已经存在，则该地物将被激活并返回。整数是指 Figure.number 属性，字符串引用地物标签。

如果没有带有标识符或 num 则会创建一个新图形，并使其处于活动状态并返回。如果 num 是一个int，它将用于 Figure.number 属性，否则，将使用自动生成的整数值（从1开始，并为每个新图形递增）。如果 num 是字符串，图形标签和窗口标题设置为该值。

图幅 : (float, float), default: rcParams["figure.figsize"] (default: [6.4, 4.8])（float，float），默认值：

宽度，高度单位为英寸。

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

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

脸色 : color, default: rcParams["figure.facecolor"] (default: 'white')颜色，默认值：

背景色。

变色染料 : color, default: rcParams["figure.edgecolor"] (default: 'white')颜色，默认值：

边框颜色。

frameonbool，默认值：True

如果为“假”，则取消绘制图形框。

FigureClass 子类 Figure亚类

可选使用自定义 Figure 实例。

clearbool，默认值：False

如果为真且该数字已存在，则清除该数字。

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 ）

**kwargs : optional

见 Figure 其他可能的论点。
返回:
Figure

这个 Figure 返回的实例也将被传递到后端的新的u图管理器，它允许钩住自定义 Figure 类进入pyplot接口。额外的禁运将传递给 Figure 初始化函数。

笔记

如果要创建许多图形，请确保显式调用 pyplot.close 在您不使用的图形上，因为这样可以使Pyplot正确地清理内存。

rcParams 定义可以在matplotlibrc文件中修改的默认值。