mpl_gui.subplot_mosaic#

mpl_gui.subplot_mosaic(layout, *, subplot_kw=None, gridspec_kw=None, empty_sentinel='.', **fig_kw)[源]#

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

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

注意

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

参数:
layout由列表组成的列表,其中包含 {可哈希或嵌套} 对象,或字符串

一个可视化布局,说明您希望 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 对象的字典。坐标轴的顺序是按其在总布局中的位置从左到右、从上到下排列的。