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

基类：GridSpecBase

一种网格布局，用于在图形中放置子图。

网格单元的位置是通过类似于 SubplotParams 的方式确定的，使用 left、right、top、bottom、wspace 和 hspace。

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

参数:

nrows, ncols整数: 网格的行数和列数。
figure : Figure, 可选图，可选: 仅用于约束布局以创建适当的布局网格。
左, 右, 上, 下float, 可选: 子图的范围作为图形宽度或高度的分数。左不能大于右，底不能大于顶。如果没有给出，这些值将在绘图时从图形或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)[源代码][源代码]#

返回 GridSpec 的 SubplotParams。

按照优先顺序，值从以下来源获取

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

请注意，GridSpec 的 figure 属性总是被忽略。

locally_modified_subplot_params()[源代码][源代码]#

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

这是 SubplotParams 属性的一部分。

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

调整子图参数以给出指定的填充。

参数:

figure图: 图示。
渲染器 : RendererBase 子类, 可选RendererBase 子类，可选: 要使用的渲染器。
填充浮动: 图形边缘与子图边缘之间的填充，作为字体大小的分数。
h_pad, w_padfloat, 可选: 相邻子图边缘之间的填充（高度/宽度）。默认为 pad。
rect元组 (左, 下, 右, 上)，默认: None: (左, 底, 右, 顶) 矩形在归一化图形坐标中，整个子图区域（包括标签）将适合其中。默认 (None) 是整个图形。