mpl_gui.FigureRegistry.subplot_mosaic#

FigureRegistry.subplot_mosaic(*, subplot_kw=None, gridspec_kw=None, empty_sentinel='.', **fig_kw)#

根据 ASCII 艺术或嵌套列表构建 Axes 布局。

这是一个辅助函数,用于以可视化方式构建复杂的 GridSpec 布局。

注意

此API是临时的,未来可能会根据早期用户反馈进行修订。

参数:
layoutlist of list of {可哈希或嵌套} 或 str

一个可视化布局,说明您希望 Axes 如何以字符串形式排列。例如

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

生成 4 个坐标轴

  • “A 面板”,高度为 1 行,并跨越前两列

  • “边”,高度为 2 行,位于右边缘

  • “C 面板”,位于左下角,占 1 行 1 列

  • 底部中央有一个 1 行 1 列宽的空白区域

布局中的任何条目都可以是相同形式的列表的列表,以创建嵌套布局。

如果输入是字符串,则必须是以下形式

'''
AAE
C.E
'''

其中每个字符代表一列,每行代表一行。这只允许使用单个字符作为 Axes 标签,不支持嵌套,但非常简洁。

subplot_kw字典,可选

包含传递给 add_subplot 调用以创建每个子图的关键字的字典。

gridspec_kw字典,可选

包含传递给 GridSpec 构造函数以创建放置子图的网格的关键字的字典。

empty_sentinel对象,可选

布局中的条目,表示“留空此空间”。默认为 '.'。请注意,如果 layout 是字符串,它将通过 inspect.cleandoc 进行处理以移除前导空格,这可能会干扰使用空格作为空标记。

**fig_kw

所有额外的关键字参数都传递给 figure 调用。

返回:
figFigure

新图形

dict[label, Axes]

一个将标签映射到 Axes 对象的字典。坐标轴的顺序是按照它们在整个布局中的位置,从左到右,从上到下排列。