mpl_gui.FigureRegistry.subplot_mosaic#
- FigureRegistry.subplot_mosaic(*, subplot_kw=None, gridspec_kw=None, empty_sentinel='.', **fig_kw)#
基於 ASCII 藝術或巢狀列表建立軸的佈局。
這是一個輔助函式,用於以視覺方式建立複雜的
GridSpec
佈局。注意
此 API 為臨時性質,未來可能會根據早期使用者回饋進行修改。
- 參數:
- layoutlist of list of {可雜湊或巢狀} 或 str
您希望軸如何排列的視覺佈局,標記為字串。例如
x = [['A panel', 'A panel', 'edge'], ['C panel', '.', 'edge']]
產生 4 個軸
「A 面板」,高度為 1 列,跨越前兩欄
「邊緣」,高度為 2 列,位於右邊緣
「C 面板」,位於左下角,寬度為 1 列和 1 欄
底部中心有一個寬度為 1 列和 1 欄的空白空間
佈局中的任何條目都可以是相同形式的列表列表,以建立巢狀佈局。
如果輸入為 str,則它必須具有以下形式
''' AAE C.E '''
其中每個字元都是一欄,每一行都是一列。這只允許單個字元的軸標籤,並且不允許巢狀結構,但非常簡潔。
- subplot_kwdict,選用
帶有關鍵字的字典,傳遞至用於建立每個子圖的
add_subplot
呼叫。- gridspec_kwdict,選用
帶有關鍵字的字典,傳遞至用於建立子圖所在網格的
GridSpec
建構函式。- empty_sentinel物件,選用
佈局中表示「將此空間留空」的條目。預設為
'.'
。請注意,如果 layout 是字串,則會透過inspect.cleandoc
處理,以刪除開頭的空白,這可能會干擾使用空白作為空白符號。- **fig_kw
所有其他關鍵字引數都會傳遞至
figure
呼叫。
- 傳回:
- fig
Figure
新的圖表
- dict[標籤,軸]
將標籤對應至軸物件的字典。軸的順序是它們在整體佈局中的位置從左到右和從上到下。
- fig