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 行,跨越前两列

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

  • “C 面板”,位于左下方,宽度为 1 行和 1 列

  • 一个空白区域,位于底部中心,宽度为 1 行和 1 列

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

如果输入是 str,则其形式必须为

'''
AAE
C.E
'''

其中每个字符是一列,每行是一行。这仅允许单字符 Axes 标签,并且不允许嵌套,但是非常简洁。

subplot_kwdict, 可选

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

gridspec_kwdict, 可选

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

empty_sentinelobject, 可选

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

**fig_kw

所有其他关键字参数都传递给 figure 调用。

返回:
figFigure

新的图表

dict[label, Axes]

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