mpl_gui.subplot_mosaic#

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

基于 ASCII 艺术或嵌套列表构建 Axes 的布局。

这是一个辅助函数，用于以可视方式构建复杂的 GridSpec 布局。

注意

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

参数:
layoutlist of list of {可哈希或嵌套} or str

您希望以字符串形式标记的 Axes 的视觉布局。例如

x = [['A panel', 'A panel', 'edge'],
     ['C panel', '.',       'edge']]

生成 4 个轴

  • 一个“A panel”，它高 1 行，跨越前两列

  • “edge”，它高 2 行，位于右边缘

  • 一个“C panel”，它在左下方宽 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 对象的字典。轴的顺序是它们在总布局中位置的从左到右和从上到下。