matplotlib.patches.ConnectionPatch

class matplotlib.patches.ConnectionPatch(xyA, xyB, coordsA, coordsB=None, *, axesA=None, axesB=None, arrowstyle='-', connectionstyle='arc3', patchA=None, patchB=None, shrinkA=0.0, shrinkB=0.0, mutation_scale=10.0, mutation_aspect=None, clip_on=False, **kwargs)

Basisklassen: FancyArrowPatch

Ein Patch, der zwei Punkte (möglicherweise in verschiedenen Achsen) verbindet.

Verbindet Punkt xyA in coordsA mit Punkt xyB in coordsB.

Gültige Schlüssel sind

Schlüssel	Beschreibung
arrowstyle	der Pfeilstil
connectionstyle	der Verbindungsstil
relpos	Standard ist (0.5, 0.5)
patchA	Standard ist die Bounding Box des Textes
patchB	Standard ist None
shrinkA	Standard sind 2 Punkte
shrinkB	Standard sind 2 Punkte
mutation_scale	Standard ist Textgröße (in Punkten)
mutation_aspect	Standard ist 1.
?	beliebiger Schlüssel für matplotlib.patches.PathPatch

coordsA und coordsB sind Zeichenketten, die die Koordinaten von xyA und xyB angeben.

Eigenschaft	Beschreibung
'figure points'	Punkte von der unteren linken Ecke der Abbildung
'figure pixels'	Pixel von der unteren linken Ecke der Abbildung
'figure fraction'	0, 0 ist unten links in der Abbildung und 1, 1 ist oben rechts
'subfigure points'	Punkte von der unteren linken Ecke der Unterabbildung
'subfigure pixels'	Pixel von der unteren linken Ecke der Unterabbildung
'subfigure fraction'	Anteil der Unterabbildung, 0, 0 ist unten links.
'axes points'	Punkte von der unteren linken Ecke der Achsen
'axes pixels'	Pixel von der unteren linken Ecke der Achsen
'axes fraction'	0, 0 ist unten links in den Achsen und 1, 1 ist oben rechts
'data'	verwendet das Koordinatensystem des zu annotierenden Objekts (Standard)
'offset points'	Offset (in Punkten) vom xy-Wert
'polar'	Sie können theta, r für die Annotation angeben, auch in kartesischen Plots. Beachten Sie, dass Sie bei Verwendung einer polaren Achse keine polaren Angaben für das Koordinatensystem machen müssen, da dies das native "Daten"-Koordinatensystem ist.

Alternativ können diese auf eine beliebige gültige Transform gesetzt werden.

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.

Hinweis

Die Verwendung von ConnectionPatch über zwei Axes-Instanzen ist nicht direkt mit Constrained Layout kompatibel. Fügen Sie den Künstler direkt zur Figure hinzu, anstatt ihn zu einer bestimmten Achse hinzuzufügen, oder schließen Sie ihn vom Layout aus, indem Sie con.set_in_layout(False) verwenden.

fig, ax = plt.subplots(1, 2, constrained_layout=True)
con = ConnectionPatch(..., axesA=ax[0], axesB=ax[1])
fig.add_artist(con)

draw(renderer)

Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.

Dies hat keine Auswirkung, wenn der Künstler nicht sichtbar ist (Artist.get_visible gibt False zurück).

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

get_annotation_clip()

Gibt das Clipping-Verhalten zurück.

Siehe set_annotation_clip für die Bedeutung des Rückgabewerts.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, annotation_clip=<UNSET>, antialiased=<UNSET>, arrowstyle=<UNSET>, capstyle=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, connectionstyle=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, fill=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, mutation_aspect=<UNSET>, mutation_scale=<UNSET>, patchA=<UNSET>, patchB=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, positions=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, visible=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	float oder None
animated	bool
annotation_clip	bool oder None
antialiased oder aa	bool oder None
arrowstyle	[ '-' | '<-' | '->' | '<->' | '<|-' | '-|>' | '<|-|>' | ']-' | '-[' | ']-[' | '|-|' | ']->' | '<-[' | 'simple' | 'fancy' | 'wedge' ]
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
connectionstyle	[ 'arc3' | 'angle3' | 'angle' | 'arc' | 'bar' ]
edgecolor oder ec	Farbe oder None
facecolor oder fc	Farbe oder None
figure	Figure oder SubFigure
füllen	bool
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth oder lw	float oder None
mouseover	bool
mutation_aspect	float
mutation_scale	float
patchA	patches.Patch
patchB	patches.Patch
path_effects	Liste von AbstractPathEffect
picker	None oder bool oder float oder callable
positions	unknown
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_annotation_clip(b)

Legt das Clipping-Verhalten der Annotation fest.

Parameter:

bbool oder None

• True: Die Annotation wird geclippt, wenn self.xy außerhalb der Achsen liegt.

• False: Die Annotation wird immer gezeichnet.

• None: Die Annotation wird geclippt, wenn self.xy außerhalb der Achsen liegt und self.xycoords == "data".

Beispiele für die Verwendung von matplotlib.patches.ConnectionPatch

Animation mehrerer Achsen

Animation mehrerer Achsen

Balken eines Kreises

Balken eines Kreises

Leitfaden für eingeschränkte Layouts

Leitfaden für eingeschränkte Layouts

Annotationen

Annotationen