matplotlib.figure.Figure.subfigures#
- Figure.subfigures(nrows=1, ncols=1, squeeze=True, wspace=None, hspace=None, width_ratios=None, height_ratios=None, **kwargs)[source]#
向此图形或子图形添加一组子图形。
子图(subfigure)拥有与 Figure 相同的艺术家(artist)方法,逻辑上与 Figure 相同,但无法自行打印。请参见 Figure subfigures。
3.10 版本中变更:子图现在以行优先顺序添加。
- 参数:
- nrows, ncols整型, 默认值: 1
子图网格的行/列数。
- squeeze布尔型, 默认值: True
如果为 True,则从返回的子图数组中挤压掉额外的维度。
- wspace, hspace浮点数,默认值:None
为子图之间保留的宽度/高度空间大小,表示为子图平均宽度/高度的分数。如果未指定,当使用约束布局(constrained layout)时,其值将从 rcParams 中推断(参见
ConstrainedLayoutEngine),如果不使用布局引擎,则默认为零。- width_ratios长度为 ncols 的类数组,可选
定义各列的相对宽度。每一列获得的相对宽度为
width_ratios[i] / sum(width_ratios)。如果未提供,所有列的宽度相同。- height_ratios长度为 nrows 的类数组,可选
定义各行的相对高度。每一行获得的相对高度为
height_ratios[i] / sum(height_ratios)。如果未提供,所有行的高度相同。