matplotlib.pyplot.annotate#

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

Annotiert den Punkt xy mit dem Text text.

In der einfachsten Form wird der Text an 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 Definition von arrowprops hinzugefügt werden.

Parameter:

textstr

Der Text der Anmerkung.

xy(float, float)

Der Punkt (x, y), der annotiert werden soll. Das Koordinatensystem wird durch xycoords bestimmt.

xytext(float, float), default: xy

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

xycoordsString oder Tupel aus Strings oder Artist oder Transform oder callable, Standard: 'data'

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

Einer der folgenden Strings

Wert	Beschreibung
'figure points'	Punkte vom linken unteren Rand der Abbildung
'figure pixels'	Pixel vom linken unteren Rand der Abbildung
'figure fraction'	Anteil der Abbildung vom linken unteren Rand
'subfigure points'	Punkte vom linken unteren Rand der Teilabbildung
'subfigure pixels'	Pixel vom linken unteren Rand der Teilabbildung
'subfigure fraction'	Anteil der Teilabbildung vom linken unteren Rand
'axes points'	Punkte vom linken unteren Rand der Achsen
'axes pixels'	Pixel vom linken unteren Rand der Achsen
'axes fraction'	Anteil der Achsen vom linken unteren Rand
'data'	Verwendet das Koordinatensystem des zu annotierenden Objekts (Standard)
'polar'	(theta, r), wenn nicht native 'data'-Koordinaten

Beachten Sie, dass 'subfigure pixels' und 'figure pixels' für die übergeordnete Abbildung identisch sind. Benutzer, die Code wünschen, der in einer Teilabbildung verwendbar ist, können daher 'subfigure pixels' verwenden.

Ein Artist: xy wird als Bruchteil der Bbox des Künstlers interpretiert. Z.B. wäre (0, 0) die untere linke Ecke der Bounding Box und (0.5, 1) wäre die obere Mitte der Bounding Box.
Eine Transform, um xy in Bildschirmkoordinaten zu transformieren.
Eine Funktion mit einer der folgenden Signaturen
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
wobei renderer eine Unterklasse von RendererBase ist.

Das Ergebnis der Funktion wird wie bei den Fällen Artist und Transform oben interpretiert.
Ein Tupel (xcoords, ycoords), das getrennte Koordinatensysteme für x und y spezifiziert. xcoords und ycoords müssen jeweils von einem der oben beschriebenen Typen sein.

Weitere Details finden Sie unter Erweiterte Annotation.

textcoordsString oder Tupel aus Strings oder Artist oder Transform oder callable, Standard: Wert von xycoords

Das Koordinatensystem, in dem xytext angegeben ist.

Alle xycoords-Werte sind gültig, ebenso wie die folgenden Strings

Wert	Beschreibung
'offset points'	Offset, in Punkten, vom xy-Wert
'offset pixels'	Offset, in Pixeln, vom xy-Wert
'offset fontsize'	Offset, relativ zur Schriftgröße, vom xy-Wert

arrowpropsdict, optional

Die Eigenschaften, die zum Zeichnen eines Pfeils vom Typ FancyArrowPatch zwischen den Positionen xy und xytext verwendet werden. Standard ist None, d.h. es wird kein Pfeil gezeichnet.

Aus historischen Gründen gibt es zwei verschiedene Möglichkeiten, Pfeile anzugeben: "einfach" und "fancy"

Einfacher Pfeil

Wenn arrowprops nicht den Schlüssel 'arrowstyle' enthält, sind die erlaubten Schlüssel

Schlüssel	Beschreibung
width	Die Breite des Pfeils in Punkten
headwidth	Die Breite der Basis der Pfeilspitze in Punkten
headlength	Die Länge der Pfeilspitze in Punkten
shrink	Anteil der Gesamtlänge, der von beiden Enden geschrumpft wird
?	Jede Eigenschaft von `FancyArrowPatch`

Der Pfeil wird am Rand der Textbox befestigt, die genaue Position (Ecken oder Mittelpunkte) hängt davon ab, wohin er zeigt.

Fancy-Pfeil

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

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

Schlüssel	Beschreibung
arrowstyle	Der Pfeilstil
connectionstyle	Der Verbindungsstil
relpos	Siehe unten; Standard ist (0.5, 0.5)
patchA	Standard ist die Bounding Box des Textes
patchB	Standard ist None
shrinkA	In Punkten. Standard sind 2 Punkte
shrinkB	In Punkten. Standard sind 2 Punkte
mutation_scale	Standard ist Textgröße (in Punkten)
mutation_aspect	Standard ist 1
?	Jede Eigenschaft von `FancyArrowPatch`

Die exakte Startposition des Pfeils wird durch relpos definiert. Es ist ein Tupel relativer Koordinaten der Textbox, wobei (0, 0) die linke untere Ecke und (1, 1) die obere rechte Ecke ist. Werte <0 und >1 werden unterstützt und spezifizieren Punkte außerhalb der Textbox. Standardmäßig (0.5, 0.5), also ist der Startpunkt in der Mitte der Textbox.

annotation_clipbool or None, default: None

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

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

**kwargs