matplotlib.axes.Axes.annotate #

Achsen. annotate ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs ) [source] #

Beschriften Sie den Punkt xy mit Text text .

In der einfachsten Form wird der Text bei xy platziert .

Optional kann der Text an einer anderen Position xytext angezeigt werden . Ein Pfeil, der vom Text zum annotierten Punkt xy zeigt, kann dann durch die Definition von Pfeilstützen hinzugefügt werden .

Parameter :

Textstr _

Der Text der Anmerkung.

xy (schweben, schweben)

Der zu beschriftende Punkt (x, y) . Das Koordinatensystem wird durch xycoords bestimmt .

xytext (float, float), Standard: xy

Die Position (x, y) , an der der Text platziert werden soll. Das Koordinatensystem wird durch textcoords bestimmt .

xycoords str oder Artistoder Transformoder aufrufbares oder (float, float), Standard: 'data'

Das Koordinatensystem, in dem xy angegeben ist. Die folgenden Arten von Werten werden unterstützt:

Eine der folgenden Zeichenfolgen:

Wert	Beschreibung
'Figurenpunkte'	Punkte von unten links in der Abbildung
'Zahl Pixel'	Pixel von der unteren linken Seite der Abbildung
'Zahlenbruch'	Bruchteil der Abbildung von unten links
'Punkte subfigurieren'	Punkte von links unten in der Teilfigur
'subfigure pixel'	Pixel von der unteren linken Seite der Teilfigur
'subfigur Bruch'	Bruchteil der Unterfigur von unten links
'Achsenpunkte'	Punkte von der unteren linken Ecke der Achsen
'Achsen Pixel'	Pixel von der unteren linken Ecke der Achsen
'Achsenbruch'	Bruchteil der Achsen von unten links
'Daten'	Koordinatensystem des beschrifteten Objekts verwenden (Standard)
'Polar'	(theta, r) wenn nicht native 'Daten'-Koordinaten

Beachten Sie, dass „Subfigure-Pixel“ und „Figuren-Pixel“ für die übergeordnete Figur identisch sind, sodass Benutzer, die Code wünschen, der in einer Subfigur verwendbar ist, „Subfigure-Pixel“ verwenden können.

Ein Artist: xy wird als Bruchteil des Künstlers interpretiert Bbox. Beispiel : (0, 0) wäre die untere linke Ecke des Begrenzungsrahmens und (0,5, 1) wäre die obere Mitte des Begrenzungsrahmens.
A , um xy in Bildschirmkoordinaten Transformumzuwandeln .
Eine Funktion mit einer der folgenden Signaturen:
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
wobei renderer eine RendererBaseUnterklasse ist.

Das Ergebnis der Funktion wird wie die Fälle Artistund oben interpretiert.Transform
Ein Tupel (xcoords, ycoords) , das separate Koordinatensysteme für x und y angibt . xcoords und ycoords müssen jeweils einem der oben beschriebenen Typen angehören.

Weitere Einzelheiten finden Sie unter Erweiterte Anmerkungen .

textcoords str or Artistor Transformor aufrufbares or (float, float), default: Wert von xycoords

Das Koordinatensystem, in dem xytext angegeben ist.

Alle xycoords- Werte sowie die folgenden Zeichenfolgen sind gültig:

Wert	Beschreibung
'Offset-Punkte'	Versatz (in Punkten) vom xy- Wert
'Pixel versetzen'	Versatz (in Pixel) vom xy- Wert

arrowprops dict, optional

Die Eigenschaften, die verwendet werden, um einen FancyArrowPatchPfeil zwischen den Positionen xy und xytext zu zeichnen . Der Standardwert ist None, dh es wird kein Pfeil gezeichnet.

Aus historischen Gründen gibt es zwei verschiedene Möglichkeiten, Pfeile zu spezifizieren, "einfach" und "ausgefallen":

Einfacher Pfeil:

Wenn arrowprops den Schlüssel 'arrowstyle' nicht enthält, sind die zulässigen Schlüssel:

Taste	Beschreibung
Breite	Die Breite des Pfeils in Punkt
Kopfbreite	Die Breite der Basis der Pfeilspitze in Punkten
Kopflänge	Die Länge der Pfeilspitze in Punkten
schrumpfen	Bruchteil der Gesamtlänge, der von beiden Enden zu schrumpfen ist
?	Jeder Schlüssel zu`matplotlib.patches.FancyArrowPatch`

Der Pfeil ist am Rand des Textfelds angebracht, die genaue Position (Ecken oder Mitten) hängt davon ab, wohin er zeigt.

Ausgefallener Pfeil:

Dies wird verwendet, wenn 'arrowstyle' in den arrowprops angegeben ist .

Gültige Schlüssel sind die folgenden FancyArrowPatch Parameter:

Taste	Beschreibung
Pfeilstil	der Pfeilstil
Verbindungsstil	der Verbindungsstil
Relationen	siehe unten; Standard ist (0,5, 0,5)
patchA	Standard ist der Begrenzungsrahmen des Textes
patchB	Standard ist Keine
schrumpfenA	Standard ist 2 Punkte
schrumpfenB	Standard ist 2 Punkte
mutation_scale	Standard ist Textgröße (in Punkt)
mutation_aspekt	Standard ist 1.
?	jede Taste für`matplotlib.patches.PathPatch`

Die genaue Startpunktposition des Pfeils wird durch relpos definiert . Es ist ein Tupel relativer Koordinaten des Textfelds, wobei (0, 0) die untere linke Ecke und (1, 1) die obere rechte Ecke ist. Werte <0 und >1 werden unterstützt und geben Punkte außerhalb des Textfelds an. Standardmäßig (0.5, 0.5) ist der Startpunkt im Textfeld zentriert.

annotation_clip bool oder None, Standard: None

Ob die Anmerkung abgeschnitten (dh nicht gezeichnet) werden soll, wenn der Anmerkungspunkt xy außerhalb des Achsenbereichs liegt.

Bei True wird die Anmerkung abgeschnitten, wenn xy außerhalb der Achsen liegt.
Bei False wird die Anmerkung immer gezeichnet.
Bei None wird die Anmerkung abgeschnitten, wenn xy außerhalb der Achsen liegt und xycoords „data“ ist.

**Kwarg