matplotlib.gridspec.GridSpec#

class matplotlib.gridspec.GridSpec(nrows, ncols, figure=None, left=None, bottom=None, right=None, top=None, wspace=None, hspace=None, width_ratios=None, height_ratios=None)[source]#

基类：GridSpecBase

用于在图形中放置子图的网格布局。

网格单元格的位置与 SubplotParams 类似，通过 left, right, top, bottom, wspace 和 hspace 确定。

索引 GridSpec 实例会返回一个 SubplotSpec。

参数:

nrows, ncols整型: 网格的行数和列数。
figureFigure，可选: 仅用于受限布局以创建合适的布局网格。
left, right, top, bottom浮点型，可选: 子图的范围，表示为图形宽度或高度的分数。左边不能大于右边，底部不能大于顶部。如果未指定，这些值将在绘制时从图形或 rcParams 中推断。另请参阅 GridSpec.get_subplot_params。
wspacefloat, 可选: 为子图之间空间保留的宽度，表示为平均轴宽度的分数。如果未指定，这些值将在必要时从图形或 rcParams 中推断。另请参阅 GridSpec.get_subplot_params。
hspacefloat, 可选: 为子图之间空间保留的高度，表示为平均轴高度的分数。如果未指定，这些值将在必要时从图形或 rcParams 中推断。另请参阅 GridSpec.get_subplot_params。
width_ratios长度为 ncols 的类数组，可选: 定义列的相对宽度。每列的相对宽度为 width_ratios[i] / sum(width_ratios)。如果未指定，所有列将具有相同的宽度。
height_ratios长度为 nrows 的类数组，可选: 定义行的相对高度。每行的相对高度为 height_ratios[i] / sum(height_ratios)。如果未指定，所有行将具有相同的高度。

get_subplot_params(figure=None)[source]#

返回 GridSpec 的 SubplotParams。

按优先顺序，这些值取自：

GridSpec 的非 None 属性
提供的 figure
rcParams["figure.subplot.*"]

请注意，GridSpec 的 figure 属性始终被忽略。

locally_modified_subplot_params()[source]#

返回在 GridSpec 中显式设置的子图参数名称列表。

这是 SubplotParams 属性的一个子集。

tight_layout(figure, renderer=None, pad=1.08, h_pad=None, w_pad=None, rect=None)[source]#

调整子图参数以提供指定的填充。

参数:

figureFigure: 图形对象。
rendererRendererBase 子类，可选: 要使用的渲染器。
pad浮点数: 图形边缘与子图边缘之间的填充，表示为字体大小的一部分。
h_pad, w_pad浮点型，可选: 相邻子图边缘之间的填充（高度/宽度）。默认为 pad。
rect元组 (left, bottom, right, top)，默认值：None: 在归一化图形坐标系中的 (left, bottom, right, top) 矩形，整个子图区域（包括标签）将适应其中。默认值 (None) 是整个图形。