matplotlib.pyplot.subplot_mosaic#
- matplotlib.pyplot.subplot_mosaic(mosaic, *, sharex=False, sharey=False, width_ratios=None, height_ratios=None, empty_sentinel='.', subplot_kw=None, gridspec_kw=None, per_subplot_kw=None, **fig_kw)[源代码][源代码]#
基于ASCII艺术或嵌套列表构建Axes布局。
这是一个用于直观构建复杂 GridSpec 布局的辅助函数。
有关示例和完整的API文档，请参阅 复杂且语义化的图形组合 (subplot_mosaic)。
- 参数:
- 马赛克列表的列表 {可哈希或嵌套} 或字符串
你希望的 Axes 排列方式的可视化布局，标记为字符串。例如
x = [['A panel', 'A panel', 'edge'], ['C panel', '.', 'edge']]
生成 4 个 Axes：
'一个面板' 高度为一行，并跨越前两列
'edge' 是一个高度为两行且位于右侧边缘的元素
'C 面板' 位于左下角，占据一行一列的宽度。
在底部中心有一个1行1列的空白空间
布局中的任何条目都可以是相同形式的列表的列表，以创建嵌套布局。
如果输入是字符串，那么它必须是以下形式
''' AAE C.E '''
其中每个字符是一列，每行是一行。这仅允许单字符轴标签，不允许嵌套，但非常简洁。
- sharex, shareybool, 默认值: False
如果为 True，所有子图将共享 x 轴（sharex）或 y 轴（sharey）。在这种情况下，刻度标签可见性和轴单位的行为与
subplots相同。如果为 False，每个子图的 x 轴或 y 轴将是独立的。- width_ratios : 长度为 ncols 的类数组对象, 可选长度为的类数组
定义列的相对宽度。每列的相对宽度为
width_ratios[i] / sum(width_ratios)。如果未指定，所有列将具有相同的宽度。这是gridspec_kw={'width_ratios': [...]}的便捷用法。- height_ratios : 长度为 nrows 的类数组对象, 可选长度为的类数组
定义行的相对高度。每行的高度为
height_ratios[i] / sum(height_ratios)。如果没有给出，所有行将具有相同的高度。这是gridspec_kw={'height_ratios': [...]}的便捷用法。- empty_sentinel对象，可选
布局中的条目，表示“保留此空间为空”。默认值为
'.'。注意，如果 layout 是字符串，它将通过inspect.cleandoc处理以删除前导空白，这可能会干扰使用空白作为空占位符。- subplot_kw字典, 可选
传递给
Figure.add_subplot调用的关键字字典，用于创建每个子图。这些值可能会被 per_subplot_kw 中的值覆盖。- per_subplot_kw字典, 可选
一个字典，将 Axes 标识符或标识符元组映射到一个关键字参数字典，这些参数将被传递给用于创建每个子图的
Figure.add_subplot调用。这些字典中的值优先于 subplot_kw 中的值。如果 mosaic 是一个字符串，因此所有键都是单个字符，则可以使用单个字符串而不是元组作为键；即
"AB"等同于("A", "B")。Added in version 3.7.
- gridspec_kw字典, 可选
传递给
GridSpec构造函数的带有关键字的字典，用于创建子图放置的网格。- **fig_kw
所有额外的关键字参数都会传递给
pyplot.figure调用。
- 返回:
- fig图
新的图形
- dict[标签, 轴]
一个将标签映射到 Axes 对象的字典。Axes 的顺序是根据它们在整个布局中的位置从左到右、从上到下排列的。
