mpl_toolkits.axes_grid1.inset_locator.inset_axes

mpl_toolkits.axes_grid1.inset_locator. inset_axes ( parent_axes , largura , altura , loc = 'superior direito' , bbox_to_anchor = Nenhum , bbox_transform = Nenhum , axes_class = Nenhum , axes_kwargs = Nenhum , borderpad = 0,5 )

Crie eixos inseridos com uma determinada largura e altura.

Ambos os tamanhos usados ​​podem ser especificados em polegadas ou em porcentagem. Por exemplo,:

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

cria eixos inseridos no canto inferior esquerdo de parent_axes que abrange mais de 30% em altura e 40% em largura de parent_axes . Como o uso de inset_axespode se tornar um pouco complicado ao exceder esses casos padrão, é recomendável ler os exemplos .

Parâmetros :

parent_axesmatplotlib.axes.Axes

Eixos para colocar os eixos inseridos.

largura, altura float ou str

Tamanho dos eixos de inserção a serem criados. Se for fornecido um float, é o tamanho em polegadas, por exemplo, width=1.3 . Se uma string for fornecida, é o tamanho em unidades relativas, por exemplo, width='40%' . Por padrão, ou seja, se nem bbox_to_anchor nem bbox_transform forem especificados, eles serão relativos aos parent_axes. Caso contrário, eles devem ser entendidos em relação à caixa delimitadora fornecida por meio de bbox_to_anchor .

loc str, padrão: 'canto superior direito'

Localização para colocar os eixos de inserção. Os locais válidos são 'superior esquerdo', 'superior central', 'superior direito', 'centro esquerdo', 'centro', 'centro direito', 'inferior esquerdo', 'inferior centro, 'inferior direito'. Para compatibilidade com versões anteriores, valores numéricos também são aceitos. Consulte o parâmetro loc de Legendpara obter detalhes.

bbox_to_anchor tupla ou matplotlib.transforms.BboxBase, opcional

Bbox onde os eixos inseridos serão ancorados. Se Nenhum, uma tupla de (0, 0, 1, 1) será usada se bbox_transform for definido como parent_axes.transAxes ou parent_axes.figure.transFigure . Caso contrário, parent_axes.bbox é usado. Se for uma tupla, pode ser [esquerda, inferior, largura, altura] ou [esquerda, inferior]. Se a largura e/ou altura dos kwargs forem especificadas em unidades relativas, a 2 tupla [esquerda, inferior] não poderá ser usada. Observe que, a menos que bbox_transform seja definido, as unidades da caixa delimitadora são interpretadas na coordenada de pixel. Ao usar bbox_to_anchor com tupla, quase sempre faz sentido especificar também uma bbox_transform. Muitas vezes, isso pode ser a transformação dos eixos parent_axes.transAxes .

bbox_transform matplotlib.transforms.Transform, opcional

Transformação para o bbox que contém os eixos inseridos. Se Nenhum, um transforms.IdentityTransformé usado. O valor de bbox_to_anchor (ou o valor de retorno de seu método get_points) é transformado pelo bbox_transform e então interpretado como pontos na coordenada de pixel (que é dependente de dpi). Você pode fornecer bbox_to_anchor em alguma coordenada normalizada e fornecer uma transformação apropriada (por exemplo, parent_axes.transAxes ).

tipo axes_class matplotlib.axes.Axes, padrão:HostAxes

O tipo dos eixos inseridos recém-criados.

ditado axes_kwargs , opcional

Argumentos de palavra-chave a serem passados ​​para o construtor dos eixos inseridos. Argumentos válidos incluem:

Propriedade	Descrição
adjustable	{'caixa', 'dados'}
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
anchor	(float, float) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'igual'} ou flutuante
autoscale_on	bool
autoscalex_on	desconhecido
autoscaley_on	desconhecido
axes_locator	Callable[[Axes, Renderer], Bbox]
axisbelow	bool ou 'linha'
box_aspect	flutuante ou nenhum
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
facecolorou fc	cor
figure	Figure
frame_on	bool
gid	str
in_layout	bool
label	objeto
mouseover	bool
navigate	bool
navigate_mode	desconhecido
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	[esquerda, inferior, largura, altura] ouBbox
prop_cycle	desconhecido
rasterization_zorder	flutuante ou nenhum
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
title	str
transform	Transform
url	str
visible	bool
xbound	desconhecido
xlabel	str
xlim	(inferior: flutuar, superior: flutuar)
xmargin	flutuação maior que -0,5
xscale	desconhecido
xticklabels	desconhecido
xticks	desconhecido
ybound	desconhecido
ylabel	str
ylim	(inferior: flutuar, superior: flutuar)
ymargin	flutuação maior que -0,5
yscale	desconhecido
yticklabels	desconhecido
yticks	desconhecido
zorder	flutuador

flutuação do borderpad , padrão: 0,5

Preenchimento entre os eixos inseridos e o bbox_to_anchor. As unidades são o tamanho da fonte dos eixos, ou seja, para um tamanho de fonte padrão de 10 pontos, borderpad = 0,5 é equivalente a um preenchimento de 5 pontos.

Devoluções :

inset_axes axes_class

Objeto de eixos inseridos criado.

Notas

O significado de bbox_to_anchor e bbox_to_transform é interpretado de forma diferente da legenda. O valor de bbox_to_anchor (ou o valor de retorno de seu método get_points; o padrão é parent_axes.bbox ) é transformado por bbox_transform (o padrão é transformação de identidade) e então interpretado como pontos na coordenada de pixel (que é dependente de dpi).

Assim, as três chamadas a seguir são idênticas e criam um eixo inserido em relação ao 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)

Exemplos usando mpl_toolkits.axes_grid1.inset_locator.inset_axes

Adicionando uma barra de cores para inserir eixos

Adicionando uma barra de cores para inserir eixos

Controlando a posição e o tamanho das barras de cores com eixos inseridos

Controlando a posição e o tamanho das barras de cores com eixos inseridos

Demonstração do Localizador de Inserção

Demonstração do Localizador de Inserção