matplotlib.gridspec.SubplotSpec#

class matplotlib.gridspec.SubplotSpec(gridspec, num1, num2=None)[源代码][源代码]#

基类：object

GridSpec 中子图的位置。

备注

很可能，你永远不会自己实例化一个 SubplotSpec。相反，你通常会通过项目访问从 GridSpec 中获取一个。

参数:
gridspecGridSpec

子图所引用的 GridSpec。

num1, num2整数

子图将占据给定 gridspec 的第 num1 个单元格。如果提供了 num2，子图将跨越从第 num1 个单元格到第 num2 个单元格 包括。

索引从 0 开始。

property colspan#

这个子图所跨越的列，作为一个 range 对象。

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

返回子图几何结构为元组 (n_rows, n_cols, start, stop)。

索引 start 和 stop 定义了子图在 GridSpec 中的范围。stop 是包含的（即对于单个单元格 start == stop）。

get_gridspec()[源代码][源代码]#
get_position(figure)[源代码][源代码]#

从 figure.subplotpars 更新子图位置。

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

返回与子图关联的最顶层的 SubplotSpec 实例。

is_first_col()[源代码][源代码]#
is_first_row()[源代码][源代码]#
is_last_col()[源代码][源代码]#
is_last_row()[源代码][源代码]#
property num2#

!! 由 numpydoc 处理 !!

property rowspan#

这个子图所跨越的行，作为一个 range 对象。

subgridspec(nrows, ncols, **kwargs)[源代码][源代码]#

在此子图中创建一个 GridSpec。

创建的 GridSpecFromSubplotSpec 将把这个 SubplotSpec 作为父级。

参数:
nrows整数

网格中的行数。

ncols整数

网格中的列数。

返回:
GridSpecFromSubplotSpec
其他参数:
**kwargs

所有其他参数都传递给 GridSpecFromSubplotSpec。

参见

matplotlib.pyplot.subplots

示例

在一个子图占用的空间中添加三个子图:

fig = plt.figure()
gs0 = fig.add_gridspec(3, 1)
ax1 = fig.add_subplot(gs0[0])
ax2 = fig.add_subplot(gs0[1])
gssub = gs0[2].subgridspec(1, 3)
for i in range(3):
    fig.add_subplot(gssub[0, i])

使用 matplotlib.gridspec.SubplotSpec 的示例#

嵌套的 GridSpecs

Nested GridSpecs

约束布局指南

Constrained layout guide

在图形中排列多个轴

Arranging multiple Axes in a Figure
On this page