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 呼叫。

傳回:
figFigure

新的圖表

dict[標籤,軸]

將標籤對應至軸物件的字典。軸的順序是它們在整體佈局中的位置從左到右和從上到下。