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)[源代码][源代码]#

创建一个新图形，或激活一个现有图形。

参数:

num : int 或 str 或 Figure 或 SubFigure, 可选int 或 str 或

该图的唯一标识符。

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

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

figsize : (float, float), 默认值: rcParams["figure.figsize"] (default: [6.4, 4.8])(浮点数, 浮点数), 默认值:

宽度，高度以英寸为单位。

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

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

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

背景颜色。

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

边框颜色。

frameonbool, 默认: True

如果为 False，则抑制绘制图形框架。

FigureClass : Figure 的子类子类

如果设置，将创建此子类的实例，而不是普通的 Figure。

清除bool, 默认: False

如果为真且图形已存在，则清除该图形。

布局 : {'constrained', 'compressed', 'tight', 'none', LayoutEngine, None}, 默认: None{'constrained', 'compressed', 'tight', 'none',}

用于定位绘图元素以避免重叠 Axes 装饰（标签、刻度等）的布局机制。请注意，布局管理器可能会显著减慢图形显示速度。

'constrained': 约束布局求解器调整Axes的大小以避免Axes装饰的重叠。能够处理复杂的图表布局和颜色条，因此推荐使用。

参见约束布局指南的示例。
'compressed': 使用与 'constrained' 相同的算法，但去除了固定纵横比 Axes 之间的额外空间。最适合简单的 Axes 网格。
'tight': 使用紧凑布局机制。这是一个相对简单的算法，调整子图参数以避免装饰重叠。更多细节请参见 Figure.set_tight_layout。
'none': 不使用布局引擎。
一个 LayoutEngine 实例。内置的布局类是 ConstrainedLayoutEngine 和 TightLayoutEngine，更方便地通过 'constrained' 和 'tight' 访问。传递一个实例允许第三方提供他们自己的布局引擎。

如果没有指定，则回退到使用参数 tight_layout 和 constrained_layout，包括它们的配置默认值 rcParams["figure.autolayout"] (default: False) 和 rcParams["figure.constrained_layout.use"] (default: False)。

**kwargs