matplotlib.text

Classes para incluir texto em uma figura.

classe matplotlib.text. Text ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode = Nenhum, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Bases:Artist

Lidar com armazenamento e desenho de texto na janela ou coordenadas de dados.

Crie uma Textinstância em x , y com string text .

O texto é alinhado em relação ao ponto de ancoragem ( x , y ) de acordo com horizontalalignment(padrão: 'esquerda') e verticalalignment (padrão: 'inferior'). Consulte também Alinhamento de texto .

Embora o texto aceite o argumento de palavra-chave 'rótulo', por padrão ele não é adicionado aos identificadores de uma legenda.

Os argumentos de palavra-chave válidos são:

Propriedade	Descrição
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
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	desconhecido
clip_on	desconhecido
clip_path	desconhecido
colorou c	cor
figure	Figure
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

contém ( evento do mouse )

Retorna se o evento do mouse ocorreu dentro da caixa delimitadora alinhada ao eixo do texto.

desenhar ( renderizador )

Desenhe o Artista (e seus filhos) usando o renderizador fornecido.

Isso não tem efeito se o artista não estiver visível ( Artist.get_visible retorna False).

Parâmetros :

subclasse do renderizador .RendererBase

Notas

Este método é substituído nas subclasses Artist.

get_bbox_patch ( )

Retorne o bbox Patch, ou None se patches.FancyBboxPatch não for feito.

get_c ( )

Alias ​​para get_color.

get_color ( )

Retorna a cor do texto.

get_family ( )

Alias ​​para get_fontfamily.

get_font ( )

Alias ​​para get_fontproperties.

get_font_properties ( )

Alias ​​para get_fontproperties.

get_fontfamily ( )

Retorna a lista de famílias de fontes usadas para pesquisa de fontes.

Veja também

font_manager.FontProperties.get_family

get_fontname ( )

Retorna o nome da fonte como uma string.

Veja também

font_manager.FontProperties.get_name

get_fontproperties ( )

Devolva o font_manager.FontProperties.

get_fontsize ( )

Retorna o tamanho da fonte como um número inteiro.

Veja também

font_manager.FontProperties.get_size_in_points

get_fontstyle ( )

Retorna o estilo da fonte como uma string.

Veja também

font_manager.FontProperties.get_style

get_fontvariant ( )

Retorne a variante da fonte como uma string.

Veja também

font_manager.FontProperties.get_variant

get_fontweight ( )

Retorna o peso da fonte como uma string ou um número.

Veja também

font_manager.FontProperties.get_weight

get_ha ( )

Alias ​​para get_horizontalalignment.

get_horizontalalignment ( )

Retorna o alinhamento horizontal como uma string. Será 'esquerda', 'centro' ou 'direita'.

get_math_fontfamily ( )

Retorna o nome da família da fonte para o texto matemático renderizado pelo Matplotlib.

O valor padrão é rcParams["mathtext.fontset"](padrão: 'dejavusans').

Veja também

set_math_fontfamily

get_name ( )

Alias ​​para get_fontname.

get_parse_math ( )

Retorna se a análise de texto matemático é considerada para isso Text.

get_position ( )

Retorna a posição (x, y) do texto.

get_prop_tup ( renderizador = Nenhum )

[ Obsoleto ] Retorna uma tupla hashable de propriedades .

Não se destina a ser legível por humanos, mas é útil para back-ends que desejam armazenar informações derivadas sobre o texto (por exemplo, layouts) e precisam saber se o texto foi alterado.

Notas

Obsoleto desde a versão 3.5.

get_rotation ( )

Retorna o ângulo do texto em graus entre 0 e 360.

get_rotation_mode ( )

Retorna o modo de rotação do texto.

get_size ( )

Alias ​​para get_fontsize.

get_stretch ( )

Retorne a extensão da fonte como uma string ou um número.

Veja também

font_manager.FontProperties.get_stretch

get_style ( )

Alias ​​para get_fontstyle.

get_text ( )

Retorna a string de texto.

get_transform_rotates_text ( )

Retorna se as rotações da transformação afetam a direção do texto.

get_unitless_position ( )

Retorna a posição sem unidade (x, y) do texto.

get_usetex ( )

Retorna se este Textobjeto usa TeX para renderização.

get_va ( )

Alias ​​para get_verticalalignment.

get_variant ( )

Alias ​​para get_fontvariant.

get_verticalalignment ( )

Retorne o alinhamento vertical como uma string. Será 'top', 'center', 'bottom', 'baseline' ou 'center_baseline'.

get_weight ( )

Alias ​​para get_fontweight.

get_window_extent ( renderizador = Nenhum , dpi = Nenhum )

Retorna o Bboxdelimitador do texto, em unidades de exibição.

Além de ser usado internamente, isso é útil para especificar regiões clicáveis ​​em um arquivo png em uma página da web.

Parâmetros :

renderizador Renderizador, opcional

Um renderizador é necessário para calcular a caixa delimitadora. Se o artista já tiver sido desenhado, o renderizador será armazenado em cache; assim, só é necessário passar este argumento ao chamar get_window_extent antes do primeiro sorteio. Na prática, geralmente é mais fácil ativar um draw primeiro, por exemplo, pagando draw_without_renderingou plt.show().

dpi flutuante, opcional

O valor de dpi para calcular o bbox é padronizado self.figure.dpi( não o dpi do renderizador); deve ser definido, por exemplo, se corresponder a regiões com uma figura salva com um valor de dpi personalizado.

get_wrap ( )

Retorna se o texto pode ser quebrado.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<DESATIVAR>, horizontalalignment=<UNSET>, in_layout=<UNSET> , label=<UNSET> , linepacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , seletor =<UNSET> , position=<UNSET> , rasterizado=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=< DESCONFIGURAR> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
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
animated	bool
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	desconhecido
clip_on	desconhecido
clip_path	desconhecido
color	cor
figure	Figure
fontfamily	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties	font_manager.FontPropertiesou stroupathlib.Path
fontsize	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyle	{'normal', 'itálico', 'oblíquo'}
fontvariant	{'normal', 'small caps'}
fontweight	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignment	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignment	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignment	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

set_backgroundcolor ( cor )

Defina a cor de fundo do texto atualizando o bbox.

Parâmetros :

cor cor

Veja também

set_bbox

Para alterar a posição da caixa delimitadora

set_bbox ( rectprops )

Desenhe uma caixa delimitadora em torno de si mesmo.

Parâmetros :

dict rectprops com propriedades parapatches.FancyBboxPatch

O boxstyle padrão é 'quadrado'. A escala de mutação do patches.FancyBboxPatché definida como fontsize.

Exemplos

t.set_bbox(dict(facecolor='red', alpha=0.5))

set_c ( cor )

Alias ​​para set_color.

set_clip_box ( clipbox )

Defina o clipe do artista Bbox.

Parâmetros :

caixa de transferênciaBbox

set_clip_on ( b )

Defina se o artista usa recorte.

Quando os falsos artistas estiverem visíveis fora dos eixos, isso pode levar a resultados inesperados.

Parâmetros :

b bool

set_clip_path ( path , transform = None )

Defina o caminho do clipe do artista.

Parâmetros :

caminho Patchou Pathou TransformedPathou Nenhum

O caminho do clipe. Se for fornecido um Path, a transformação também deve ser fornecida. Se None , um caminho de recorte definido anteriormente é removido.

transformar Transform, opcional

Usado apenas se path for a Path, caso em que o dado Path é convertido em TransformedPathusing transform .

Notas

Para eficiência, se o caminho for um Rectangle, esse método definirá a caixa de recorte para o retângulo correspondente e definirá o caminho de recorte para None.

Por razões técnicas (suporte de set), uma tupla ( path , transform ) também é aceita como um único parâmetro posicional.

set_color ( cor )

Definir a cor de primeiro plano do texto

Parâmetros :

cor cor

set_family ( nome da fonte )

Alias ​​para set_fontfamily.

set_font ( fp )

Alias ​​para set_fontproperties.

set_font_properties ( fp )

Alias ​​para set_fontproperties.

set_fontfamily ( nome da fonte )

Defina a família da fonte. Pode ser uma única string ou uma lista de strings em prioridade decrescente. Cada string pode ser um nome de fonte real ou um nome de classe de fonte genérica. Neste último caso, os nomes de fonte específicos serão pesquisados ​​no rcParams correspondente.

Se uma Textinstância for construída com fontfamily=None, a fonte será definida como rcParams["font.family"](padrão: ['sans-serif']) e o mesmo será feito quando set_fontfamily()for chamado em uma Textinstância existente.

Parâmetros :

fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

Veja também

font_manager.FontProperties.set_family

set_fontname ( fontname )

Alias ​​para set_family.

Apenas alias unidirecional: o getter é diferente.

Parâmetros :

fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

Veja também

font_manager.FontProperties.set_family

set_fontproperties ( fp )

Defina as propriedades da fonte que controlam o texto.

Parâmetros :

fp font_manager.FontPropertiesou stroupathlib.Path

Se for str, será interpretado como um padrão fontconfig analisado por FontProperties. Se for pathlib.Path, será interpretado como o caminho absoluto para um arquivo de fonte.

set_fontsize ( tamanho da fonte )

Defina o tamanho da fonte.

Parâmetros :

fontsize float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

Se float, o tamanho da fonte em pontos. Os valores de string denotam tamanhos relativos ao tamanho de fonte padrão.

Veja também

font_manager.FontProperties.set_size

set_fontstretch ( stretch )

Defina o alongamento da fonte (condensação ou expansão horizontal).

Parâmetros :

trecho {um valor numérico no intervalo 0-1000, 'ultra-condensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra- expandido', 'ultra-expandido'}

Veja também

font_manager.FontProperties.set_stretch

set_fontstyle ( fontstyle )

Defina o estilo da fonte.

Parâmetros :

fontstyle {'normal', 'itálico', 'oblíquo'}

Veja também

font_manager.FontProperties.set_style

set_fontvariant ( variante )

Defina a variante da fonte.

Parâmetros :

variante {'normal', 'small-caps'}

Veja também

font_manager.FontProperties.set_variant

set_fontweight ( peso )

Defina o peso da fonte.

Parâmetros :

peso {um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'semibold', 'meio' , 'negrito', 'pesado', 'extra negrito', 'preto'}

Veja também

font_manager.FontProperties.set_weight

set_ha ( alinhar )

Alias ​​para set_horizontalalignment.

set_horizontalalignment ( align )

Defina o alinhamento horizontal em relação ao ponto de ancoragem.

Consulte também Alinhamento de texto .

Parâmetros :

alinhar {'esquerda', 'centro', 'direita'}

set_linespacing ( espaçamento )

Defina o espaçamento entre linhas como um múltiplo do tamanho da fonte.

O espaçamento de linha padrão é 1,2.

Parâmetros :

flutuação de espaçamento (múltiplo do tamanho da fonte)

set_ma ( alinhar )

Alias ​​para set_multialignment.

set_math_fontfamily ( fontfamily )

Defina a família de fontes para o texto matemático renderizado pelo Matplotlib.

Isso afeta apenas o próprio renderizador matemático do Matplotlib. Não tem efeito ao renderizar com TeX ( usetex=True).

Parâmetros :

fontfamily str

O nome da família de fontes.

As famílias de fontes disponíveis são definidas no arquivo matplotlibrc.template .

Veja também

get_math_fontfamily

set_multialignment ( align )

Defina o alinhamento do texto para textos de várias linhas.

O layout da caixa delimitadora de todas as linhas é determinado pelas propriedades horizontalalignment e verticalalignment. Esta propriedade controla o alinhamento das linhas de texto dentro dessa caixa.

Parâmetros :

alinhar {'esquerda', 'direita', 'centro'}

set_name ( nome da fonte )

Alias ​​para set_fontname.

set_parse_math ( parse_math )

Substitua a opção para desabilitar qualquer análise de texto matemático para isso Text.

Parâmetros :

parse_math bool

Se False, isso Textnunca usará mathtext. Se True, mathtext será usado se houver um número par de cifrões sem escape.

set_position ( xy )

Defina a posição ( x , y ) do texto.

Parâmetros :

xy (flutuar, flutuar)

set_rotation ( s )

Defina a rotação do texto.

Parâmetros :

s flutuar ou {'vertical', 'horizontal'}

O ângulo de rotação em graus na direção matematicamente positiva (sentido anti-horário). 'horizontal' é igual a 0, 'vertical' é igual a 90.

set_rotation_mode ( m )

Defina o modo de rotação do texto.

Parâmetros :

m {Nenhum, 'padrão', 'âncora'}

Se Noneou "default", o texto será primeiro girado e depois alinhado de acordo com seus alinhamentos horizontal e vertical. Se "anchor", então o alinhamento ocorre antes da rotação.

set_size ( tamanho da fonte )

Alias ​​para set_fontsize.

set_stretch ( stretch )

Alias ​​para set_fontstretch.

set_style ( estilo da fonte )

Alias ​​para set_fontstyle.

set_text ( s )

Defina a cadeia de texto s .

Pode conter novas linhas ( \n) ou matemática na sintaxe LaTeX.

Parâmetros :

s objeto

Qualquer objeto é convertido em sua strrepresentação, exceto o Noneque é convertido em uma string vazia.

set_transform_rotates_text ( t )

Se as rotações da transformação afetam a direção do texto.

Parâmetros :

t bool

set_usetex ( usetex )

Parâmetros :

usetex bool ou nenhum

Se renderizar usando TeX, Nonesignifica usar rcParams["text.usetex"](padrão: False).

set_va ( alinhar )

Alias ​​para set_verticalalignment.

set_variant ( variante )

Alias ​​para set_fontvariant.

set_verticalalignment ( align )

Defina o alinhamento vertical em relação ao ponto de ancoragem.

Consulte também Alinhamento de texto .

Parâmetros :

align {'bottom', 'baseline', 'center', 'center_baseline', 'top'}

set_weight ( peso )

Alias ​​para set_fontweight.

set_wrap ( wrap )

Defina se o texto pode ser quebrado.

Parâmetros :

embrulhar bool

Notas

O wrapping não funciona junto com (que também é usado internamente no IPython/Jupyter). A configuração 'apertada' redimensiona a tela para acomodar todo o conteúdo e ocorre antes do empacotamento.savefig(..., bbox_inches='tight')%matplotlib inline

set_x ( x )

Defina a posição x do texto.

Parâmetros :

x flutuar

set_y ( y )

Defina a posição y do texto.

Parâmetros :

você flutua

atualização ( kwargs )

Atualize as propriedades deste artista nos dict props .

Parâmetros :

props dict

update_bbox_position_size ( renderizador )

Atualize o local e o tamanho do bbox.

Este método deve ser usado quando a posição e o tamanho do bbox precisam ser atualizados antes de realmente desenhar o bbox.

update_from ( outro )

Copie as propriedades de outro para si mesmo .

zorder = 3

classe matplotlib.text. Anotação ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs )

Bases: Text,_AnnotationBase

An Annotationé um Textque pode se referir a uma posição específica xy . Opcionalmente, uma seta apontando do texto para xy pode ser desenhada.

Atributos :

xy

A posição anotada.

xycoords

O sistema de coordenadas para xy .

seta_patch

A FancyArrowPatchpara apontar de xytext para xy .

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

registros de propriedade

O sistema de coordenadas a ser usado para Annotation.xyann.

contém ( evento )

Retorna se o evento do mouse ocorreu dentro da caixa delimitadora alinhada ao eixo do texto.

desenhar ( renderizador )

Desenhe o Artista (e seus filhos) usando o renderizador fornecido.

Isso não tem efeito se o artista não estiver visível ( Artist.get_visible retorna False).

Parâmetros :

subclasse do renderizador .RendererBase

Notas

Este método é substituído nas subclasses Artist.

get_anncoords ( )

Retorne o sistema de coordenadas a ser usado para Annotation.xyann.

Veja também xycoords em Annotation.

get_tightbbox ( renderizador = Nenhum )

Como Artist.get_window_extent, mas inclui qualquer recorte.

Parâmetros :

subclasse do renderizadorRendererBase

renderizador que será usado para desenhar as figuras (ie fig.canvas.get_renderer())

Devoluções :

Bbox

A caixa delimitadora delimitadora (em coordenadas de pixel da figura).

get_window_extent ( renderizador = Nenhum )

Retorna o Bboxdelimitador do texto, em unidades de exibição.

Além de ser usado internamente, isso é útil para especificar regiões clicáveis ​​em um arquivo png em uma página da web.

Parâmetros :

renderizador Renderizador, opcional

Um renderizador é necessário para calcular a caixa delimitadora. Se o artista já tiver sido desenhado, o renderizador será armazenado em cache; assim, só é necessário passar este argumento ao chamar get_window_extent antes do primeiro sorteio. Na prática, geralmente é mais fácil ativar um draw primeiro, por exemplo, pagando draw_without_renderingou plt.show().

dpi flutuante, opcional

O valor de dpi para calcular o bbox é padronizado self.figure.dpi( não o dpi do renderizador); deve ser definido, por exemplo, se corresponder a regiões com uma figura salva com um valor de dpi personalizado.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animado=<UNSET> , anncoords=<UNSET> , annotation_clip=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET > , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontevariante=<UNSET> , fontweight=<UNSET>, gid=<UNSET> , horizontalalignment=<UNSET> , in_layout=<UNSET> , label=<UNSET> , linepacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math =<UNSET> , path_effects=<UNSET> , picker=<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=< DESCONFIGURAR> ,text=<UNSET> ,transform=<UNSET> , transform_rotates_text=<UNSET> , url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y= <UNSET> , zorder=<UNSET> )

Defina várias propriedades de uma só vez.

As propriedades suportadas são

Propriedade	Descrição
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
animated	bool
anncoords	desconhecido
annotation_clip	bool ou nenhum
backgroundcolor	cor
bbox	ditado com propriedades parapatches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
colorou c	cor
figure	desconhecido
fontfamilyou família	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou fonte ou font_properties	font_manager.FontPropertiesou stroupathlib.Path
fontsizeou tamanho	float ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou esticar	{um valor numérico no intervalo de 0 a 1000, 'ultracondensado', 'extracondensado', 'condensado', 'semicondensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleou estilo	{'normal', 'itálico', 'oblíquo'}
fontvariantou variante	{'normal', 'small caps'}
fontweightou peso	{um valor numérico no intervalo de 0 a 1000, 'ultraleve', 'leve', 'normal', 'regular', 'livro', 'médio', 'romano', 'semibold', 'demibold', 'meio', 'negrito', 'pesado', 'extra negrito', 'preto'}
gid	str
horizontalalignmentou ha	{'esquerda', 'centro', 'direita'}
in_layout	bool
label	objeto
linespacing	float (múltiplo do tamanho da fonte)
math_fontfamily	str
mouseover	bool
multialignmentou mãe	{'esquerda', 'direita', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None ou bool ou float ou callable
position	(flutuar, flutuar)
rasterized	bool
rotation	flutuante ou {'vertical', 'horizontal'}
rotation_mode	{Nenhum, 'padrão', 'âncora'}
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
text	objeto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool ou nenhum
verticalalignmentou va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	flutuador
y	flutuador
zorder	flutuador

set_anncoords ( coords )

Defina o sistema de coordenadas a ser usado para Annotation.xyann.

Veja também xycoords em Annotation.

set_figure ( fig )

Defina a Figureinstância à qual o artista pertence.

Parâmetros :

FIGFigure

update_positions ( renderizador )

Atualize as posições de pixel do texto de anotação e a correção de seta.

propriedade xyann

A posição do texto.

Consulte também xytext em Annotation.

propriedade xycoords

classe matplotlib.text. OffsetFrom ( artist , ref_coord , unit = 'points' )

Bases:object

Classe auxiliar chamável para trabalhar com Annotation.

Parâmetros :

artista Artistou BboxBaseouTransform

O objeto do qual calcular o deslocamento.

ref_coord (flutuar, flutuar)

Se o artista for um Artistou BboxBase, esses valores serão a localização da origem do deslocamento em frações da caixa delimitadora do artista .

Se artist for uma transformação, a origem do deslocamento será a transformação aplicada a esse valor.

unidade {'pontos, 'pixels'}, padrão: 'pontos'

As unidades de tela a serem usadas (pixels ou pontos) para a entrada de deslocamento.

get_unit ( )

Retorne a unidade de entrada para a transformação usada por __call__.

set_unit ( unidade )

Defina a unidade de entrada para a transformação usada por __call__.

Parâmetros :

unidade {'pontos', 'pixels'}