matplotlib.pyplot.annotate #

matplotlib.pyplot. 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 zumatplotlib.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ürmatplotlib.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

Zusätzliche kwargs werden an übergeben Text.

Rückgaben :
Annotation

Siehe auch

Erweiterte Anmerkungen

Beispiele mit matplotlib.pyplot.annotate#

Pyplot-Tutorial

Pyplot-Tutorial

Pyplot-Tutorial
Anmerkungen

Anmerkungen

Anmerkungen