mpl_toolkits.axes_grid1.inset_locator.inset_axes

mpl_toolkits.axes_grid1.inset_locator.inset_axes(parent_axes, width, height, loc='upper right', bbox_to_anchor=None, bbox_transform=None, axes_class=None, axes_kwargs=None, borderpad=0.5)

Erstellt eine eingeschachtelte Achse mit einer gegebenen Breite und Höhe.

Beide verwendeten Größen können entweder in Zoll oder als Prozentsatz angegeben werden. Zum Beispiel,

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

erstellt eine eingeschachtelte Achse in der unteren linken Ecke von parent_axes, die 30% der Höhe und 40% der Breite von parent_axes einnimmt. Da die Verwendung von inset_axes bei Überschreitung solcher Standardfälle etwas knifflig sein kann, wird empfohlen, die Beispiele zu lesen.

Parameter:

parent_axesmatplotlib.axes.Axes

Achsen, auf denen die eingeschachtelte Achse platziert werden soll.

width, heightfloat oder str

Größe der zu erstellenden eingeschachtelten Achse. Wenn ein Float angegeben wird, ist dies die Größe in Zoll, z. B. width=1.3. Wenn ein String angegeben wird, ist dies die Größe in relativen Einheiten, z. B. width='40%'. Standardmäßig, d. h. wenn weder bbox_to_anchor noch bbox_transform angegeben sind, sind diese relativ zu parent_axes. Andernfalls werden sie relativ zum durch bbox_to_anchor bereitgestellten Bounding-Box verstanden.

locstr, Standard: 'upper right'

Position, an der die eingeschachtelte Achse platziert werden soll. Gültige Positionen sind 'upper left', 'upper center', 'upper right', 'center left', 'center', 'center right', 'lower left', 'lower center', 'lower right'. Aus Gründen der Abwärtskompatibilität werden auch numerische Werte akzeptiert. Einzelheiten finden Sie im Parameter loc von Legend.

bbox_to_anchortuple oder BboxBase, optional

Bbox, an der die eingeschachtelte Achse verankert wird. Wenn None, wird ein Tupel von (0, 0, 1, 1) verwendet, wenn bbox_transform auf parent_axes.transAxes oder parent_axes.figure.transFigure gesetzt ist. Andernfalls wird parent_axes.bbox verwendet. Wenn ein Tupel angegeben wird, kann es entweder [left, bottom, width, height] oder [left, bottom] sein. Wenn die Keyword-Argumente width und/oder height in relativen Einheiten angegeben sind, kann das 2-Tupel [left, bottom] nicht verwendet werden. Beachten Sie, dass die Einheiten der Bounding-Box Pixelkoordinaten entsprechen, es sei denn, bbox_transform ist gesetzt. Bei Verwendung von bbox_to_anchor mit einem Tupel ist es fast immer sinnvoll, auch eine bbox_transform anzugeben. Dies ist oft die Achsentransformation parent_axes.transAxes.

bbox_transformTransform, optional

Transformation für die Bbox, die die eingeschachtelte Achse enthält. Wenn None, wird eine transforms.IdentityTransform verwendet. Der Wert von bbox_to_anchor (oder der Rückgabewert seiner get_points-Methode) wird von bbox_transform transformiert und dann als Punkte in der Pixelkoordinate interpretiert (was dpi-abhängig ist). Sie können bbox_to_anchor in einer normalisierten Koordinate angeben und eine geeignete Transformation (z. B. parent_axes.transAxes) bereitstellen.

axes_classAxes Typ, Standard: HostAxes

Der Typ der neu erstellten eingeschachtelten Achse.

axes_kwargsdict, optional

Schlüsselwortargumente, die an den Konstruktor der eingeschachtelten Achse übergeben werden. Gültige Argumente sind

Eigenschaft	Beschreibung
adjustable	{'box', 'datalim'}
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder None
anchor	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} oder float
autoscale_on	bool
autoscalex_on	unknown
autoscaley_on	unknown
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool oder 'line'
box_aspect	float oder None
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
facecolor oder fc	color
figure	Figure oder SubFigure
forward_navigation_events	bool oder "auto"
frame_on	bool
gid	str
in_layout	bool
label	object
mouseover	bool
navigate	bool
navigate_mode	unknown
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
position	[left, bottom, width, height] oder Bbox
prop_cycle	Cycler
rasterization_zorder	float oder None
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
subplotspec	unknown
title	str
transform	Transform
url	str
visible	bool
xbound	(lower: float, upper: float)
xlabel	str
xlim	(left: float, right: float)
xmargin	float größer als -0.5
xscale	unknown
xticklabels	unknown
xticks	unknown
ybound	(lower: float, upper: float)
ylabel	str
ylim	(bottom: float, top: float)
ymargin	float größer als -0.5
yscale	unknown
yticklabels	unknown
yticks	unknown
zorder	float

borderpadfloat, default: 0.5

Abstand zwischen der eingeschachtelten Achse und der bbox_to_anchor. Die Einheiten sind Achsen-Schriftgröße, d. h. bei einer Standard-Schriftgröße von 10 Punkten entspricht borderpad = 0.5 einem Abstand von 5 Punkten.

Gibt zurück:

inset_axesaxes_class

Erzeugtes Objekt der eingeschachtelten Achse.

Anmerkungen

Die Bedeutung von bbox_to_anchor und bbox_to_transform wird anders interpretiert als die von Legend. Der Wert von bbox_to_anchor (oder der Rückgabewert seiner get_points-Methode; Standard ist parent_axes.bbox) wird durch die bbox_transform (Standard ist Identity-Transformation) transformiert und dann als Punkte in der Pixelkoordinate interpretiert (was dpi-abhängig ist).

Daher sind die folgenden drei Aufrufe identisch und erstellen eine eingeschachtelte Achse in Bezug auf die 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)

Beispiele mit mpl_toolkits.axes_grid1.inset_locator.inset_axes

Position und Größe einer Farbleiste mit Inset Axes steuern

Position und Größe einer Farbleiste mit Inset Axes steuern

Inset Locator Demo

Inset Locator Demo