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 ) [source] #

Créez un axe d'encart avec une largeur et une hauteur données.

Les deux tailles utilisées peuvent être spécifiées en pouces ou en pourcentage. Par exemple,:

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

crée des axes incrustés dans le coin inférieur gauche de parent_axes qui s'étend sur plus de 30 % en hauteur et 40 % en largeur de parent_axes . Étant donné que l'utilisation de inset_axespeut devenir légèrement délicate en cas de dépassement de ces cas standard, il est recommandé de lire les exemples .

Paramètres :

parent_axesmatplotlib.axes.Axes

Axes pour placer les axes encastrés.

largeur, hauteur float ou str

Taille des axes d'encart à créer. Si un float est fourni, il s'agit de la taille en pouces, par exemple width=1.3 . Si une chaîne est fournie, il s'agit de la taille en unités relatives, par exemple width='40%' . Par défaut, c'est-à-dire si ni bbox_to_anchor ni bbox_transform ne sont spécifiés, ceux-ci sont relatifs aux parent_axes. Sinon, ils doivent être compris par rapport à la boîte englobante fournie via bbox_to_anchor .

loc str, par défaut : 'en haut à droite'

Emplacement pour placer les axes d'encart. Les emplacements valides sont 'en haut à gauche', 'en haut au centre', 'en haut à droite', 'au centre à gauche', 'au centre', 'au centre à droite', 'en bas à gauche', 'en bas au centre, 'en bas à droite'. Pour la compatibilité descendante, les valeurs numériques sont également acceptées. Voir le paramètre loc de Legendpour plus de détails.

bbox_to_anchor tuple ou matplotlib.transforms.BboxBase, facultatif

Bbox à laquelle les axes d'encart seront ancrés. Si None, un tuple de (0, 0, 1, 1) est utilisé si bbox_transform est défini sur parent_axes.transAxes ou parent_axes.figure.transFigure . Sinon, parent_axes.bbox est utilisé. S'il s'agit d'un tuple, peut être soit [left, bottom, width, height], soit [left, bottom]. Si la largeur et/ou la hauteur des kwargs sont spécifiées en unités relatives, le 2-uplet [gauche, bas] ne peut pas être utilisé. Notez que, à moins que bbox_transform ne soit défini, les unités de la boîte englobante sont interprétées dans la coordonnée du pixel. Lorsque vous utilisez bbox_to_anchor avec tuple, il est presque toujours logique de spécifier également un bbox_transform. Cela peut souvent être la transformation des axes parent_axes.transAxes .

bbox_transform matplotlib.transforms.Transform, facultatif

Transformation pour la bbox qui contient les axes incrustés. Si Aucun, a transforms.IdentityTransformest utilisé. La valeur de bbox_to_anchor (ou la valeur de retour de sa méthode get_points) est transformée par bbox_transform puis interprétée comme des points dans la coordonnée de pixel (qui dépend de dpi). Vous pouvez fournir bbox_to_anchor dans certaines coordonnées normalisées et donner une transformation appropriée (par exemple, parent_axes.transAxes ).

type axes_class matplotlib.axes.Axes, par défaut :HostAxes

Le type des axes d'encart nouvellement créés.

dict axes_kwargs , facultatif

Arguments de mot-clé à transmettre au constructeur des axes d'encart. Les arguments valides incluent :

Propriété	La description
`adjustable`	{'box', 'datalim'}
`agg_filter`	une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
`alpha`	scalaire ou Aucun
`anchor`	(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bourdonner
`aspect`	{'auto', 'égal'} ou flottant
`autoscale_on`	bourdonner
`autoscalex_on`	inconnue
`autoscaley_on`	inconnue
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool ou 'ligne'
`box_aspect`	flottant ou Aucun
`clip_box`	`Bbox`
`clip_on`	bourdonner
`clip_path`	Patch ou (chemin, transformation) ou aucun
`facecolor`ou FC	Couleur
`figure`	`Figure`
`frame_on`	bourdonner
`gid`	chaîne
`in_layout`	bourdonner
`label`	objet
`mouseover`	bourdonner
`navigate`	bourdonner
`navigate_mode`	inconnue
`path_effects`	`AbstractPathEffect`
`picker`	Aucun ou bool ou flottant ou appelable
`position`	[gauche, bas, largeur, hauteur] ou`Bbox`
`prop_cycle`	inconnue
`rasterization_zorder`	flottant ou Aucun
`rasterized`	bourdonner
`sketch_params`	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
`snap`	booléen ou Aucun
`title`	chaîne
`transform`	`Transform`
`url`	chaîne
`visible`	bourdonner
`xbound`	inconnue
`xlabel`	chaîne
`xlim`	(en bas : flottant, en haut : flottant)
`xmargin`	flottant supérieur à -0,5
`xscale`	inconnue
`xticklabels`	inconnue
`xticks`	inconnue
`ybound`	inconnue
`ylabel`	chaîne
`ylim`	(en bas : flottant, en haut : flottant)
`ymargin`	flottant supérieur à -0,5
`yscale`	inconnue
`yticklabels`	inconnue
`yticks`	inconnue
`zorder`	flotteur

borderpad flottant, par défaut : 0,5

Rembourrage entre les axes d'encart et le bbox_to_anchor. Les unités sont les axes de la taille de police, c'est-à-dire que pour une taille de police par défaut de 10 points borderpad = 0,5 équivaut à un remplissage de 5 points.

Retours :

encart_axes axes_class: Objet d'axes d'encart créé.

Remarques

La signification de bbox_to_anchor et bbox_to_transform est interprétée différemment de celle de legend. La valeur de bbox_to_anchor (ou la valeur de retour de sa méthode get_points ; la valeur par défaut est parent_axes.bbox ) est transformée par bbox_transform (la valeur par défaut est Identity transform) puis interprétée comme des points dans la coordonnée de pixel (qui dépend du dpi).

Ainsi, les trois appels suivants sont identiques et crée un encart axes par rapport au 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)

Exemples utilisant `mpl_toolkits.axes_grid1.inset_locator.inset_axes`#

Ajout d'une barre de couleurs aux axes d'encart

Contrôle de la position et de la taille des barres de couleur avec les axes d'encart

Démonstration du localisateur d'encart

mpl_toolkits.axes_grid1.inset_locator.inset_axes #

Exemples utilisant mpl_toolkits.axes_grid1.inset_locator.inset_axes#

Exemples utilisant `mpl_toolkits.axes_grid1.inset_locator.inset_axes`#