matplotlib.text

Clases para incluir texto en una figura.

clase matplotlib.text. Texto ( x = 0 , y = 0 , texto = '' , * , color = ninguno , alineación vertical = 'línea de base' , alineación horizontal = 'izquierda' , alineación múltiple = ninguna , propiedades de fuente = ninguna , rotación = ninguna , espacio entre líneas = ninguna , modo_rotación = Ninguno, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Bases:Artist

Maneje el almacenamiento y dibujo de texto en coordenadas de ventana o datos.

Cree una Textinstancia en x , y con texto de cadena .

El texto se alinea en relación con el punto de ancla ( x , y ) según horizontalalignment(predeterminado: 'izquierda') y verticalalignment (predeterminado: 'abajo'). Véase también Alineación de texto .

Si bien Texto acepta el argumento de palabra clave 'etiqueta', de forma predeterminada no se agrega a los identificadores de una leyenda.

Los argumentos de palabra clave válidos son:

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
animated	bool
backgroundcolor	color
bbox	dict con propiedades parapatches.FancyBboxPatch
clip_box	desconocido
clip_on	desconocido
clip_path	desconocido
coloro c	color
figure	Figure
fontfamilyo familia	{FONTNAME, 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}
fontpropertieso fuente o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo tamaño	float o {'xx-pequeño', 'x-pequeño', 'pequeño', 'mediano', 'grande', 'x-grande', 'xx-grande'}
fontstretcho estirar	{un valor numérico en el rango 0-1000, 'ultracondensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleo estilo	{'normal', 'cursiva', 'oblicua'}
fontvarianto variante	{'normal', 'pequeñas capitalizaciones'}
fontweighto peso	{un valor numérico en el rango 0-1000, 'ultraligero', 'ligero', 'normal', 'regular', 'libro', 'medio', 'romano', 'semibold', 'demibold', 'demi', 'negrita', 'pesada', 'extra negrita', 'negra'}
gid	calle
horizontalalignmento ja	{'izquierda centro derecha'}
in_layout	bool
label	objeto
linespacing	float (múltiplo del tamaño de fuente)
math_fontfamily	calle
mouseover	bool
multialignmento mamá	{'izquierda', 'derecha', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	(flotar, flotar)
rasterized	bool
rotation	flotante o {'vertical', 'horizontal'}
rotation_mode	{Ninguno, 'predeterminado', 'ancla'}
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
text	objeto
transform	Transform
transform_rotates_text	bool
url	calle
usetex	booleano o ninguno
verticalalignmento va	{'abajo', 'línea base', 'centro', 'línea_base_central', 'arriba'}
visible	bool
wrap	bool
x	flotar
y	flotar
zorder	flotar

contiene ( mouseevent )

Devuelve si el evento del mouse ocurrió dentro del cuadro delimitador alineado con el eje del texto.

dibujar ( procesador )

Dibuja al Artista (y sus hijos) usando el renderizador dado.

Esto no tiene efecto si el artista no está visible ( Artist.get_visible devuelve Falso).

Parámetros :

subclase de renderizador .RendererBase

notas

Este método se anula en las subclases de artista.

get_bbox_patch ( )

Devuelve el bbox Patch, o Ninguno si patches.FancyBboxPatch no está hecho.

get_c ( )

Alias ​​para get_color.

get_color ( )

Devuelve el color del texto.

get_family ( )

Alias ​​para get_fontfamily.

get_font ( )

Alias ​​para get_fontproperties.

get_font_properties ( )

Alias ​​para get_fontproperties.

get_fontfamily ( )

Devuelve la lista de familias de fuentes utilizadas para la búsqueda de fuentes.

Ver también

font_manager.FontProperties.get_family

get_fontname ( )

Devuelve el nombre de la fuente como una cadena.

Ver también

font_manager.FontProperties.get_name

get_fontproperties ( )

Devuelve el font_manager.FontProperties.

get_fontsize ( )

Devuelve el tamaño de fuente como un número entero.

Ver también

font_manager.FontProperties.get_size_in_points

get_fontstyle ( )

Devuelve el estilo de fuente como una cadena.

Ver también

font_manager.FontProperties.get_style

get_fontvariant ( )

Devuelve la variante de fuente como una cadena.

Ver también

font_manager.FontProperties.get_variant

get_fontweight ( )

Devuelve el peso de la fuente como una cadena o un número.

Ver también

font_manager.FontProperties.get_weight

get_ha ( )

Alias ​​para get_horizontalalignment.

get_horizontalalignment ( )

Devuelve la alineación horizontal como una cadena. Será uno de 'izquierda', 'centro' o 'derecha'.

get_math_fontfamily ( )

Devuelve el nombre de la familia de fuentes para el texto matemático representado por Matplotlib.

El valor predeterminado es rcParams["mathtext.fontset"](predeterminado: 'dejavusans').

Ver también

set_math_fontfamily

get_name ( )

Alias ​​para get_fontname.

get_parse_math ( )

Devuelve si se considera el análisis de texto matemático para esto Text.

get_position ( )

Devuelve la posición (x, y) del texto.

get_prop_tup ( procesador = Ninguno )

[ Obsoleto ] Devuelve una tupla de propiedades hashable.

No pretende ser legible por humanos, pero es útil para los backends que desean almacenar en caché información derivada sobre el texto (por ejemplo, diseños) y necesitan saber si el texto ha cambiado.

notas

En desuso desde la versión 3.5.

get_rotation ( )

Devuelve el ángulo del texto en grados entre 0 y 360.

get_rotation_mode ( )

Devuelve el modo de rotación de texto.

get_size ( )

Alias ​​para get_fontsize.

get_stretch ( )

Devuelve el estiramiento de la fuente como una cadena o un número.

Ver también

font_manager.FontProperties.get_stretch

get_style ( )

Alias ​​para get_fontstyle.

get_text ( )

Devuelve la cadena de texto.

get_transform_rotates_text ( )

Devuelve si las rotaciones de la transformación afectan la dirección del texto.

get_unitless_position ( )

Devuelve la posición sin unidades (x, y) del texto.

get_usetex ( )

Devuelve si este Textobjeto usa TeX para renderizar.

get_va ( )

Alias ​​para get_verticalalignment.

get_variant ( )

Alias ​​para get_fontvariant.

get_verticalalignment ( )

Devuelve la alineación vertical como una cadena. Será uno de 'top', 'center', 'bottom', 'baseline' o 'center_baseline'.

get_weight ( )

Alias ​​para get_fontweight.

get_window_extent ( renderizador = Ninguno , dpi = Ninguno )

Devuelve el Bboxlímite del texto, en unidades de visualización.

Además de usarse internamente, esto es útil para especificar regiones en las que se puede hacer clic en un archivo png en una página web.

Parámetros :

renderizador Renderizador, opcional

Se necesita un renderizador para calcular el cuadro delimitador. Si el artista ya ha sido dibujado, el renderizador se almacena en caché; por lo tanto, solo es necesario pasar este argumento al llamar get_window_extent antes del primer sorteo. En la práctica, normalmente es más fácil activar un proyecto primero, por ejemplo, igualando draw_without_renderingo plt.show().

flotante de ppp , opcional

El valor de ppp para calcular el bbox, por defecto es self.figure.dpi( no el renderizador de ppp); debe configurarse, por ejemplo, para hacer coincidir regiones con una figura guardada con un valor de dpi personalizado.

get_wrap ( )

Devuelve si el texto se puede ajustar.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation =<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=<DESCONFIGURAR>, alineaciónhorizontal=<DESCONFIGURAR>, in_layout=<UNSET> , label=<UNSET> , linesping=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , selector =<DESCONFIGURACIÓN> , posición=<DESCONFIGURACIÓN> , rasterizado=<DESCONFIGURACIÓN> , rotación=<DESCONFIGURACIÓN>, modo_rotación = <DESCONFIGURACIÓN> , sketch_params=<DESCONFIGURACIÓN> , snap=<DESCONFIGURACIÓN> , texto=<DESCONFIGURACIÓN> , transform=< DESCONFIGURAR> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

Establece varias propiedades a la vez.

Las propiedades admitidas son

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
animated	bool
backgroundcolor	color
bbox	dict con propiedades parapatches.FancyBboxPatch
clip_box	desconocido
clip_on	desconocido
clip_path	desconocido
color	color
figure	Figure
fontfamily	{FONTNAME, 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}
fontproperties	font_manager.FontPropertieso stropathlib.Path
fontsize	float o {'xx-pequeño', 'x-pequeño', 'pequeño', 'mediano', 'grande', 'x-grande', 'xx-grande'}
fontstretch	{un valor numérico en el rango 0-1000, 'ultracondensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyle	{'normal', 'cursiva', 'oblicua'}
fontvariant	{'normal', 'pequeñas capitalizaciones'}
fontweight	{un valor numérico en el rango 0-1000, 'ultraligero', 'ligero', 'normal', 'regular', 'libro', 'medio', 'romano', 'semibold', 'demibold', 'demi', 'negrita', 'pesada', 'extra negrita', 'negra'}
gid	calle
horizontalalignment	{'izquierda centro derecha'}
in_layout	bool
label	objeto
linespacing	float (múltiplo del tamaño de fuente)
math_fontfamily	calle
mouseover	bool
multialignment	{'izquierda', 'derecha', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	(flotar, flotar)
rasterized	bool
rotation	flotante o {'vertical', 'horizontal'}
rotation_mode	{Ninguno, 'predeterminado', 'ancla'}
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
text	objeto
transform	Transform
transform_rotates_text	bool
url	calle
usetex	booleano o ninguno
verticalalignment	{'abajo', 'línea base', 'centro', 'línea_base_central', 'arriba'}
visible	bool
wrap	bool
x	flotar
y	flotar
zorder	flotar

set_backgroundcolor ( color )

Establezca el color de fondo del texto actualizando el bbox.

Parámetros :

color color

Ver también

set_bbox

Para cambiar la posición del cuadro delimitador

set_bbox ( rectprops )

Dibuja un cuadro delimitador alrededor de ti mismo.

Parámetros :

rectprops dict con propiedades parapatches.FancyBboxPatch

El estilo de caja predeterminado es 'cuadrado'. La escala de mutación de patches.FancyBboxPatchse establece en el tamaño de fuente.

Ejemplos

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

set_c ( color )

Alias ​​para set_color.

set_clip_box ( clipbox )

Establezca el clip del artista Bbox.

Parámetros :

portapapelesBbox

set_clip_on ( b )

Establece si el artista usa recorte.

Cuando los artistas falsos serán visibles fuera de los ejes, lo que puede generar resultados inesperados.

Parámetros :

b bool

set_clip_path ( ruta , transformar = Ninguno )

Establezca la ruta de clip del artista.

Parámetros :

ruta Patcho Patho TransformedPatho Ninguna

La ruta del clip. Si se proporciona un Path, también se debe proporcionar la transformación . Si es Ninguno , se elimina una ruta de clip establecida anteriormente.

transformar Transform, opcional

Solo se usa si la ruta es un Path, en cuyo caso el dado Path se convierte en un TransformedPathuso de transformación .

notas

Para mayor eficiencia, si la ruta es un Rectangle, este método establecerá el cuadro de recorte en el rectángulo correspondiente y establecerá la ruta de recorte en None.

Por razones técnicas (soporte de set), una tupla ( ruta , transformación ) también se acepta como parámetro posicional único.

set_color ( color )

Establecer el color de primer plano del texto

Parámetros :

color color

set_family ( nombre de fuente )

Alias ​​para set_fontfamily.

set_font ( fp )

Alias ​​para set_fontproperties.

set_font_properties ( fp )

Alias ​​para set_fontproperties.

set_fontfamily ( nombre de fuente )

Establecer la familia de fuentes. Puede ser una sola cadena o una lista de cadenas en prioridad decreciente. Cada cadena puede ser un nombre de fuente real o un nombre de clase de fuente genérico. En este último caso, los nombres de las fuentes específicas se buscarán en los rcParams correspondientes.

Si una Textinstancia se construye con fontfamily=None, entonces la fuente se establece en rcParams["font.family"](predeterminada: ['sans-serif']), y se hace lo mismo cuando set_fontfamily()se llama a una Textinstancia existente.

Parámetros :

nombre de fuente { FONTNAME , 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}

Ver también

font_manager.FontProperties.set_family

set_fontname ( nombre de fuente )

Alias ​​para set_family.

Solo alias unidireccional: el captador es diferente.

Parámetros :

nombre de fuente { FONTNAME , 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}

Ver también

font_manager.FontProperties.set_family

set_fontproperties ( fp )

Establezca las propiedades de la fuente que controlan el texto.

Parámetros :

fp font_manager.FontPropertieso stropathlib.Path

Si es un str, se interpreta como un patrón fontconfig analizado por FontProperties. Si es pathlib.Path, se interpreta como la ruta absoluta a un archivo de fuente.

set_fontsize ( tamaño de fuente )

Establezca el tamaño de fuente.

Parámetros :

tamaño de fuente flotante o {'xx-pequeño', 'x-pequeño', 'pequeño', 'mediano', 'grande', 'x-grande', 'xx-grande'}

Si es flotante, el tamaño de fuente en puntos. Los valores de cadena indican tamaños relativos al tamaño de fuente predeterminado.

Ver también

font_manager.FontProperties.set_size

set_fontstretch ( estiramiento )

Establezca el estiramiento de la fuente (condensación o expansión horizontal).

Parámetros :

estirar {un valor numérico en el rango 0-1000, 'ultra-condensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra- expandido', 'ultra-expandido'}

Ver también

font_manager.FontProperties.set_stretch

set_fontstyle ( estilo de fuente )

Establezca el estilo de fuente.

Parámetros :

estilo de fuente {'normal', 'cursiva', 'oblicua'}

Ver también

font_manager.FontProperties.set_style

set_fontvariant ( variante )

Establezca la variante de fuente.

Parámetros :

variante {'normal', 'pequeña capitalización'}

Ver también

font_manager.FontProperties.set_variant

set_fontweight ( peso )

Establezca el peso de la fuente.

Parámetros :

peso {un valor numérico en el rango 0-1000, 'ultraligero', 'ligero', 'normal', 'regular', 'libro', 'medio', 'romano', 'semibold', 'demibold', 'demi' , 'negrita', 'pesada', 'muy negrita', 'negra'}

Ver también

font_manager.FontProperties.set_weight

set_ha ( alinear )

Alias ​​para set_horizontalalignment.

set_horizontalalignment ( alinear )

Establezca la alineación horizontal en relación con el punto de anclaje.

Véase también Alineación de texto .

Parámetros :

alinear {'izquierda', 'centro', 'derecha'}

set_linespacing ( espaciado )

Establezca el espacio entre líneas como un múltiplo del tamaño de fuente.

El interlineado predeterminado es 1,2.

Parámetros :

espaciado flotante (múltiplo del tamaño de fuente)

set_ma ( alinear )

Alias ​​para set_multialignment.

set_math_fontfamily ( familia de fuentes )

Configure la familia de fuentes para el texto matemático representado por Matplotlib.

Esto solo afecta al renderizador matemático propio de Matplotlib. No tiene efecto al renderizar con TeX ( usetex=True).

Parámetros :

familia de fuentes str

El nombre de la familia de fuentes.

Las familias de fuentes disponibles se definen en el archivo matplotlibrc.template .

Ver también

get_math_fontfamily

set_multialignment ( alinear )

Establezca la alineación del texto para textos de varias líneas.

El diseño del cuadro delimitador de todas las líneas está determinado por las propiedades horizontalalignment y verticalalignment. Esta propiedad controla la alineación de las líneas de texto dentro de ese cuadro.

Parámetros :

alinear {'izquierda', 'derecha', 'centro'}

set_name ( nombre de la fuente )

Alias ​​para set_fontname.

set_parse_math ( parse_math )

Anule el interruptor para deshabilitar cualquier análisis de texto matemático para este archivo Text.

Parámetros :

parse_math bool

Si es False, esto Textnunca usará texto matemático. Si es Verdadero, se usará texto matemático si hay un número par de signos de dólar sin escape.

set_position ( xy )

Establezca la posición ( x , y ) del texto.

Parámetros :

xy (flotante, flotante)

set_rotation ( s )

Establece la rotación del texto.

Parámetros :

s flotante o {'vertical', 'horizontal'}

El ángulo de rotación en grados en dirección matemáticamente positiva (en sentido antihorario). 'horizontal' es igual a 0, 'vertical' es igual a 90.

set_rotation_mode ( m )

Establecer el modo de rotación de texto.

Parámetros :

m {Ninguno, 'predeterminado', 'ancla'}

Si Noneo "default", el texto se rotará primero y luego se alineará de acuerdo con sus alineaciones horizontales y verticales. Si "anchor", entonces la alineación ocurre antes de la rotación.

set_size ( tamaño de fuente )

Alias ​​para set_fontsize.

set_stretch ( estiramiento )

Alias ​​para set_fontstretch.

set_style ( estilo de fuente )

Alias ​​para set_fontstyle.

set_text ( s )

Establezca la cadena de texto s .

Puede contener saltos de línea ( \n) o matemáticas en la sintaxis de LaTeX.

Parámetros :

objeto _

Cualquier objeto se convierte a su strrepresentación, excepto el Noneque se convierte en una cadena vacía.

set_transform_rotates_text ( t )

Si las rotaciones de la transformación afectan la dirección del texto.

Parámetros :

t bool

set_usetex ( usetex )

Parámetros :

usetex bool o Ninguno

Ya sea para renderizar usando TeX, Nonesignifica usar rcParams["text.usetex"](predeterminado: False).

set_va ( alinear )

Alias ​​para set_verticalalignment.

set_variant ( variante )

Alias ​​para set_fontvariant.

set_verticalalignment ( alinear )

Establezca la alineación vertical en relación con el punto de anclaje.

Véase también Alineación de texto .

Parámetros :

alinear {'abajo', 'línea base', 'centro', 'línea_base_central', 'arriba'}

set_weight ( peso )

Alias ​​para set_fontweight.

set_wrap ( envolver )

Establezca si el texto se puede ajustar.

Parámetros :

envoltura bool

notas

Wrapping no funciona junto con (que también se usa internamente en IPython/Jupyter). La configuración 'ajustada' vuelve a escalar el lienzo para acomodar todo el contenido y ocurre antes de envolver.savefig(..., bbox_inches='tight')%matplotlib inline

set_x ( x )

Establezca la posición x del texto.

Parámetros :

x flotador

set_y ( y )

Establezca la posición y del texto.

Parámetros :

flotas _

actualización ( kwargs )

Actualice las propiedades de este artista desde los accesorios de dictado .

Parámetros :

dictado de accesorios

update_bbox_position_size ( procesador )

Actualice la ubicación y el tamaño del bbox.

Este método debe usarse cuando la posición y el tamaño del bbox deben actualizarse antes de dibujar el bbox.

update_from ( otro )

Copie las propiedades de otro a uno mismo .

orden = 3

clase matplotlib.text. Anotación ( texto , xy , xytext = Ninguno , xycoords = 'datos' , textcoords = Ninguno , arrowprops = Ninguno , annotation_clip = Ninguno , ** kwargs )

Bases: Text,_AnnotationBase

An Annotationes un Textque puede referirse a una posición específica xy . Opcionalmente , se puede dibujar una flecha que apunte desde el texto a xy .

Atributos :

xy

La posición anotada.

xycoords

El sistema de coordenadas para xy .

flecha_parche

A FancyArrowPatchpara apuntar desde xytext a xy .

Anote el punto xy con texto text .

En la forma más simple, el texto se coloca en xy .

Opcionalmente, el texto se puede mostrar en otra posición xytext . Luego se puede agregar una flecha que apunte desde el texto al punto anotado xy definiendo flechas .

Parámetros :

cadena de texto

El texto de la anotación.

xy (flotante, flotante)

El punto (x, y) para anotar. El sistema de coordenadas está determinado por xycoords .

xytext (flotante, flotante), por defecto: xy

La posición (x, y) para colocar el texto. El sistema de coordenadas está determinado por textcoords .

xycoords str o Artisto Transformo invocable o (flotante, flotante), predeterminado: 'datos'

El sistema de coordenadas en el que se proporciona xy . Se admiten los siguientes tipos de valores:

• Una de las siguientes cadenas:

  Valor	Descripción
  'puntos de figura'	Puntos desde la parte inferior izquierda de la figura.
  'píxeles de figura'	Píxeles de la parte inferior izquierda de la figura
  'fracción de figura'	Fracción de la figura desde abajo a la izquierda
  'puntos de subfigura'	Puntos de la parte inferior izquierda de la subfigura
  'píxeles de subfigura'	Píxeles de la parte inferior izquierda de la subfigura
  'fracción de subfigura'	Fracción de subfigura de abajo a la izquierda
  'puntos de ejes'	Puntos de la esquina inferior izquierda de los ejes
  'píxeles de ejes'	Píxeles de la esquina inferior izquierda de los ejes
  'fracción de ejes'	Fracción de ejes desde abajo a la izquierda
  'datos'	Usar el sistema de coordenadas del objeto que se está anotando (predeterminado)
  'polar'	(theta, r) ​​si no son coordenadas nativas de 'datos'

  Tenga en cuenta que los 'píxeles de la subfigura' y los 'píxeles de la figura' son los mismos para la figura principal, por lo que los usuarios que deseen un código que se pueda usar en una subfigura pueden usar 'píxeles de la subfigura'.

• An Artist: xy se interpreta como una fracción de la del artista Bbox. Por ejemplo , (0, 0) sería la esquina inferior izquierda del cuadro delimitador y (0.5, 1) sería la parte superior central del cuadro delimitador.

• A Transformpara transformar xy en coordenadas de pantalla.

• Una función con una de las siguientes firmas:

  def transform(renderer) -> Bbox
  def transform(renderer) -> Transform
  

  donde renderer es una RendererBasesubclase.

  El resultado de la función se interpreta como los casos Artisty Transformanteriores.

• Una tupla (xcoords, ycoords) que especifica sistemas de coordenadas separados para x e y . xcoords e ycoords deben ser cada uno de uno de los tipos descritos anteriormente.

Consulte Anotaciones avanzadas para obtener más detalles.

textcoords str or Artistor Transformor callable or (float, float), predeterminado: valor de xycoords

El sistema de coordenadas en el que se proporciona xytext .

Todos los valores de xycoords son válidos, así como las siguientes cadenas:

Valor	Descripción
'puntos de compensación'	Compensación (en puntos) del valor xy
'píxeles compensados'	Desplazamiento (en píxeles) del valor xy

dictado de puntas de flecha , opcional

Las propiedades utilizadas para dibujar una FancyArrowPatchflecha entre las posiciones xy y xytext . El valor predeterminado es Ninguno, es decir, no se dibuja ninguna flecha.

Por razones históricas, hay dos formas diferentes de especificar flechas, "simple" y "elegante":

Flecha sencilla:

Si arrowprops no contiene la clave 'estilo de flecha', las claves permitidas son:

Llave	Descripción
ancho	El ancho de la flecha en puntos
ancho de cabeza	El ancho de la base de la punta de la flecha en puntos
largo de la cabeza	La longitud de la punta de flecha en puntos
encogerse	Fracción de la longitud total a encoger desde ambos extremos
?	Cualquier clave paramatplotlib.patches.FancyArrowPatch

La flecha se adjunta al borde del cuadro de texto, la posición exacta (esquinas o centros) depende de hacia dónde apunte.

Flecha elegante:

Esto se usa si se proporciona 'estilo de flecha' en los accesorios de flecha .

Las claves válidas son los siguientes FancyArrowPatch parámetros:

Llave	Descripción
estilo de flecha	el estilo de flecha
Estilo de conexión	el estilo de conexión
relpos	vea abajo; el valor predeterminado es (0.5, 0.5)
parcheA	el valor predeterminado es el cuadro delimitador del texto
parcheB	el valor predeterminado es Ninguno
encogerA	el valor predeterminado es 2 puntos
encogerB	el valor predeterminado es 2 puntos
mutación_escala	el valor predeterminado es el tamaño del texto (en puntos)
mutación_aspecto	el valor predeterminado es 1.
?	cualquier clave paramatplotlib.patches.PathPatch

La posición exacta del punto de inicio de la flecha está definida por relpos . Es una tupla de coordenadas relativas del cuadro de texto, donde (0, 0) es la esquina inferior izquierda y (1, 1) es la esquina superior derecha. Los valores <0 y >1 son compatibles y especifican puntos fuera del cuadro de texto. Por defecto (0.5, 0.5) el punto de inicio está centrado en el cuadro de texto.

annotation_clip bool o Ninguno, predeterminado: Ninguno

Si recortar (es decir, no dibujar) la anotación cuando el punto de anotación xy está fuera del área de los ejes.

• Si es True , la anotación se recortará cuando xy esté fuera de los ejes.

• Si es False , la anotación siempre se dibujará.

• Si es None , la anotación se recortará cuando xy esté fuera de los ejes y xycoords sea 'datos'.

**kwargs

Los kwargs adicionales se pasan a Text.

Devoluciones :

Annotation

Ver también

Anotaciones avanzadas

anuncios de propiedad

El sistema de coordenadas a usar para Annotation.xyann.

contiene ( evento )

Devuelve si el evento del mouse ocurrió dentro del cuadro delimitador alineado con el eje del texto.

dibujar ( procesador )

Dibuja al Artista (y sus hijos) usando el renderizador dado.

Esto no tiene efecto si el artista no está visible ( Artist.get_visible devuelve Falso).

Parámetros :

subclase de renderizador .RendererBase

notas

Este método se anula en las subclases de artista.

get_anncoords ( )

Devuelve el sistema de coordenadas a usar para Annotation.xyann.

Véase también xycoords en Annotation.

get_tightbbox ( procesador = Ninguno )

Me gusta Artist.get_window_extent, pero incluye cualquier recorte.

Parámetros :

subclase de renderizadorRendererBase

renderizador que se usará para dibujar las figuras (es decir, fig.canvas.get_renderer())

Devoluciones :

Bbox

El cuadro delimitador envolvente (en las coordenadas de píxeles de la figura).

get_window_extent ( procesador = Ninguno )

Devuelve el Bboxlímite del texto, en unidades de visualización.

Además de usarse internamente, esto es útil para especificar regiones en las que se puede hacer clic en un archivo png en una página web.

Parámetros :

renderizador Renderizador, opcional

Se necesita un renderizador para calcular el cuadro delimitador. Si el artista ya ha sido dibujado, el renderizador se almacena en caché; por lo tanto, solo es necesario pasar este argumento al llamar get_window_extent antes del primer sorteo. En la práctica, normalmente es más fácil activar un proyecto primero, por ejemplo, igualando draw_without_renderingo plt.show().

flotante de ppp , opcional

El valor de ppp para calcular el bbox, por defecto es self.figure.dpi( no el renderizador de ppp); debe configurarse, por ejemplo, para hacer coincidir regiones con una figura guardada con un valor de dpi personalizado.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation =<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> , fuentevariante=<DESCONFIGURAR> , fontweight=<DESCONFIGURAR>, gid=<UNSET> , horizontalalignment=<UNSET> , in_layout=<UNSET> , label=<UNSET> , linesping=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math =<DESCONFIGURACIÓN> , path_effects=<DESCONFIGURACIÓN> , picker=<DESCONFIGURACIÓN> , posición=<DESCONFIGURACIÓN> , rasterizado=<DESCONFIGURACIÓN> , rotación=<DESCONFIGURACIÓN>, modo_rotación = <DESCONFIGURACIÓN> , sketch_params=<DESCONFIGURACIÓN> , snap=< DESCONFIGURAR> ,texto=<DESCONFIGURADO> ,transform=<UNSET> , transform_rotates_text=<UNSET> , url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y= <UNSET> , zorder=<UNSET> )

Establece varias propiedades a la vez.

Las propiedades admitidas son

Propiedad	Descripción
agg_filter	una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
alpha	escalar o ninguno
animated	bool
anncoords	desconocido
annotation_clip	booleano o ninguno
backgroundcolor	color
bbox	dict con propiedades parapatches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Parchear o (Ruta, Transformar) o Ninguno
coloro c	color
figure	desconocido
fontfamilyo familia	{FONTNAME, 'serif', 'sans-serif', 'cursiva', 'fantasía', 'monoespacio'}
fontpropertieso fuente o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo tamaño	float o {'xx-pequeño', 'x-pequeño', 'pequeño', 'mediano', 'grande', 'x-grande', 'xx-grande'}
fontstretcho estirar	{un valor numérico en el rango 0-1000, 'ultracondensado', 'extra-condensado', 'condensado', 'semi-condensado', 'normal', 'semi-expandido', 'expandido', 'extra-expandido ', 'ultra-expandido'}
fontstyleo estilo	{'normal', 'cursiva', 'oblicua'}
fontvarianto variante	{'normal', 'pequeñas capitalizaciones'}
fontweighto peso	{un valor numérico en el rango 0-1000, 'ultraligero', 'ligero', 'normal', 'regular', 'libro', 'medio', 'romano', 'semibold', 'demibold', 'demi', 'negrita', 'pesada', 'extra negrita', 'negra'}
gid	calle
horizontalalignmento ja	{'izquierda centro derecha'}
in_layout	bool
label	objeto
linespacing	float (múltiplo del tamaño de fuente)
math_fontfamily	calle
mouseover	bool
multialignmento mamá	{'izquierda', 'derecha', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Ninguno o bool o flotante o invocable
position	(flotar, flotar)
rasterized	bool
rotation	flotante o {'vertical', 'horizontal'}
rotation_mode	{Ninguno, 'predeterminado', 'ancla'}
sketch_params	(escala: flotante, longitud: flotante, aleatoriedad: flotante)
snap	booleano o ninguno
text	objeto
transform	Transform
transform_rotates_text	bool
url	calle
usetex	booleano o ninguno
verticalalignmento va	{'abajo', 'línea base', 'centro', 'línea_base_central', 'arriba'}
visible	bool
wrap	bool
x	flotar
y	flotar
zorder	flotar

set_anncoords ( coords )

Establezca el sistema de coordenadas que se usará para Annotation.xyann.

Véase también xycoords en Annotation.

set_figure ( figura )

Establezca la Figureinstancia a la que pertenece el artista.

Parámetros :

higoFigure

update_positions ( procesador )

Actualice las posiciones de píxeles del texto de la anotación y el parche de flecha.

propiedad xyann

La posición del texto.

Véase también xytext en Annotation.

propiedad xycoords

clase matplotlib.text. OffsetFrom ( artista , ref_coord , unidad = 'puntos' )

Bases:object

Clase auxiliar a la que se puede llamar para trabajar con Annotation.

Parámetros :

artista Artisto BboxBaseoTransform

El objeto desde el que calcular el desplazamiento.

ref_coord (flotante, flotante)

Si el artista es un Artisto BboxBase, este valor es la ubicación hasta el origen del desplazamiento en fracciones del cuadro delimitador del artista .

Si el artista es una transformación, el origen del desplazamiento es la transformación aplicada a este valor.

unidad {'puntos, 'píxeles'}, por defecto: 'puntos'

Las unidades de pantalla que se utilizarán (píxeles o puntos) para la entrada de compensación.

get_unit ( )

Devuelve la unidad de entrada a la transformación utilizada por __call__.

set_unit ( unidad )

Establezca la unidad de entrada en la transformación utilizada por __call__.

Parámetros :

unidad {'puntos', 'pixeles'}