matplotlib.layout_engine
#
の要素をレイアウトするクラスFigure
。
Figure には、defined here (またはレイアウトなしlayout_engine
の場合は None)のサブクラスを保持するプロパティがあり
ます。描画時
に が呼び出されます。その目的は、通常、フィギュア上の軸を再配置して、満足のいくレイアウトを作成することです。これはコールバックのようなものですが、印刷時には最終的な描画のためにレイアウト エンジンを無効にします。Figure の作成中にレイアウト エンジンを知ることは、特にカラーバーを処理するために役立ちます。LayoutEngine
figure.get_layout_engine().execute()
draw
Matplotlib には、2 つのレイアウト エンジンTightLayoutEngine
と
ConstrainedLayoutEngine
. サード パーティは、 をサブクラス化することにより、独自のレイアウト エンジンを作成できます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 を使用してカラーバーを作成する場合はブール値を返します。
- 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 つあります。engine.colorbar_gridspec
Figure.colorbar
するかどうかを示しますgridspec メソッドを使用する軸 ( を参照
colorbar.make_axes_gridspec
) または使用しない軸 ( を参照colorbar.make_axes
)。
engine.adjust_compatible
Figure.subplots_adjust
なるのをやめるレイアウト エンジンと互換性がない場合に実行します。
カスタムを実装するには
LayoutEngine
:オーバーライド
_adjust_compatible
して_colorbar_gridspec
self._params
LayoutEngine.set
を更新するオーバーライドLayoutEngine.execute
実装でオーバーライド
- プロパティ 調整_互換性#
レイアウト エンジンが と互換性がある場合はブール値を返します
subplots_adjust
。
- プロパティ colorbar_gridspec #
レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。
- クラス matplotlib.layout_engine. PlaceHolderLayoutEngine ( adjust_compatible , colorbar_gridspec , ** kwargs ) [source] #
このレイアウト エンジンは、図のレイアウトをまったく調整しません。
これの目的は
LayoutEngine
、ユーザーがレイアウト エンジンを削除するときにプレース ホルダーとして機能し、互換性のLayoutEngine
ないものを後で設定できないようにすることです。- パラメータ:
- Adjust_compatible, colorbar_gridspec bool
PlaceHolderLayoutEngine が、置き換えるレイアウト エンジンの動作をミラーリングできるようにします。
- プロパティ 調整_互換性#
レイアウト エンジンが と互換性がある場合はブール値を返します
subplots_adjust
。
- プロパティ colorbar_gridspec #
レイアウト エンジンが gridspec を使用してカラーバーを作成する場合はブール値を返します。
- クラス 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 を使用してカラーバーを作成する場合はブール値を返します。