matplotlib.layout_engine#

の要素をレイアウトするクラスFigure

Figure には、defined here (またはレイアウトなしlayout_engineの場合は None)のサブクラスを保持するプロパティがあり ます。描画時 に が呼び出されます。その目的は、通常、フィギュア上の軸を再配置して、満足のいくレイアウトを作成することです。これはコールバックのようなものですが、印刷時には最終的な描画のためにレイアウト エンジンを無効にします。Figure の作成中にレイアウト エンジンを知ることは、特にカラーバーを処理するために役立ちます。LayoutEnginefigure.get_layout_engine().execute()draw

Matplotlib には、2 つのレイアウト エンジンTightLayoutEngineConstrainedLayoutEngine. サード パーティは、 をサブクラス化することにより、独自のレイアウト エンジンを作成できますLayoutEngine

クラス matplotlib.layout_engine. ConstrainedLayoutEngine ( * , h_pad =なし, w_pad =なし, hspace =なし, wspace =なし, rect = (0, 0, 1, 1) , compress = False , ** kwargs ) [source] #

constrained_layoutジオメトリ管理を実装します。詳細については 、制約付きレイアウト ガイドを参照してください。

設定を初期化constrained_layoutします。

パラメータ:
h_pad, w_pad float

数値正規化単位での軸要素の周囲のパディング。デフォルトはrcParams["figure.constrained_layout.h_pad"](デフォルト: 0.04167) および rcParams["figure.constrained_layout.w_pad"](デフォルト: 0.04167) です。

hspace、wspace float

軸間のスペースに割り当てる Figure の割合。これらは、軸間のギャップ間で均等に分散されます。3 列のレイアウトで値 0.2 を指定すると、各列の間に図の幅の 0.1 のスペースができます。h/wspace < h/w_pad の場合、代わりにパッドが使用されます。デフォルトはrcParams["figure.constrained_layout.hspace"](デフォルト: 0.02) および rcParams["figure.constrained_layout.wspace"](デフォルト: 0.02) です。

4 float のrectタプル

(左、下、幅、高さ) でそれぞれ 0 ~ 1 の制約付きレイアウトを実行するための Figure 座標の四角形。

圧縮ブール

Axes 間の空白が削除されるように Axes をシフトするかどうか。これは、固定アスペクト軸の単純なグリッド (画像のグリッドなど) に役立ちます。固定縦横比軸のグリッド: 「圧縮」レイアウトを参照してください。

プロパティ 調整_互換性#

レイアウト エンジンが と互換性がある場合はブール値を返します subplots_adjust

プロパティ colorbar_gridspec #

レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。

実行() [ソース] #

Constrained_layout を実行し、それに応じて軸を移動およびサイズ変更します。

パラメータ:
レイアウトを実行するfig 。Figure
get ( ) [ソース] #

レイアウト エンジンのパラメーターのコピーを返します。

set ( * , h_pad =なし, w_pad =なし, hspace =なし, wspace =なし, rect =なし) [source] #

Constrained_layout のパッドを設定します。

パラメータ:
h_pad, w_pad float

数値正規化単位での軸要素の周囲のパディング。デフォルトはrcParams["figure.constrained_layout.h_pad"](デフォルト: 0.04167) および rcParams["figure.constrained_layout.w_pad"](デフォルト: 0.04167) です。

hspace、wspace float

軸間のスペースに割り当てる Figure の割合。これらは、軸間のギャップ間で均等に分散されます。3 列のレイアウトで値 0.2 を指定すると、各列の間に図の幅の 0.1 のスペースができます。h/wspace < h/w_pad の場合、代わりにパッドが使用されます。デフォルトはrcParams["figure.constrained_layout.hspace"](デフォルト: 0.02) および rcParams["figure.constrained_layout.wspace"](デフォルト: 0.02) です。

4 float のrectタプル

(左、下、幅、高さ) でそれぞれ 0 ~ 1 の制約付きレイアウトを実行するための Figure 座標の四角形。

クラス matplotlib.layout_engine. LayoutEngine ( ** kwargs ) [ソース] #

Matplotlib レイアウト エンジンの基本クラス。

レイアウト エンジンは、インスタンス化時またはいつでも Figure に渡すことができますset_layout_engine。Figure にアタッチされると、レイアウト エンジンexecute関数が によって描画時に呼び出され draw、特別な描画時のフックが提供されます。

ノート

ただし、レイアウト エンジンはカラーバーの作成に影響するため、 set_layout_engineカラーバーを作成する前に呼び出す必要があることに注意してください。

LayoutEngine現在、 Figure の操作中に参照されるクラスのプロパティが 2 つあります。

カスタムを実装するにはLayoutEngine:

  1. オーバーライド_adjust_compatibleして_colorbar_gridspec

  2. self._paramsLayoutEngine.setを更新するオーバーライド

  3. LayoutEngine.execute実装でオーバーライド

プロパティ 調整_互換性#

レイアウト エンジンが と互換性がある場合はブール値を返します subplots_adjust

プロパティ colorbar_gridspec #

レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。

実行() [ソース] #

figで指定された図のレイアウトを実行します。

get ( ) [ソース] #

レイアウト エンジンのパラメーターのコピーを返します。

set ( ** kwargs ) [ソース] #
クラス matplotlib.layout_engine. PlaceHolderLayoutEngine ( adjust_compatible , colorbar_gridspec , ** kwargs ) [source] #

このレイアウト エンジンは、図のレイアウトをまったく調整しません。

これの目的はLayoutEngine、ユーザーがレイアウト エンジンを削除するときにプレース ホルダーとして機能し、互換性のLayoutEngineないものを後で設定できないようにすることです。

パラメータ:
Adjust_compatible, colorbar_gridspec bool

PlaceHolderLayoutEngine が、置き換えるレイアウト エンジンの動作をミラーリングできるようにします。

プロパティ 調整_互換性#

レイアウト エンジンが と互換性がある場合はブール値を返します subplots_adjust

プロパティ colorbar_gridspec #

レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。

実行() [ソース] #

figで指定された図のレイアウトを実行します。

get ( ) [ソース] #

レイアウト エンジンのパラメーターのコピーを返します。

set ( ** kwargs ) [ソース] #
クラス matplotlib.layout_engine. TightLayoutEngine ( * , pad = 1.08 , h_pad =なし, w_pad =なし, rect = (0, 0, 1, 1) , ** kwargs ) [source] #

tight_layoutジオメトリ管理を実装します。詳細については 、タイト レイアウト ガイドを参照してください。

tight_layout エンジンを初期化します。

パラメータ:
パッドフロート、1.08

Figure の端とサブプロットの端の間のパディング (フォント サイズの割合)。

h_pad, w_pad float

隣接するサブプロットのエッジ間のパディング (高さ/幅)。デフォルトはpadです。

rectタプル (左、下、右、上)、デフォルト: (0, 0, 1, 1)。

サブプロット (ラベルを含む) が収まる正規化された Figure 座標の四角形。

プロパティ 調整_互換性#

レイアウト エンジンが と互換性がある場合はブール値を返します subplots_adjust

プロパティ colorbar_gridspec #

レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。

実行() [ソース] #

tight_layout を実行します。

これにより、軸ラベルが他のラベルや軸によって覆われないようにするパディングが与えられたサブプロット パラメーターが決定されます。

パラメータ:
レイアウトを実行するfig 。Figure
参照: `.figure.Figure.tight_layout` および `.pyplot.tight_layout`。
get ( ) [ソース] #

レイアウト エンジンのパラメーターのコピーを返します。

set ( * , pad =なし, w_pad =なし, h_pad =なし, rect =なし) [source] #