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