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
调用。
- 返回:
- fig
Figure
新的图表
- dict[label, Axes]
一个字典,将标签映射到 Axes 对象。轴的顺序是它们在总布局中的位置的从左到右和从上到下。
- fig