matplotlib.inset

Das Modul `inset` definiert die Klasse `InsetIndicator`, die das Rechteck und die Verbinder zeichnet, die für Axes.indicate_inset und Axes.indicate_inset_zoom benötigt werden.

class matplotlib.inset.InsetIndicator(bounds=None, inset_ax=None, zorder=None, =**kwargs)

Bases: Artist

Ein Künstlerobjekt zur Hervorhebung eines Interessensbereichs.

Ein Inset-Indikator ist ein Rechteck auf dem Plot an der von `bounds` angegebenen Position, das optional Linien hat, die das Rechteck mit einer Inset-Achse (Axes.inset_axes) verbinden.

Hinzugefügt in Version 3.10.

Parameter:

bounds[x0, y0, width, height], optional

Linke untere Ecke des zu markierenden Rechtecks sowie dessen Breite und Höhe. Wenn nicht gesetzt, werden die Grenzen aus den Datenlimits von `inset_ax` berechnet, das angegeben werden muss.

inset_axAxes, optional

Eine optionale Inset-Achse, zu der Verbindungslinien gezeichnet werden. Zwei Linien werden gezeichnet, die die Indikatorbox mit der Inset-Achse an Ecken verbinden, die so gewählt werden, dass sie nicht mit der Indikatorbox überlappen.

zorderfloat, Standard: 4.99

Zeichenreihenfolge des Rechtecks und der Verbindungslinien. Der Standardwert 4,99 liegt knapp unterhalb des Standard-Z-Orders von Inset-Achsen.

**kwargs

Andere Schlüsselwortargumente werden an das `Rectangle`-Patch weitergegeben.

property connectors

4-Tupel von `patches.ConnectionPatch` oder None

Die vier Verbindungslinien, die zu den (untere linke, obere linke, untere rechte, obere rechte) Ecken von inset_ax führen. Zwei Linien sind auf Sichtbarkeit auf False gesetzt, aber der Benutzer kann die Sichtbarkeit auf True setzen, wenn die automatische Wahl nicht als korrekt erachtet wird.

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.

property rectangle

Rectangle: Der Indikatorrahmen.

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, gid=<UNSET>, in_layout=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, path_effects=<UNSET>, picker=<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	unknown
animated	bool
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
color	color
Randfarbe (edgecolor)	Farbe oder None
figure	Figure oder SubFigure
gid	str
in_layout	bool
label	object
Linienstil (linestyle)	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
Linienbreite (linewidth)	float oder None
mouseover	bool
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
visible	bool
zorder	float

set_alpha(alpha)

Legt den für die Mischung verwendeten Alpha-Wert fest - wird nicht von allen Backends unterstützt.

Parameter:

alphafloat oder None

alpha muss im Bereich von 0 bis 1, einschließlich, liegen.

set_color(c)

Setzt die Randfarbe des Rechtecks und der Verbinder sowie die Füllfarbe für das Rechteck.

Parameter:

cFarbe

set_edgecolor(color)

Setzt die Randfarbe des Rechtecks und der Verbinder.

Parameter:

colorFarbe oder None

set_linestyle(ls)

Setzt den Linienstil des Rechtecks und der Verbinder.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie
'none', 'None', ' ', oder ''	Zeichne nichts

Alternativ kann ein Strich-Tupel der folgenden Form angegeben werden

(offset, onoffseq)

wobei onoffseq ein Tupel mit gerader Länge von Ein- und Aus-Tinte in Punkten ist.

Parameter:

ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}

Der Linienstil.

set_linewidth(w)

Setzt die Liniendicke in Punkten des Rechtecks und der Verbinder.

Parameter:

wfloat oder None

zorder = 4.99