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