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 , axis_class = None , axis_kwargs = None , borderpad = 0.5 )

Erstellen Sie eine Einschubachse mit einer bestimmten Breite und Höhe.

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

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

erstellt Einschubachsen in der unteren linken Ecke von parent_axes , die sich über 30 % in der Höhe und 40 % in der Breite von parent_axes erstrecken . Da die Verwendung von inset_axesbei solchen Standardfällen etwas knifflig werden kann, empfiehlt es sich, die Beispiele zu lesen .

Parameter :

parent_axesmatplotlib.axes.Axes

Achsen zum Platzieren der Einsatzachsen.

Breite, Höhe float oder str

Größe der zu erstellenden Einsatzachsen. Wenn ein Float angegeben ist, ist dies die Größe in Zoll, z . B. width=1.3 . Wenn eine Zeichenfolge angegeben wird, ist dies die Größe in relativen Einheiten, z. B. width='40%' . Standardmäßig, dh wenn weder bbox_to_anchor noch bbox_transform angegeben sind, sind diese relativ zu den parent_axes. Ansonsten sind sie relativ zu der per bbox_to_anchor bereitgestellten Begrenzungsbox zu verstehen .

loc str, Standard: 'oben rechts'

Position zum Platzieren der Einschubachsen. Gültige Positionen sind „oben links“, „oben Mitte“, „oben rechts“, „Mitte links“, „Mitte“, „Mitte rechts“, „unten links“, „unten Mitte“, „unten rechts“. Aus Gründen der Abwärtskompatibilität werden auch numerische Werte akzeptiert. Einzelheiten finden Sie im Parameter loc von .Legend

bbox_to_anchor Tupel oder matplotlib.transforms.BboxBase, optional

Bbox, an der die eingefügten Achsen verankert werden. Bei 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 es sich um ein Tupel handelt, kann es entweder [links, unten, Breite, Höhe] oder [links, unten] sein. Wenn die kwargs- Breite und/oder -Höhe in relativen Einheiten angegeben sind, kann das 2-Tupel [links, unten] nicht verwendet werden. Beachten Sie, dass die Einheiten des Begrenzungsrahmens in Pixelkoordinaten interpretiert werden , es sei denn, bbox_transform ist festgelegt. Bei der Verwendung von bbox_to_anchor mit Tupel ist es fast immer sinnvoll, auch eine bbox_transform anzugeben. Dies kann oft die Achsentransformation parent_axes.transAxes sein .

bbox_transform matplotlib.transforms.Transform, optional

Transformation für die bbox, die die eingefügten Achsen enthält. Wenn keine, transforms.IdentityTransformwird a 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 (die dpi-abhängig ist) interpretiert. Sie können bbox_to_anchor in einer normalisierten Koordinate bereitstellen und eine geeignete Transformation (z . B. parent_axes.transAxes ) angeben.

Achsen_Klassentyp matplotlib.axes.Axes, Standard:HostAxes

Der Typ der neu erstellten Einsatzachsen.

axis_kwargs Diktat , optional

Schlüsselwortargumente, die an den Konstruktor der eingefügten Achsen übergeben werden. Gültige Argumente sind:

Eigentum	Beschreibung
adjustable	{'box', 'datalim'}
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
anchor	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} oder float
autoscale_on	bool
autoscalex_on	Unbekannt
autoscaley_on	Unbekannt
axes_locator	Callable[[Achsen, Renderer], Bbox]
axisbelow	bool oder 'line'
box_aspect	Float oder None
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
facecoloroder FC	Farbe
figure	Figure
frame_on	bool
gid	Str
in_layout	bool
label	Objekt
mouseover	bool
navigate	bool
navigate_mode	Unbekannt
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
position	[links, unten, Breite, Höhe] oderBbox
prop_cycle	Unbekannt
rasterization_zorder	Float oder None
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
title	Str
transform	Transform
url	Str
visible	bool
xbound	Unbekannt
xlabel	Str
xlim	(unten: Schwimmer, oben: Schwimmer)
xmargin	Schwimmer größer als -0,5
xscale	Unbekannt
xticklabels	Unbekannt
xticks	Unbekannt
ybound	Unbekannt
ylabel	Str
ylim	(unten: Schwimmer, oben: Schwimmer)
ymargin	Schwimmer größer als -0,5
yscale	Unbekannt
yticklabels	Unbekannt
yticks	Unbekannt
zorder	schweben

Borderpad- Float, Standard: 0,5

Polsterung zwischen eingefügten Achsen und bbox_to_anchor. Die Einheiten sind Achsen Schriftgröße, dh bei einer Standardschriftgröße von 10 Punkt entspricht Borderpad = 0,5 einem Padding von 5 Punkt.

Rückgaben :

Einschubachsen Achsenklasse

Eingefügtes Achsenobjekt erstellt.

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 Methode get_points; der Standardwert ist parent_axes.bbox ) wird von bbox_transform transformiert (der Standardwert ist Identity transform) und dann als Punkte in der Pixelkoordinate interpretiert (die dpi-abhängig ist).

Daher sind die folgenden drei Aufrufe identisch und erstellen eine Inset-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

Hinzufügen eines Farbbalkens zu Einschubachsen

Hinzufügen eines Farbbalkens zu Einschubachsen

Steuern der Position und Größe von Farbbalken mit Inset Axes

Steuern der Position und Größe von Farbbalken mit Inset Axes

Inset-Locator-Demo

Inset-Locator-Demo