matplotlib.pyplot.annotate

matplotlib.pyplot. annotate ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs )

Annotez le point xy avec du texte text .

Dans la forme la plus simple, le texte est placé à xy .

En option, le texte peut être affiché dans une autre position xytext . Une flèche pointant du texte vers le point annoté xy peut alors être ajoutée en définissant arrowprops .

Paramètres :

chaîne de texte

Le texte de l'annotation.

xy (flottant, flottant)

Le point (x, y) à annoter. Le système de coordonnées est déterminé par xycoords .

xytext (float, float), par défaut : xy

La position (x, y) à laquelle placer le texte. Le système de coordonnées est déterminé par textcoords .

xycoords str ou Artistou Transformou callable or (float, float), par défaut : 'data'

Le système de coordonnées dans lequel xy est donné. Les types de valeurs suivants sont pris en charge :

• L'une des chaînes suivantes :

  Évaluer	La description
  'points de chiffres'	Points en bas à gauche de la figure
  'chiffre pixels'	Pixels en bas à gauche de la figure
  'fraction de chiffres'	Fraction de la figure en bas à gauche
  'points de sous-figure'	Points en bas à gauche de la sous-figure
  "pixels sous-figurés"	Pixels en bas à gauche de la sous-figure
  'fraction de sous-figure'	Fraction de sous-figure en bas à gauche
  'points d'axes'	Points du coin inférieur gauche des axes
  'axes pixels'	Pixels du coin inférieur gauche des axes
  'fraction d'axes'	Fraction d'axes en bas à gauche
  'Les données'	Utiliser le système de coordonnées de l'objet annoté (par défaut)
  'polaire'	(thêta, r) ​​s'il ne s'agit pas de coordonnées de "données" natives

  Notez que les « pixels de sous-figure » ​​et les « pixels de la figure » ​​sont les mêmes pour la figure parente, de sorte que les utilisateurs qui souhaitent un code utilisable dans une sous-figure peuvent utiliser des « pixels de sous-figure ».

• Un Artist: xy est interprété comme une fraction du Bbox. Par exemple (0, 0) serait le coin inférieur gauche de la boîte englobante et (0,5, 1) serait le centre supérieur de la boîte englobante.

• A Transformpour transformer xy en coordonnées d'écran.

• Une fonction avec l'une des signatures suivantes :

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

  où renderer est une sous- RendererBaseclasse.

  Le résultat de la fonction est interprété comme les cas Artistet Transformci-dessus.

• Un tuple (xcoords, ycoords) spécifiant des systèmes de coordonnées séparés pour x et y . xcoords et ycoords doivent chacun appartenir à l'un des types décrits ci-dessus.

Voir Annotations avancées pour plus de détails.

textcoords str or Artistor Transformor callable or (float, float), par défaut : valeur de xycoords

Le système de coordonnées dans lequel xytext est donné.

Toutes les valeurs xycoords sont valides ainsi que les chaînes suivantes :

Évaluer	La description
'points de décalage'	Décalage (en points) de la valeur xy
'pixels décalés'	Décalage (en pixels) de la valeur xy

arrowprops dict, facultatif

Les propriétés utilisées pour dessiner une FancyArrowPatchflèche entre les positions xy et xytext . La valeur par défaut est Aucune, c'est-à-dire qu'aucune flèche n'est dessinée.

Pour des raisons historiques, il existe deux manières différentes de spécifier les flèches, "simple" et "fantaisie":

Flèche simple :

Si arrowprops ne contient pas la clé 'arrowstyle', les clés autorisées sont :

Clé	La description
largeur	La largeur de la flèche en points
largeur de tête	La largeur de la base de la tête de flèche en points
longueur de tête	La longueur de la tête de flèche en points
rétrécir	Fraction de la longueur totale à rétrécir des deux extrémités
?	N'importe quelle clé pourmatplotlib.patches.FancyArrowPatch

La flèche est attachée au bord de la zone de texte, la position exacte (coins ou centres) selon l'endroit où elle pointe.

Flèche fantaisie :

Ceci est utilisé si 'arrowstyle' est fourni dans le arrowprops .

Les clés valides sont les FancyArrowPatch paramètres suivants :

Clé	La description
style de flèche	le style flèche
style de connexion	le style de connexion
repos	voir ci-dessous; la valeur par défaut est (0,5, 0,5)
patchA	la valeur par défaut est le cadre de délimitation du texte
patchB	la valeur par défaut est Aucune
rétrécirA	la valeur par défaut est de 2 points
rétrécirB	la valeur par défaut est de 2 points
mutation_scale	la valeur par défaut est la taille du texte (en points)
mutation_aspect	la valeur par défaut est 1.
?	n'importe quelle clé pourmatplotlib.patches.PathPatch

La position exacte du point de départ de la flèche est définie par relpos . C'est un tuple de coordonnées relatives de la zone de texte, où (0, 0) est le coin inférieur gauche et (1, 1) est le coin supérieur droit. Les valeurs <0 et >1 sont prises en charge et spécifient des points en dehors de la zone de texte. Par défaut (0.5, 0.5) le point de départ est centré dans la zone de texte.

annotation_clip booléen ou Aucun, par défaut : Aucun

S'il faut découper (c'est-à-dire ne pas dessiner) l'annotation lorsque le point d'annotation xy est en dehors de la zone des axes.

• Si True , l'annotation sera coupée lorsque xy est en dehors des axes.

• Si False , l'annotation sera toujours dessinée.

• Si None , l'annotation sera coupée lorsque xy est en dehors des axes et que xycoords est 'data'.

**kwargs

Des kwargs supplémentaires sont transmis à Text.

Retours :

Annotation

Voir également

Annotations avancées

Exemples utilisant matplotlib.pyplot.annotate

Tutoriel Pyplot

Tutoriel Pyplot

Remarques

Remarques