mpl_toolkits.axes_grid1.inset_locator.inset_axes #
- mpl_toolkits.axes_grid1.inset_locator. inset_axes ( parent_axes , ancho , alto , loc = 'superior derecha' , bbox_to_anchor = Ninguno , bbox_transform = Ninguno , axes_class = Ninguno , axes_kwargs = Ninguno , borderpad = 0.5 ) [fuente] #
Cree un eje insertado con un ancho y una altura determinados.
Ambos tamaños utilizados se pueden especificar en pulgadas o en porcentaje. Por ejemplo,:
inset_axes(parent_axes, width='40%', height='30%', loc='lower left')
crea en ejes insertados en la esquina inferior izquierda de parent_axes que abarca más del 30 % de altura y el 40 % de ancho de parent_axes . Dado que el uso de
inset_axes
puede volverse un poco complicado cuando se exceden estos casos estándar, se recomienda leer los ejemplos .- Parámetros :
- parent_axes
matplotlib.axes.Axes
Ejes para colocar los ejes insertados.
- ancho, alto flotante o str
Tamaño de los ejes insertados para crear. Si se proporciona un flotador, es el tamaño en pulgadas, por ejemplo, ancho = 1,3 . Si se proporciona una cadena, es el tamaño en unidades relativas, por ejemplo, width='40%' . De forma predeterminada, es decir, si no se especifican bbox_to_anchor ni bbox_transform , estos son relativos a parent_axes. De lo contrario, deben entenderse en relación con el cuadro delimitador proporcionado a través de bbox_to_anchor .
- loc str, por defecto: 'arriba a la derecha'
Ubicación para colocar los ejes de inserción. Las ubicaciones válidas son 'superior izquierda', 'superior centro', 'superior derecha', 'centro izquierda', 'centro', 'centro derecha', 'inferior izquierda', 'inferior centro, 'inferior derecha'. Por compatibilidad con versiones anteriores, también se aceptan valores numéricos. Vea el parámetro loc de
Legend
para más detalles.- tupla bbox_to_anchor o
matplotlib.transforms.BboxBase
, opcional Bbox al que se anclarán los ejes insertados. Si es Ninguno, se usa una tupla de (0, 0, 1, 1) si bbox_transform se establece en parent_axes.transAxes o parent_axes.figure.transFigure . De lo contrario, se usa parent_axes.bbox . Si es una tupla, puede ser [izquierda, abajo, ancho, alto] o [izquierda, abajo]. Si el ancho y/o la altura de los kwargs se especifican en unidades relativas, no se puede usar la tupla de 2 [izquierda, abajo]. Tenga en cuenta que, a menos que se establezca bbox_transform , las unidades del cuadro delimitador se interpretan en la coordenada de píxel. Cuando se usa bbox_to_anchor con tupla, casi siempre tiene sentido especificar también un bbox_transform. A menudo, esto podría ser la transformación de ejes parent_axes.transAxes .
- bbox_transform
matplotlib.transforms.Transform
, opcional Transformación para el bbox que contiene los ejes insertados. Si no hay,
transforms.IdentityTransform
se utiliza a. El valor de bbox_to_anchor (o el valor de retorno de su método get_points) es transformado por bbox_transform y luego interpretado como puntos en la coordenada de píxel (que depende de dpi). Puede proporcionar bbox_to_anchor en alguna coordenada normalizada y proporcionar una transformación adecuada (por ejemplo, parent_axes.transAxes ).- tipo axes_class
matplotlib.axes.Axes
, por defecto:HostAxes
El tipo de los ejes insertados recién creados.
- dictado axes_kwargs , opcional
Argumentos de palabras clave para pasar al constructor de los ejes insertados. Los argumentos válidos incluyen:
Propiedad
Descripción
{'caja', 'límite de datos'}
una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
escalar o ninguno
(flotante, flotante) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bool
{'auto', 'igual'} o flotante
bool
desconocido
desconocido
Invocable[[Ejes, Renderer], Bbox]
bool o 'línea'
flotante o Ninguno
bool
Parchear o (Ruta, Transformar) o Ninguno
facecolor
o FCcolor
bool
calle
bool
objeto
bool
bool
desconocido
Ninguno o bool o flotante o invocable
[izquierda, abajo, ancho, alto] o
Bbox
desconocido
flotante o Ninguno
bool
(escala: flotante, longitud: flotante, aleatoriedad: flotante)
booleano o ninguno
calle
calle
bool
desconocido
calle
(abajo: flotador, arriba: flotador)
flotante mayor que -0.5
desconocido
desconocido
desconocido
desconocido
calle
(abajo: flotador, arriba: flotador)
flotante mayor que -0.5
desconocido
desconocido
desconocido
flotar
- flotante del borde , predeterminado: 0.5
Relleno entre los ejes insertados y bbox_to_anchor. Las unidades son ejes de tamaño de fuente, es decir, para un tamaño de fuente predeterminado de 10 puntos borderpad = 0,5 equivale a un relleno de 5 puntos.
- parent_axes
- Devoluciones :
- inset_axes clase_ejes
Objeto de ejes insertados creado.
notas
El significado de bbox_to_anchor y bbox_to_transform se interpreta de forma diferente al de leyenda. El valor de bbox_to_anchor (o el valor de retorno de su método get_points; el valor predeterminado es parent_axes.bbox ) se transforma mediante bbox_transform (el valor predeterminado es Identity transform) y luego se interpreta como puntos en la coordenada de píxel (que depende de dpi).
Por lo tanto, las siguientes tres llamadas son idénticas y crean ejes insertados con respecto 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)
Ejemplos usando mpl_toolkits.axes_grid1.inset_locator.inset_axes
#
Agregar una barra de colores a los ejes insertados
Controlar la posición y el tamaño de las barras de colores con los ejes insertados
Demostración del localizador de recuadros