mpl_gui.subplot_mosaic

mpl_gui.subplot_mosaic(layout, *, subplot_kw=None, gridspec_kw=None, empty_sentinel='.', **fig_kw)

基於 ASCII art 或巢狀列表建立 Axes 的佈局。

這是一個輔助函數，用於以視覺方式建立複雜的 GridSpec 佈局。

注意

此 API 為暫時性，未來可能會根據早期使用者回饋進行修訂。

參數:

layoutlist of list of {hashable or nested} 或 str

您希望以字串標示的 Axes 排列方式的可視化佈局。例如：

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

產生 4 個 axes

• 一個高度為 1 行並跨越前兩列的「A 面板」

• 一個高度為 2 行且位於右邊緣的「edge」

• 一個位於左下角、寬度為 1 列、高度為 1 列的「C 面板」

• 一個位於底部中央、寬度為 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 物件的字典。軸的順序是它們在總佈局中的位置從左到右、從上到下。