matplotlib.pyplot.anotar #
- matplotlib.pyplot. anotar ( texto , xy , xytext = Ninguno , xycoords = 'datos' , textcoords = Ninguno , arrowprops = Ninguno , annotation_clip = Ninguno , ** kwargs ) [fuente] #
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
ArtistoTransformo 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 artistaBbox. 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
ArtistyTransformanteriores.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
ArtistorTransformor 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 para
matplotlib.patches.FancyArrowPatchLa 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
FancyArrowPatchpará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 para
matplotlib.patches.PathPatchLa 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 :
Ver también
