matplotlib.axes.Axes.annotate #

Machados. annotate ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs ) [source] #

Anote o ponto xy com text text .

Na forma mais simples, o texto é colocado em xy .

Opcionalmente, o texto pode ser exibido em outra posição xytext . Uma seta apontando do texto para o ponto anotado xy pode então ser adicionada definindo arrowprops .

Parâmetros :

texto str

O texto da anotação.

xy (flutuar, flutuar)

O ponto (x, y) a anotar. O sistema de coordenadas é determinado por xycoords .

xytext (float, float), padrão: xy

A posição (x, y) para colocar o texto. O sistema de coordenadas é determinado por textcoords .

xycoords str ou Artistou Transformou callable or (float, float), padrão: 'data'

O sistema de coordenadas em que xy é fornecido. Os seguintes tipos de valores são suportados:

Uma das seguintes cadeias de caracteres:

Valor	Descrição
'figura pontos'	Pontos do canto inferior esquerdo da figura
'figura pixels'	Pixels do canto inferior esquerdo da figura
'fração figura'	Fração da figura do canto inferior esquerdo
'pontos de subfigura'	Pontos do canto inferior esquerdo da subfigura
'subfigura pixels'	Pixels do canto inferior esquerdo da subfigura
'fração de subfigura'	Fração da subfigura do canto inferior esquerdo
'pontos de eixos'	Pontos do canto inferior esquerdo dos eixos
'eixos pixels'	Pixels do canto inferior esquerdo dos eixos
'fração de eixos'	Fração de eixos do canto inferior esquerdo
'dados'	Use o sistema de coordenadas do objeto que está sendo anotado (padrão)
'polar'	(teta, r) se não forem coordenadas nativas de 'dados'

Observe que 'pixels de subfigura' e 'pixels de figura' são os mesmos para a figura principal, portanto, os usuários que desejam um código utilizável em uma subfigura podem usar 'pixels de subfigura'.

Um Artist: xy é interpretado como uma fração do do artista Bbox. Por exemplo , (0, 0) seria o canto inferior esquerdo da caixa delimitadora e (0,5, 1) seria o centro superior da caixa delimitadora.
A Transformpara transformar xy em coordenadas de tela.
Uma função com uma das seguintes assinaturas:
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
onde renderizador é uma RendererBasesubclasse.

O resultado da função é interpretado como os casos Artiste Transformacima.
Uma tupla (xcoords, ycoords) especificando sistemas de coordenadas separados para x e y . xcoords e ycoords devem ser de um dos tipos descritos acima.

Consulte Anotações avançadas para obter mais detalhes.

textcoords str ou Artistou Transformou callable or (float, float), padrão: valor de xycoords

O sistema de coordenadas em que o texto xy é fornecido.

Todos os valores xycoords são válidos, bem como as seguintes strings:

Valor	Descrição
'pontos de compensação'	Deslocamento (em pontos) do valor xy
'pixels deslocados'	Deslocamento (em pixels) do valor xy

ditado de flechas , opcional

As propriedades usadas para desenhar uma FancyArrowPatchseta entre as posições xy e xytext . O padrão é Nenhum, ou seja, nenhuma seta é desenhada.

Por razões históricas, existem duas maneiras diferentes de especificar setas, "simples" e "fantasia":

Seta simples:

Se arrowprops não contiver a chave 'arrowstyle', as chaves permitidas são:

Chave	Descrição
largura	A largura da seta em pontos
largura da cabeça	A largura da base da ponta da seta em pontos
comprimento da cabeça	O comprimento da ponta da seta em pontos
Psiquiatra	Fração do comprimento total para encolher de ambas as extremidades
?	Qualquer chave para`matplotlib.patches.FancyArrowPatch`

A seta é anexada à borda da caixa de texto, a posição exata (cantos ou centros) dependendo de onde está apontando.

Seta extravagante:

Isso é usado se 'arrowstyle' for fornecido no arquivo arrowprops .

As chaves válidas são os seguintes FancyArrowPatch parâmetros:

Chave	Descrição
estilo de seta	o estilo de seta
estilo de conexão	o estilo de conexão
relpos	Veja abaixo; o padrão é (0,5, 0,5)
patchA	padrão é a caixa delimitadora do texto
patchB	padrão é Nenhum
encolherA	padrão é 2 pontos
encolherB	padrão é 2 pontos
escala_mutação	o padrão é o tamanho do texto (em pontos)
aspecto_mutação	padrão é 1.
?	qualquer chave para`matplotlib.patches.PathPatch`

A posição exata do ponto inicial da seta é definida por relpos . É uma tupla de coordenadas relativas da caixa de texto, onde (0, 0) é o canto inferior esquerdo e (1, 1) é o canto superior direito. Os valores <0 e >1 são suportados e especificam pontos fora da caixa de texto. Por padrão (0,5, 0,5), o ponto inicial é centralizado na caixa de texto.

annotation_clip bool ou Nenhum, padrão: Nenhum

Se cortar (ou seja, não desenhar) a anotação quando o ponto de anotação xy estiver fora da área dos eixos.

Se True , a anotação será cortada quando xy estiver fora dos eixos.
Se False , a anotação sempre será desenhada.
Se None , a anotação será cortada quando xy estiver fora dos eixos e xycoords for 'data'.

** kwargs