matplotlib.pyplot.annotate #

matplotlib.pyplot. 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 paramatplotlib.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 paramatplotlib.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

Kwargs adicionais são passados ​​para Text.

Devoluções :
Annotation

Veja também

Anotações Avançadas

Exemplos usando matplotlib.pyplot.annotate#

Pyplot tutorial

Pyplot tutorial

Pyplot tutorial
Anotações

Anotações

Anotações