mpl_toolkits.axes_grid1.inset_locator.inset_axes

mpl_toolkits.axes_grid1.inset_locator. inset_axes ( parent_axes、幅、高さ、 loc = ' 右上'、 bbox_to_anchor =なし、 bbox_transform =なし、 axes_class =なし、 axes_kwargs =なし、 borderpad = 0.5 )

指定された幅と高さで挿入軸を作成します。

使用される両方のサイズは、インチまたはパーセンテージで指定できます。例えば、：

inset_axes(parent_axes, width='40%', height='30%', loc='lower left')

parent_axesの高さ 30% と幅 40% を超える、 parent_axesの左下隅に挿入軸を作成します。このような標準的なケースを超えると、 の使用がinset_axes少し難しくなる場合があるため、例を参照することをお勧めします。

パラメータ:

親軸matplotlib.axes.Axes

挿入軸を配置する軸。

幅、高さfloat または str

作成する挿入軸のサイズ。float が指定されている場合、これはwidth=1.3などのインチ単位のサイズです。文字列が指定されている場合、これはwidth='40%'などの相対単位のサイズです。デフォルトでは、つまり、bbox_to_anchorもbbox_transformも指定されていない場合、これらはparent_axes に対して相対的です。それ以外の場合は、 bbox_to_anchorを介して提供される境界ボックスに対して相対的に理解されます。

loc str、デフォルト: '右上'

挿入軸を配置する場所。有効な位置は、「左上」、「中央上部」、「右上」、「左中央」、「中央」、「右中央」、「左下」、「中央下」、「右下」です。下位互換性のために、数値も受け入れられます。詳細については、パラメータlocを参照Legendしてください。

bbox_to_anchorタプル またはmatplotlib.transforms.BboxBase、オプション

挿入軸が固定される Bbox。None の場合、 bbox_transformがparent_axes.transAxesまたはparent_axes.figure.transFigureに設定されている場合、(0, 0, 1, 1) のタプルが使用されます。それ以外の場合は、parent_axes.bboxが使用されます。タプルの場合、[左、下、幅、高さ] または [左、下] のいずれかになります。kwargs の幅や高さが相対単位で指定されている場合、2 タプル [left, bottom] は使用できません。bbox_transformが設定されていない限り、境界ボックスの単位はピクセル座標で解釈されることに注意してください。タプルでbbox_to_anchorを使用する場合 、ほとんどの場合、bbox_transformも指定するのが理にかなっています. これは多くの場合、軸変換の parent_axes.transAxesである可能性があります。

bbox_transform matplotlib.transforms.Transform、オプション

挿入軸を含む bbox の変換。None の場合、atransforms.IdentityTransformが使用されます。bbox_to_anchorの値(またはその get_points メソッドの戻り値) は、bbox_transformによって変換され、ピクセル座標 (dpi に依存) のポイントとして解釈されます。正規化された座標でbbox_to_anchorを提供し、適切な変換を行うことができます (たとえば、parent_axes.transAxes )。

axes_classmatplotlib.axes.Axesタイプ、デフォルト:HostAxes

新しく作成された挿入軸のタイプ。

axis_kwargs dict、オプション

挿入軸のコンストラクターに渡すキーワード引数。有効な引数は次のとおりです。

財産	説明
adjustable	{'ボックス', 'データリム'}
agg_filter	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
alpha	スカラーまたはなし
anchor	(float, float) または {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	ブール
aspect	{'auto', 'equal'} または float
autoscale_on	ブール
autoscalex_on	わからない
autoscaley_on	わからない
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	ブールまたは「行」
box_aspect	float または None
clip_box	Bbox
clip_on	ブール
clip_path	パッチまたは (パス、変換) またはなし
facecolorまたはfc	色
figure	Figure
frame_on	ブール
gid	力
in_layout	ブール
label	物体
mouseover	ブール
navigate	ブール
navigate_mode	わからない
path_effects	AbstractPathEffect
picker	None または bool または float または callable
position	[左、下、幅、高さ] またはBbox
prop_cycle	わからない
rasterization_zorder	float または None
rasterized	ブール
sketch_params	(位取り: float、長さ: float、乱数: float)
snap	ブールまたはなし
title	力
transform	Transform
url	力
visible	ブール
xbound	わからない
xlabel	力
xlim	（下：浮き、上：浮き）
xmargin	-0.5 より大きい float
xscale	わからない
xticklabels	わからない
xticks	わからない
ybound	わからない
ylabel	力
ylim	（下：浮き、上：浮き）
ymargin	-0.5 より大きい float
yscale	わからない
yticklabels	わからない
yticks	わからない
zorder	浮く

ボーダーパッドフロート、デフォルト: 0.5

挿入軸と bbox_to_anchor の間のパディング。単位は軸のフォント サイズです。つまり、デフォルトのフォント サイズが 10 ポイントの場合、 borderpad = 0.5は 5 ポイントのパディングに相当します。

戻り値:

inset_axes軸のクラス

挿入軸オブジェクトが作成されました。

ノート

bbox_to_anchorとbbox_to_transformの意味は、凡例の意味とは異なって解釈されます。bbox_to_anchor の値 (またはその get_points メソッドの戻り値。デフォルトは parent_axes.bbox ) は、bbox_transform (デフォルトは恒等変換) によって変換され、ピクセル座標 (dpi に依存) のポイントとして解釈されます。

したがって、次の 3 つの呼び出しは同一であり、 parent_axesに関する挿入軸を作成します。

axins = inset_axes(parent_axes, "30%", "40%")
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=parent_axes.bbox)
axins = inset_axes(parent_axes, "30%", "40%",
                   bbox_to_anchor=(0, 0, 1, 1),
                   bbox_transform=parent_axes.transAxes)

を使用した例mpl_toolkits.axes_grid1.inset_locator.inset_axes

挿入軸へのカラーバーの追加

挿入軸へのカラーバーの追加

Inset Axes を使用したカラーバーの位置とサイズの制御

Inset Axes を使用したカラーバーの位置とサイズの制御

インセット ロケータのデモ

インセット ロケータのデモ