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)[source]#

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

参数:

numint 或 str 或 Figure 或 SubFigure，可选

图形的唯一标识符。

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

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

如果 num 是一个已经在 pyplot 中追踪的 Figure 实例，则将其激活。如果 num 是一个尚未在 pyplot 中追踪的 Figure 实例，则将其添加到已追踪图形中并激活。

figsize(float, float) 或 (float, float, str)，默认：rcParams["figure.figsize"]（默认：[6.4, 4.8]）

图形尺寸。可以是：

元组 (width, height, unit)，其中 unit 为 "inch"（英寸）、"cm"（厘米）或 "px"（像素）之一。
元组 (x, y)，被解释为 (x, y, "inch")。

width 或 height 中的某一个可以是 None；相应的值将取自 rcParams["figure.figsize"]（默认：[6.4, 4.8]）。

dpifloat，默认：rcParams["figure.dpi"]（默认：100.0）

图表的分辨率，单位为每英寸点数。

facecolor颜色，默认：rcParams["figure.facecolor"]（默认：'white'）

背景颜色。

edgecolor颜色，默认：rcParams["figure.edgecolor"]（默认：'white'）

边框颜色。

frameonbool，默认值：True

如果为 False，则抑制绘制图表边框。

FigureClassFigure 的子类

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

clearbool，默认：False

如果为 True 且图形已存在，则将其清除。

layout{'constrained', 'compressed', 'tight', 'none', LayoutEngine, None}，默认：None

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

'constrained': 受限布局求解器会调整坐标轴大小以避免坐标轴装饰重叠。可以处理复杂的绘图布局和颜色条，因此推荐使用。

参见受限布局指南获取示例。
'compressed': 使用与 'constrained' 相同的算法，但会移除固定纵横比坐标轴之间的额外空间。最适合简单的坐标轴网格。
'tight': 使用紧凑布局机制。这是一种相对简单的算法，通过调整子图参数来防止装饰重叠。详细信息请参阅 Figure.set_tight_layout。
'none': 不使用布局引擎。
一个 LayoutEngine 实例。内置布局类包括 ConstrainedLayoutEngine 和 TightLayoutEngine，通过 'constrained' 和 'tight' 更容易访问。传递一个实例允许第三方提供他们自己的布局引擎。

如果未给出，则回退使用参数 tight_layout 和 constrained_layout，包括它们的配置默认值 rcParams["figure.autolayout"]（默认：False）和 rcParams["figure.constrained_layout.use"]（默认：False）。

**kwargs

额外的关键字参数将传递给 Figure 构造函数。

返回:

Figure

备注

新创建的图形将传递给当前后端提供的 new_manager 方法或 new_figure_manager 函数，这些方法会在图形上安装画布和管理器。

完成此操作后，rcParams["figure.hooks"]（默认：[]）将依次在图形上调用；这些钩子允许对图形（例如附加回调）或相关元素（例如修改工具栏）进行任意自定义。参见 mplcvd -- 图形钩子示例获取工具栏自定义的示例。

matplotlib.pyplot.figure#

使用 matplotlib.pyplot.figure 的示例#

使用 `matplotlib.pyplot.figure` 的示例#