matplotlib.axes

Herança

A classe de eixos

classe matplotlib.axes. Axes ( fig , rect , * , facecolor = None , frameon = True , sharex = None , sharey = None , label = '' , xscale = None , yscale = None , box_aspect = None , ** kwargs )

Bases:_AxesBase

O Axescontém a maioria dos elementos da figura: Axis, Tick, Line2D, Text, Polygon, etc., e define o sistema de coordenadas.

A Axesinstância oferece suporte a retornos de chamada por meio de um atributo de retornos de chamada que é uma CallbackRegistryinstância. Os eventos aos quais você pode se conectar são 'xlim_changed' e 'ylim_changed' e o retorno de chamada será chamado com func( ax ) onde ax é a Axesinstância.

Atributos :

dataLimBbox

A caixa delimitadora que inclui todos os dados exibidos nos eixos.

viewLimBbox

Os limites de exibição em coordenadas de dados.

Construa um eixo em uma figura.

Parâmetros :

FIGFigure

Os eixos são construídos na fig .Figure

rect tupla (esquerda, inferior, largura, altura).

Os eixos são construídos no retângulo rect . rect está em Figurecoordenadas.

sharex, sharey Axes, opcional

O x ou y axisé compartilhado com o eixo x ou y na entrada Axes.

frameon bool, padrão: True

Se o quadro Axes está visível.

box_aspect flutuante, opcional

Defina um aspecto fixo para a caixa Axes, ou seja, a proporção entre altura e largura. Consulte set_box_aspectpara obter detalhes.

** kwargs

Outros argumentos de palavra-chave opcionais:

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

Devoluções :

Axes

O novo Axesobjeto.

Subparcelas

SubplotBase	Classe base para subplots, que são Axesinstâncias com métodos adicionais para facilitar a geração e manipulação de um conjunto Axesdentro de uma figura.
subplot_class_factory

Plotando

Básico

Axes.plot	Plote y versus x como linhas e/ou marcadores.
Axes.errorbar	Plote y versus x como linhas e/ou marcadores com barras de erro anexadas.
Axes.scatter	Um gráfico de dispersão de y vs.
Axes.plot_date	[ Desanimado ] Gráfico coagindo o eixo a tratar flutuações como datas.
Axes.step	Faça um gráfico de passos.
Axes.loglog	Faça um gráfico com escala de log nos eixos x e y.
Axes.semilogx	Faça um gráfico com escala de log no eixo x.
Axes.semilogy	Faça um gráfico com escala de log no eixo y.
Axes.fill_between	Preencha a área entre duas curvas horizontais.
Axes.fill_betweenx	Preencha a área entre duas curvas verticais.
Axes.bar	Faça um gráfico de barras.
Axes.barh	Faça um gráfico de barra horizontal.
Axes.bar_label	Rotule um gráfico de barras.
Axes.stem	Crie um gráfico de tronco.
Axes.eventplot	Traçar linhas paralelas idênticas nas posições dadas.
Axes.pie	Plote um gráfico de pizza.
Axes.stackplot	Desenhe um gráfico de área empilhada.
Axes.broken_barh	Trace uma sequência horizontal de retângulos.
Axes.vlines	Plote linhas verticais em cada x de ymin a ymax .
Axes.hlines	Trace linhas horizontais em cada y de xmin a xmax .
Axes.fill	Traçar polígonos preenchidos.

Períodos

Axes.axhline	Adicione uma linha horizontal ao longo dos eixos.
Axes.axhspan	Adicione uma extensão horizontal (retângulo) entre os eixos.
Axes.axvline	Adicione uma linha vertical nos eixos.
Axes.axvspan	Adicione uma extensão vertical (retângulo) entre os eixos.
Axes.axline	Adicione uma linha reta infinitamente longa.

Espectral

Axes.acorr	Plote a autocorrelação de x .
Axes.angle_spectrum	Trace o espectro do ângulo.
Axes.cohere	Trace a coerência entre x e y .
Axes.csd	Plote a densidade espectral cruzada.
Axes.magnitude_spectrum	Traçar o espectro de magnitude.
Axes.phase_spectrum	Plote o espectro de fase.
Axes.psd	Plote a densidade espectral de potência.
Axes.specgram	Traçar um espectrograma.
Axes.xcorr	Trace a correlação cruzada entre x e y .

Estatísticas

Axes.boxplot	Desenhe um gráfico de caixa e bigodes.
Axes.violinplot	Faça um enredo de violino.
Axes.violin	Função de desenho para plotagens de violino.
Axes.bxp	Função de desenho para gráficos de caixa e bigode.

#

Axes.hexbin	Faça um gráfico binning hexagonal 2D dos pontos x , y .
Axes.hist	Calcular e traçar um histograma.
Axes.hist2d	Faça um gráfico de histograma 2D.
Axes.stairs	Uma função constante passo a passo como uma linha com arestas delimitadoras ou um gráfico preenchido.

Contornos

Axes.clabel	Rotule um gráfico de contorno.
Axes.contour	Traçar linhas de contorno.
Axes.contourf	Plotar contornos preenchidos.

matrizes 2D

Axes.imshow	Exibir dados como uma imagem, ou seja, em um raster regular 2D.
Axes.matshow	Plote os valores de uma matriz 2D ou array como imagem codificada por cores.
Axes.pcolor	Crie um gráfico de pseudocor com uma grade retangular não regular.
Axes.pcolorfast	Crie um gráfico de pseudocor com uma grade retangular não regular.
Axes.pcolormesh	Crie um gráfico de pseudocor com uma grade retangular não regular.
Axes.spy	Plote o padrão de dispersão de uma matriz 2D.

Triângulos não estruturados

Axes.tripcolor	Crie um gráfico de pseudocor de uma grade triangular não estruturada.
Axes.triplot	Desenhe uma grade triangular não estruturada como linhas e/ou marcadores.
Axes.tricontour	Desenhe linhas de contorno em uma grade triangular não estruturada.
Axes.tricontourf	Desenhe regiões de contorno em uma grade triangular não estruturada.

Texto e anotações

Axes.annotate	Anote o ponto xy com text text .
Axes.text	Adicione texto aos eixos.
Axes.table	Adicionar uma tabela a um arquivo Axes.
Axes.arrow	Adicione uma seta aos eixos.
Axes.inset_axes	Adicione um filho inserido Axes a este Axes existente.
Axes.indicate_inset	Adicione um indicador de inserção aos eixos.
Axes.indicate_inset_zoom	Adicione um retângulo indicador de inserção aos eixos com base nos limites do eixo para um inset_ax e desenhe conectores entre o inset_ax e o retângulo.
Axes.secondary_xaxis	Adicione um segundo eixo x a este Axes.
Axes.secondary_yaxis	Adicione um segundo eixo y a este Axes.

Campos vetoriais

Axes.barbs	Traçar um campo 2D de farpas.
Axes.quiver	Traçar um campo 2D de setas.
Axes.quiverkey	Adicione uma chave a um gráfico de aljava.
Axes.streamplot	Desenhe linhas de corrente de um fluxo vetorial.

Limpando

Axes.cla	Limpe os eixos.
Axes.clear	Limpe os eixos.

Aparência

Axes.axis	Método de conveniência para obter ou definir algumas propriedades do eixo.
Axes.set_axis_off	Desligue os eixos x e y.
Axes.set_axis_on	Ative os eixos x e y.
Axes.set_frame_on	Defina se o patch do retângulo Axes é desenhado.
Axes.get_frame_on	Obtenha se o patch do retângulo Axes é desenhado.
Axes.set_axisbelow	Defina se os tiques do eixo e as linhas de grade estão acima ou abaixo da maioria dos artistas.
Axes.get_axisbelow	Obtenha se os carrapatos do eixo e as linhas de grade estão acima ou abaixo da maioria dos artistas.
Axes.grid	Configure as linhas de grade.
Axes.get_facecolor	Obtenha a cor da face dos eixos.
Axes.set_facecolor	Defina a cor da face dos eixos.

Ciclo da propriedade

Axes.set_prop_cycle

Defina o ciclo de propriedade dos eixos.

Eixo / limites

Axes.get_xaxis	[ Desanimado ] Retorne a instância XAxis.
Axes.get_yaxis	[ Desanimado ] Retorne a instância YAxis.

Limites e direção do eixo

Axes.invert_xaxis	Inverta o eixo x.
Axes.xaxis_inverted	Retorna se o eixo x está orientado na direção "inversa".
Axes.invert_yaxis	Inverta o eixo y.
Axes.yaxis_inverted	Retorna se o eixo ya está orientado na direção "inversa".
Axes.set_xlim	Defina os limites de exibição do eixo x.
Axes.get_xlim	Retorne os limites de visualização do eixo x.
Axes.set_ylim	Defina os limites de visualização do eixo y.
Axes.get_ylim	Retorne os limites de visualização do eixo y.
Axes.update_datalim	Estenda o dataLimBbox para incluir os pontos fornecidos.
Axes.set_xbound	Defina os limites numéricos inferior e superior do eixo x.
Axes.get_xbound	Retorne os limites inferior e superior do eixo x, em ordem crescente.
Axes.set_ybound	Defina os limites numéricos inferior e superior do eixo y.
Axes.get_ybound	Retorne os limites inferior e superior do eixo y, em ordem crescente.

Rótulos de eixo, título e legenda

Axes.set_xlabel	Defina o rótulo para o eixo x.
Axes.get_xlabel	Obtenha a string de texto xlabel.
Axes.set_ylabel	Defina o rótulo para o eixo y.
Axes.get_ylabel	Obtenha a string de texto ylabel.
Axes.set_title	Defina um título para os eixos.
Axes.get_title	Obtenha um título de Axes.
Axes.legend	Coloque uma legenda nos eixos.
Axes.get_legend	Retorne a Legendinstância ou None se nenhuma legenda for definida.
Axes.get_legend_handles_labels	Alças de retorno e rótulos para legenda

Escalas de eixo

Axes.set_xscale	Defina a escala do eixo x.
Axes.get_xscale	Retorne a escala do xaxis (como um str).
Axes.set_yscale	Defina a escala do yaxis.
Axes.get_yscale	Retorne a escala do yaxis (como um str).

Escala automática e margens

Axes.use_sticky_edges	Ao escalar automaticamente, se deve obedecer a todos os arquivos Artist.sticky_edges.
Axes.margins	Defina ou recupere margens de escala automática.
Axes.set_xmargin	Defina o preenchimento dos limites de dados X antes do escalonamento automático.
Axes.set_ymargin	Defina o preenchimento dos limites de dados Y antes do dimensionamento automático.
Axes.relim	Recalcule os limites de dados com base nos artistas atuais.
Axes.autoscale	Escale automaticamente a exibição do eixo para os dados (alternar).
Axes.autoscale_view	Escale automaticamente os limites de exibição usando os limites de dados.
Axes.set_autoscale_on	Defina se o dimensionamento automático é aplicado a cada eixo no próximo desenho ou chamada para Axes.autoscale_view.
Axes.get_autoscale_on	Retorna True se cada eixo for dimensionado automaticamente, False caso contrário.
Axes.set_autoscalex_on	Defina se o eixo x é dimensionado automaticamente ao desenhar ou por Axes.autoscale_view.
Axes.get_autoscalex_on	Retorna se o xaxis é dimensionado automaticamente.
Axes.set_autoscaley_on	Defina se o eixo ya é dimensionado automaticamente ao desenhar ou por Axes.autoscale_view.
Axes.get_autoscaley_on	Retorna se o yaxis é dimensionado automaticamente.

Proporção

Axes.apply_aspect	Ajuste os eixos para uma proporção de aspecto de dados especificada.
Axes.set_aspect	Defina a proporção da escala dos eixos, ou seja, escala y/x.
Axes.get_aspect	Retorna a proporção da escala dos eixos.
Axes.set_box_aspect	Defina o aspecto da caixa Axes, ou seja, a proporção entre altura e largura.
Axes.get_box_aspect	Retorna o aspecto da caixa Axes, ou seja, a proporção entre altura e largura.
Axes.set_adjustable	Defina como os eixos se ajustam para atingir a proporção necessária.
Axes.get_adjustable	Retorna se os Axes ajustarão sua dimensão física ('box') ou seus limites de dados ('datalim') para atingir a proporção desejada.

Carrapatos e rótulos de carrapatos

Axes.set_xticks	Defina os locais de marcação do eixo x e, opcionalmente, os rótulos.
Axes.get_xticks	Retorna as localizações dos ticks do xaxis nas coordenadas de dados.
Axes.set_xticklabels	Defina os rótulos do xaxis com a lista de rótulos de string.
Axes.get_xticklabels	Obtenha os rótulos dos ticks do xaxis.
Axes.get_xmajorticklabels	Retorne os principais rótulos de marcação do eixo x, como uma lista de Text.
Axes.get_xminorticklabels	Retorne os rótulos de escala menores do xaxis, como uma lista de Text.
Axes.get_xgridlines	Retorne as linhas de grade do xaxis como uma lista de Line2Ds.
Axes.get_xticklines	Retorna as linhas de escala do xaxis como uma lista de Line2Ds.
Axes.xaxis_date	Configure marcações de eixo e rótulos para tratar os dados ao longo do eixo x como datas.
Axes.set_yticks	Defina os locais dos tiques do yaxis e, opcionalmente, os rótulos.
Axes.get_yticks	Retorna as localizações dos ticks do yaxis nas coordenadas de dados.
Axes.set_yticklabels	Defina os rótulos dos yaxis com a lista de rótulos de string.
Axes.get_yticklabels	Obtenha os rótulos de marcação dos yaxis.
Axes.get_ymajorticklabels	Retorne os principais rótulos de marcação do yaxis, como uma lista de Text.
Axes.get_yminorticklabels	Retorne os rótulos de escala menores do yaxis, como uma lista de Text.
Axes.get_ygridlines	Retorna as linhas de grade do yaxis como uma lista de Line2Ds.
Axes.get_yticklines	Retorna as linhas de marcação do yaxis como uma lista de Line2Ds.
Axes.yaxis_date	Configure marcas de eixo e rótulos para tratar os dados ao longo do eixo ya como datas.
Axes.minorticks_off	Remova marcas menores dos eixos.
Axes.minorticks_on	Exiba marcas menores nos eixos.
Axes.ticklabel_format	Configure o ScalarFormatterusado por padrão para eixos lineares.
Axes.tick_params	Altere a aparência de marcadores, rótulos de marcadores e linhas de grade.
Axes.locator_params	Controle o comportamento dos principais localizadores de carrapatos.

Unidades

Axes.convert_xunits	Converta x usando o tipo de unidade do eixo x.
Axes.convert_yunits	Converta y usando o tipo de unidade do eixo ya.
Axes.have_units	Retorna se as unidades são definidas em qualquer eixo.

Adicionando artistas

Axes.add_artist	Adicione um Artistaos Eixos; devolver o artista.
Axes.add_child_axes	Adicione um AxesBaseaos filhos dos Axes; retorne os eixos filhos.
Axes.add_collection	Adicione um Collectionaos Eixos; devolver a coleção.
Axes.add_container	Adicione um Containeraos contêineres dos Axes; devolva o recipiente.
Axes.add_image	Adicione um AxesImageaos Eixos; devolva a imagem.
Axes.add_line	Adicione um Line2Daos Eixos; retornar a linha.
Axes.add_patch	Adicione um Patchaos Eixos; devolva o remendo.
Axes.add_table	Adicione um Tableaos Eixos; devolver a mesa.

Geminação e partilha

Axes.twinx	Crie um Axes gêmeo compartilhando o xaxis.
Axes.twiny	Crie um Axes gêmeo compartilhando o yaxis.
Axes.sharex	Compartilhe o eixo x com outros arquivos .
Axes.sharey	Compartilhe o eixo y com outros arquivos .
Axes.get_shared_x_axes	Retorna uma visualização imutável no Grouper de eixos x compartilhados.
Axes.get_shared_y_axes	Retorne uma exibição imutável no agrupador de eixos y compartilhado.

Posição dos eixos

Axes.get_anchor	Obtenha a localização da âncora.
Axes.set_anchor	Defina a localização da âncora.
Axes.get_axes_locator	Retorne o axes_locator.
Axes.set_axes_locator	Defina o localizador de eixos.
Axes.reset_position	Redefina a posição ativa para a posição original.
Axes.get_position	Retorne a posição dos eixos dentro da figura como um Bbox.
Axes.set_position	Defina a posição dos eixos.

Assíncrono/baseado em evento

Axes.stale	Se o artista está "obsoleto" e precisa ser redesenhado para que a saída corresponda ao estado interno do artista.
Axes.pchanged	Chame todos os retornos de chamada registrados.
Axes.add_callback	Adicione uma função de retorno de chamada que será chamada sempre que uma das Artistpropriedades de for alterada.
Axes.remove_callback	Remova um retorno de chamada com base em seu ID de observador.

Interativo

Axes.can_pan	Retorna se este eixo suporta qualquer funcionalidade de botão panorâmico/zoom.
Axes.can_zoom	Retorna se este eixo suporta a funcionalidade do botão da caixa de zoom.
Axes.get_navigate	Obtenha se os eixos respondem aos comandos de navegação.
Axes.set_navigate	Defina se os eixos respondem aos comandos da barra de ferramentas de navegação.
Axes.get_navigate_mode	Obtenha o status do botão da barra de ferramentas de navegação: 'PAN', 'ZOOM' ou Nenhum.
Axes.set_navigate_mode	Defina o status do botão da barra de ferramentas de navegação.
Axes.start_pan	Chamado quando uma operação de pan é iniciada.
Axes.drag_pan	Chamado quando o mouse se move durante uma operação de panorâmica.
Axes.end_pan	Chamado quando uma operação de panorâmica é concluída (quando o botão do mouse está para cima).
Axes.format_coord	Retorna uma string de formato formatando as coordenadas x , y .
Axes.format_cursor_data	Retorna uma representação de string de dados .
Axes.format_xdata	Retorne x formatado como um valor x.
Axes.format_ydata	Retorne y formatado como um valor y.
Axes.mouseover	Retorna se este artista é consultado para obter informações de contexto personalizado quando o cursor do mouse passa sobre ele.
Axes.in_axes	Retorna se o evento dado (em coordenadas de exibição) está nos eixos.
Axes.contains	Teste se o artista contém o evento do mouse.
Axes.contains_point	Retorna se o ponto (par de coordenadas de pixel) está dentro do patch Axes.
Axes.get_cursor_data	Retorna os dados do cursor para um determinado evento.

Crianças

Axes.get_children	Retorna uma lista dos filhos Artistdeste Artist.
Axes.get_images	Retorna uma lista de AxesImages contidos pelos Axes.
Axes.get_lines	Retorna uma lista de linhas contidas pelos Axes.
Axes.findobj	Encontre objetos artísticos.

Desenho

Axes.draw	Desenhe o Artista (e seus filhos) usando o renderizador fornecido.
Axes.draw_artist	Redesenhe um único artista com eficiência.
Axes.redraw_in_frame	Redesenhe com eficiência os dados dos Axes, mas não os tiques do eixo, rótulos, etc.
Axes.get_renderer_cache	[ Descontinuado ]
Axes.get_rasterization_zorder	Retorna o valor zorder abaixo do qual os artistas serão rasterizados.
Axes.set_rasterization_zorder	Defina o limite zorder para rasterização para saída de gráficos vetoriais.
Axes.get_window_extent	Retorne a caixa delimitadora dos eixos no espaço de exibição; args e kwargs estão vazios.
Axes.get_tightbbox	Retorne a caixa delimitadora apertada dos Axes, incluindo o eixo e seus decoradores (xlabel, título, etc).

Projeção

Os métodos usados ​​por Axisisso devem ser substituídos por eixos não retilíneos.

Axes.name
Axes.get_xaxis_transform	Obtenha a transformação usada para desenhar rótulos, marcações e linhas de grade do eixo x.
Axes.get_yaxis_transform	Obtenha a transformação usada para desenhar rótulos, marcações e linhas de grade do eixo y.
Axes.get_data_ratio	Retorne a proporção dos dados dimensionados.
Axes.get_xaxis_text1_transform	Devoluções :
Axes.get_xaxis_text2_transform	Devoluções :
Axes.get_yaxis_text1_transform	Devoluções :
Axes.get_yaxis_text2_transform	Devoluções :

Outro

Axes.zorder
Axes.get_default_bbox_extra_artists	Retorna uma lista padrão de artistas usados ​​para o cálculo da caixa delimitadora.
Axes.get_transformed_clip_path_and_affine	Retorne o caminho do clipe com a parte não afim de sua transformação aplicada e a parte afim restante de sua transformação.
Axes.has_data	Retorna se algum artista foi adicionado aos Axes.
Axes.set	Defina várias propriedades de uma só vez.

classe matplotlib.axes.Axes. ArtistList ( axes , prop_name , add_name , valid_types = Nenhum , invalid_types = Nenhum )

Uma sublista de filhos de Axes com base em seu tipo.

As sublistas de filhos específicos do tipo se tornarão imutáveis ​​no Matplotlib 3.7. Então, essas listas de artistas provavelmente serão substituídas por tuplas. Use como se já fosse uma tupla.

Esta classe existe apenas para o período de transição para alertar sobre a modificação obsoleta das listas de artistas.

Parâmetros :

axes .axes.Axes

Os eixos dos quais esta sublista extrairá os artistas filhos.

prop_name str

O nome da propriedade usada para acessar esta sublista dos eixos; usado para gerar avisos de descontinuação.

add_name str

O nome do método usado para adicionar Artistas do tipo desta sublista aos Eixos; usado para gerar avisos de descontinuação.

lista valid_types do tipo, opcional

Uma lista de tipos que determinam quais filhos serão retornados por esta sublista. Se especificado, os Artistas na sublista devem ser instâncias de qualquer um desses tipos. Se não for especificado, qualquer tipo de Artista é válido (a menos que limitado por invalid_types .)

tupla invalid_types , opcional

Uma lista de tipos que determina quais filhos não serão retornados por esta sublista. Se especificado, os Artistas na sublista nunca serão uma instância desses tipos. Caso contrário, nenhum tipo será excluído.

inserir ( índice , item )

S.insert(index, value) -- insere o valor antes do índice