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 )

Crea un asse interno con una data larghezza e altezza.

Entrambe le dimensioni utilizzate possono essere specificate in pollici o in percentuale. Per esempio,:

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

crea assi interni nell'angolo in basso a sinistra di parent_axes che si estende per oltre il 30% in altezza e il 40% in larghezza di parent_axes . Dal momento che l'uso di inset_axespuò diventare leggermente complicato quando si superano tali casi standard, si consiglia di leggere gli esempi .

Parametri :

parent_axesmatplotlib.axes.Axes

Assi per posizionare gli assi interni.

larghezza, altezza float o str

Dimensione degli assi interni da creare. Se viene fornito un float, è la dimensione in pollici, ad esempio width=1.3 . Se viene fornita una stringa, è la dimensione in unità relative, ad esempio width='40%' . Di default, cioè se non sono specificati né bbox_to_anchor né bbox_transform , questi sono relativi a parent_axes. Altrimenti sono da intendersi relativamente al bounding box fornito tramite bbox_to_anchor .

loc str, predefinito: 'in alto a destra'

Posizione in cui posizionare gli assi interni. Le posizioni valide sono 'in alto a sinistra', 'in alto al centro', 'in alto a destra', 'al centro a sinistra', 'al centro', 'al centro a destra', 'in basso a sinistra', 'in basso al centro, 'in basso a destra'. Per compatibilità con le versioni precedenti, sono accettati anche valori numerici. Vedere il parametro loc di Legendper i dettagli.

bbox_to_anchor tupla o matplotlib.transforms.BboxBase, facoltativo

Bbox a cui saranno ancorati gli assi interni. Se None, viene utilizzata una tupla di (0, 0, 1, 1) se bbox_transform è impostato su parent_axes.transAxes o parent_axes.figure.transFigure . In caso contrario, viene utilizzato parent_axes.bbox . Se è una tupla, può essere [left, bottom, width, height] o [left, bottom]. Se la larghezza e/o l' altezza dei kwargs sono specificate in unità relative, non è possibile utilizzare la tupla a 2 elementi [sinistra, in basso]. Si noti che, a meno che non sia impostato bbox_transform , le unità del riquadro di delimitazione vengono interpretate nella coordinata dei pixel. Quando si utilizza bbox_to_anchor con tuple, ha quasi sempre senso specificare anche un bbox_transform. Questo potrebbe spesso essere la trasformazione degli assi parent_axes.transAxes .

bbox_transform matplotlib.transforms.Transform, facoltativo

Trasformazione per la bbox che contiene gli assi interni. Se None, transforms.IdentityTransformviene utilizzato a. Il valore di bbox_to_anchor (o il valore di ritorno del suo metodo get_points) viene trasformato da bbox_transform e quindi interpretato come punti nella coordinata pixel (che dipende da dpi). Puoi fornire bbox_to_anchor in qualche coordinata normalizzata e fornire una trasformazione appropriata (ad esempio, parent_axes.transAxes ).

tipo axis_class matplotlib.axes.Axes, predefinito:HostAxes

Il tipo degli assi interni appena creati.

axis_kwargs dict, facoltativo

Argomenti della parola chiave da passare al costruttore degli assi interni. Gli argomenti validi includono:

Proprietà	Descrizione
adjustable	{'box', 'datalim'}
agg_filter	una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
alpha	scalare o Nessuno
anchor	(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal'} o float
autoscale_on	bool
autoscalex_on	sconosciuto
autoscaley_on	sconosciuto
axes_locator	Callable[[Assi, Renderer], Bbox]
axisbelow	bool o 'linea'
box_aspect	float o Nessuno
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
facecoloro fc	colore
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	oggetto
mouseover	bool
navigate	bool
navigate_mode	sconosciuto
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	[sinistra, fondo, larghezza, altezza] oBbox
prop_cycle	sconosciuto
rasterization_zorder	float o Nessuno
rasterized	bool
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
title	str
transform	Transform
url	str
visible	bool
xbound	sconosciuto
xlabel	str
xlim	(in basso: galleggiante, in alto: galleggiante)
xmargin	float maggiore di -0,5
xscale	sconosciuto
xticklabels	sconosciuto
xticks	sconosciuto
ybound	sconosciuto
ylabel	str
ylim	(in basso: galleggiante, in alto: galleggiante)
ymargin	float maggiore di -0,5
yscale	sconosciuto
yticklabels	sconosciuto
yticks	sconosciuto
zorder	galleggiante

borderpad float, predefinito: 0.5

Imbottitura tra gli assi interni e bbox_to_anchor. Le unità sono gli assi dimensione del carattere, cioè per una dimensione del carattere predefinita di 10 punti borderpad = 0.5 equivale a un riempimento di 5 punti.

Resi :

inset_axes axis_class

Oggetto degli assi interni creato.

Appunti

Il significato di bbox_to_anchor e bbox_to_transform è interpretato diversamente da quello di legend. Il valore di bbox_to_anchor (o il valore restituito del suo metodo get_points; il valore predefinito è parent_axes.bbox ) viene trasformato da bbox_transform (il valore predefinito è Identity transform) e quindi interpretato come punti nella coordinata pixel (che dipende da dpi).

Pertanto, le seguenti tre chiamate sono identiche e creano assi inset rispetto a 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)

Esempi che utilizzano mpl_toolkits.axes_grid1.inset_locator.inset_axes

Aggiunta di una barra dei colori agli assi interni

Aggiunta di una barra dei colori agli assi interni

Controllo della posizione e delle dimensioni delle barre dei colori con Inset Axes

Controllo della posizione e delle dimensioni delle barre dei colori con Inset Axes

Demo del localizzatore interno

Demo del localizzatore interno