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或SubFigure，可选 图表的唯一标识符。
如果具有该标识符的图表已存在，则该图表将被激活并返回。整数指代
Figure.number属性，字符串指代图表标签。如果没有具有该标识符的图表或未给出 *num*，则创建一个新图表，将其激活并返回。如果 *num* 是一个整数，它将用于
Figure.number属性，否则，将使用自动生成的整数值（从 1 开始，并为每个新图表递增）。如果 *num* 是一个字符串，图表标签和窗口标题将设置为此值。如果 *num* 是一个SubFigure，则其父Figure将被激活。- figsize(float, float)，默认值：
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，则抑制绘制图表边框。
- FigureClass
Figure的子类 如果设置，将创建此子类的实例，而不是普通的
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构造函数。
- numint 或 str 或
- 返回:
备注
新创建的图表将传递给当前后端提供的
new_manager方法或new_figure_manager函数，它们会在图表上安装画布和管理器。完成此操作后，将对图表逐个调用
rcParams["figure.hooks"](默认值：[])；这些钩子允许对图表（例如，附加回调）或相关元素（例如，修改工具栏）进行任意自定义。有关工具栏自定义的示例，请参阅 mplcvd -- 图表钩子的示例。如果您正在创建许多图表，请确保对不使用的图表显式调用
pyplot.close，因为这将使 pyplot 能够正确清理内存。rcParams定义了默认值，可以在 matplotlibrc 文件中修改。
