matplotlib.collections

Klassen für die effiziente Darstellung großer Sammlungen von Objekten, die die meisten Eigenschaften gemeinsam haben, z. B. eine große Anzahl von Liniensegmenten oder Polygonen.

Die Klassen sind nicht so flexibel wie ihre Einzelobjekt-Gegenstücke (z. B. können möglicherweise nicht alle Linienstile ausgewählt werden), aber sie sollen für gängige Anwendungsfälle (z. B. ein großer Satz von durchgezogenen Liniensegmenten) schnell sein.

class matplotlib.collections.AsteriskPolygonCollection(numsides, *, rotation=0, sizes=(1,), **kwargs)

Basen: RegularPolyCollection

Zeichnet eine Sammlung von regulären Sternen mit numsides Punkten.

Parameter:

numsidesint

Die Anzahl der Seiten des Polygons.

rotationfloat

Die Rotation des Polygons in Radiant.

sizestuple of float

Die Fläche des Kreises, der das Polygon umschreibt, in Punkte^2.

**kwargs

Weitergeleitet an Collection.

Beispiele

Siehe Lasso Demo für ein vollständiges Beispiel

offsets = np.random.rand(20, 2)
facecolors = [cm.jet(x) for x in np.random.rand(20)]

collection = RegularPolyCollection(
    numsides=5, # a pentagon
    rotation=0, sizes=(50,),
    facecolors=facecolors,
    edgecolors=("black",),
    linewidths=(1,),
    offsets=offsets,
    offset_transform=ax.transData,
    )

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die mit dem Callback assoziiert ist. Diese ID kann zum Entfernen des Callbacks mit remove_callback später verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenfolgendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_numsides()

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_rotation()

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.CircleCollection(sizes, **kwargs)

Bases: _CollectionWithSizes

Eine Sammlung von Kreisen, die mit Splines gezeichnet werden.

Parameter:

sizesfloat oder array-ähnlich

Die Fläche jedes Kreises in Punkten^2.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die zugehörige Observer-ID des Callbacks. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Wenn sie dies tun, müssen sie sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.Collection(*, edgecolors=None, facecolors=None, linewidths=None, linestyles='solid', capstyle=None, joinstyle=None, antialiaseds=None, offsets=None, offset_transform=None, norm=None, cmap=None, colorizer=None, pickradius=5.0, hatch=None, urls=None, zorder=1, **kwargs)

Bases: ColorizingArtist

Basisklasse für Collections. Muss unterklassifiziert werden, um verwendbar zu sein.

Eine Collection repräsentiert eine Sequenz von Patches, die effizienter zusammen gezeichnet werden können als einzeln. Wenn beispielsweise ein einzelner Pfad wiederholt an verschiedenen Versätzen gezeichnet wird, kann der Renderer normalerweise einen draw_marker()-Aufruf viel effizienter ausführen als eine Reihe wiederholter Aufrufe von draw_path(), wobei die Versätze einzeln eingefügt werden.

Die meisten Eigenschaften einer Collection können pro Element konfiguriert werden. Daher haben Collections "pluralisierte" Versionen vieler Eigenschaften eines Patch (z. B. Collection.get_paths anstelle von Patch.get_path). Ausnahmen sind die Eigenschaften zorder, hatch, pickradius, capstyle und joinstyle, die nur global für die gesamte Collection gesetzt werden können.

Abgesehen von diesen Ausnahmen können alle Eigenschaften als einzelne Werte (die für alle Elemente gelten) oder als Sequenzen von Werten angegeben werden. Die Eigenschaft des i-ten Elements der Collection ist

prop[i % len(prop)]

Jede Collection kann optional als eigene ScalarMappable verwendet werden, indem die Parameter norm und cmap an ihren Konstruktor übergeben werden. Wenn die ScalarMappable-Matrix _A der Collection gesetzt wurde (durch einen Aufruf von Collection.set_array), dann wird diese interne skalare Abbildung zur Zeichenzeit verwendet, um die facecolors und edgecolors zu setzen, wobei manuell übergebene ignoriert werden.

Parameter:

edgecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.edgecolor"] (Standard: 'black')

Randfarbe für jeden Patch, der die Collection bildet. Der spezielle Wert 'face' kann übergeben werden, um die Randfarbe der Flächenfarbe anzupassen.

facecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.facecolor"] (Standard: 'C0')

Flächenfarbe für jeden Patch, der die Collection bildet.

linewidthsfloat oder Liste von Floats, Standard: rcParams["patch.linewidth"] (Standard: 1.0)

Linienbreite für jeden Patch, der die Collection bildet.

linestylesstr oder Tupel oder Liste davon, Standard: 'solid'

Gültige Strings sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Bindestrich-Tupel sollten die Form haben

(offset, onoffseq),

wobei onoffseq ein Tupel gerader Länge von An- und Aus-Tintenlängen in Punkten ist. Beispiele finden Sie unter Linienstile.

capstyleCapStyle-ähnlich, Standard: 'butt'

Stil, der für die Kappen von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'butt', 'projecting', 'round'}.

joinstyleJoinStyle-ähnlich, Standard: 'round'

Stil, der für das Verbinden von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'miter', 'round', 'bevel'}.

antialiasedsbool oder Liste von bools, Standard: rcParams["patch.antialiased"] (Standard: True)

Ob jeder Patch in der Collection mit Antialiasing gezeichnet werden soll.

offsets(float, float) oder Liste davon, Standard: (0, 0)

Ein Vektor, um jeden Patch nach dem Rendern zu verschieben (Standard ist keine Verschiebung). Die Verschiebung erfolgt in Bildschirmkoordinaten (Pixel) (d. h. nach Anwendung der Transformation des Artists).

offset_transformTransform, Standard: IdentityTransform

Eine einzelne Transformation, die auf jeden offsets-Vektor angewendet wird, bevor er verwendet wird.

cmap, norm

Daten-Normalisierungs- und Farbkartenparameter. Siehe ScalarMappable für eine detaillierte Beschreibung.

hatchstr, optional

Schraffierungsmuster, das in gefüllten Pfaden verwendet wird, falls vorhanden. Gültige Strings sind ['/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*']. Siehe Referenz für Schraffierungsstile für die Bedeutung jedes Schraffurtyps.

pickradiusfloat, Standard: 5.0

Wenn pickradius <= 0, dann gibt Collection.contains True zurück, wenn der Testpunkt innerhalb eines der Polygone liegt, die aus den Kontrollpunkten eines Pfades in der Collection gebildet werden. Wenn er größer als 0 ist, wird stattdessen geprüft, ob der Testpunkt in einem Strich der Breite 2*pickradius liegt, der einem der Pfade in der Collection folgt.

urlsListe von str, Standard: None

Eine URL für jeden Patch, zu der nach dem Zeichnen verlinkt werden soll. Funktioniert derzeit nur für das SVG-Backend. Beispiele finden Sie unter Hyperlinks.

zorderfloat, Standard: 1

Die Zeichenreihenfolge, die für alle Patches in der Collection gilt. Siehe Zorder Demo für alle Standardwerte und Beispiele.

**kwargs

Verbleibende Schlüsselwortargumente werden verwendet, um Eigenschaften als Collection.set_{key}(val) für jedes Schlüssel-Wert-Paar in kwargs zu setzen.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die mit dem Callback verknüpfte Observer-ID. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Figur, auf der sich der Artist befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe (edgecolor)	Farbe oder Liste von Farben oder 'face'
Füllfarbe (facecolor)	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil (linestyle)	str oder Tupel oder Liste davon
Linienbreite (linewidth)	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(pfad, transformation=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(f)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(f)

Alias für set_edgecolor.

set_edgecolor(f)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(f)

Alias für set_edgecolor.

set_facecolor(f)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(f)

Alias für set_facecolor.

set_fc(f)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transformation)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(pfade)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sketch_params(skalierung=None, länge=None, zufälligkeit=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transformation)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.EllipseCollection(breiten, höhen, winkel, units='points', *, **kwargs)

Bases: Collection

Eine Sammlung von Ellipsen, die mit Splines gezeichnet werden.

Parameter:

breitenarray-like

Die Längen der ersten Achsen (z. B. Längen der Hauptachse).

höhenarray-like

Die Längen der zweiten Achsen.

winkelarray-like

Die Winkel der ersten Achsen, Grad gegen den Uhrzeigersinn von der x-Achse.

units{'points', 'inches', 'dots', 'width', 'height', 'x', 'y', 'xy'}

Die Einheiten, in denen Major und Minor angegeben werden; 'width' und 'height' beziehen sich auf die Dimensionen der Achsen, während 'x' und 'y' sich auf die Dateneinheiten der *Offsets* beziehen. 'xy' unterscheidet sich von allen anderen darin, dass der geplottete Winkel mit dem Seitenverhältnis variiert und nur dann dem angegebenen Winkel entspricht, wenn das Seitenverhältnis eins ist. Daher verhält er sich gleich wie die Ellipse mit axes.transData als Transformation.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die mit dem Callback verbundene Beobachter-ID. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_angles()

Die Winkel der ersten Achsen abrufen, Grad gegen den Uhrzeigersinn von der x-Achse.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Beim Überschreiben müssen sie jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenfolgendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_heights()

Setzt die Längen der zweiten Achsen (z. B. Nebenachsen).

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_widths()

Gibt die Längen der ersten Achsen (z. B. Hauptachse) zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, angles=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, heights=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, visible=<UNSET>, widths=<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	Array-ähnlich oder float oder None
angles	unknown
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
heights	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
widths	unknown
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_angles(angles)

Setzt die Winkel der ersten Achsen, Grad gegen den Uhrzeigersinn von der x-Achse.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_heights(heights)

Setzt die Längen der zweiten Achsen (z. B. Nebenachsen).

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_widths(widths)

Setzt die Längen der ersten Achse (z.B. Hauptachse).

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.EventCollection(positions, orientation='horizontal', *, lineoffset=0, linelength=1, linewidth=None, color=None, linestyle='solid', antialiased=None, **kwargs)

Bases: LineCollection

Eine Sammlung von Positionen entlang einer einzelnen Achse, an denen ein "Ereignis" aufgetreten ist.

Die Ereignisse werden durch ein eindimensionales Array gegeben. Sie haben keine Amplitude und werden als parallele Linien dargestellt.

Parameter:

positions1D array-like

Jeder Wert ist ein Ereignis.

orientation{'horizontal', 'vertical'}, Standard: 'horizontal'

Die Abfolge der Ereignisse wird entlang dieser Richtung geplottet. Die Markierungslinien der einzelnen Ereignisse liegen entlang der orthogonalen Richtung.

lineoffsetfloat, default: 0

Der Versatz des Zentrums der Markierungen vom Ursprung, in der Richtung orthogonal zu orientation.

linelengthfloat, default: 1

Die Gesamthöhe des Markers (d.h. der Marker erstreckt sich von lineoffset - linelength/2 bis lineoffset + linelength/2).

linewidthfloat oder Liste davon, default: rcParams["lines.linewidth"] (default: 1.5)

Die Linienbreite der Ereignislinien in Punkten.

colorcolor oder Liste von color, default: rcParams["lines.color"] (default: 'C0')

Die Farbe der Ereignislinien.

linestylestr oder Tupel oder Liste davon, default: 'solid'

Gültige Strings sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Bindestrich-Tupel sollten die Form haben

(offset, onoffseq),

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

antialiasedbool oder Liste davon, default: rcParams["lines.antialiased"] (default: True)

Ob Antialiasing für das Zeichnen der Linien verwendet werden soll.

**kwargs

Weitergeleitet an LineCollection.

Beispiele

(Quellcode, 2x.png, png)

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die dem Callback zugeordnet ist. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

add_positions(position)

Fügt ein oder mehrere Ereignisse an den angegebenen Positionen hinzu.

append_positions(position)

Fügt ein oder mehrere Ereignisse an den angegebenen Positionen hinzu.

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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.

extend_positions(position)

Fügt ein oder mehrere Ereignisse an den angegebenen Positionen hinzu.

property figure

Die (Sub-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_color()

Gibt die Farbe der Linien zurück, die zur Markierung jedes Ereignisses verwendet werden.

get_colors()

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Wenn dies geschieht, müssen sie jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung konvertieren kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gapcolor()

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linelength()

Gibt die Länge der Linien zurück, die zur Markierung jedes Ereignisses verwendet werden.

get_lineoffset()

Gibt den Versatz der Linien zurück, die zur Markierung jedes Ereignisses verwendet werden.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

Gibt die Dicke der Linien zurück, die zur Markierung jedes Ereignisses verwendet werden.

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_orientation()

Gibt die Ausrichtung der Ereignislinie zurück ('horizontal' oder 'vertical').

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_positions()

Gibt ein Array mit den Fließkommawerten der Positionen zurück.

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_segments()

Gibt zurück:

list

Liste der Segmente in der LineCollection. Jedes Listenelement enthält ein Array von Vertices.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_horizontal()

True, wenn die EventCollection horizontal ist, False, wenn sie vertikal ist.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, colors=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gapcolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linelength=<UNSET>, lineoffset=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, orientation=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, positions=<UNSET>, rasterized=<UNSET>, segments=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von Farben
Farben	Farbe oder Liste von Farben
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gapcolor	Farbe oder Liste von Farben oder None
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linelength	unknown
lineoffset	unknown
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
orientation	{'horizontal', 'vertical'}
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
positions	unknown
rasterized	bool
segments	unknown
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	unknown
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt die Randfarbe(n) der LineCollection.

Parameter:

cFarbe oder Liste von Farben

Einzelne Farbe (alle Linien haben die gleiche Farbe) oder eine Sequenz von RGBA-Tupeln; wenn es sich um eine Sequenz handelt, werden die Linien durch die Sequenz zyklisch durchlaufen.

set_colors(c)

Setzt die Randfarbe(n) der LineCollection.

Parameter:

cFarbe oder Liste von Farben

Einzelne Farbe (alle Linien haben die gleiche Farbe) oder eine Sequenz von RGBA-Tupeln; wenn es sich um eine Sequenz handelt, werden die Linien durch die Sequenz zyklisch durchlaufen.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gapcolor(gapcolor)

Setzt eine Farbe zum Füllen der Lücken im gestrichelten Linienstil.

Hinweis

Gestrichelte Linien werden durch das Zeichnen zweier überlappender gestrichelter Linien erzeugt. Es kann Überlappungen zwischen diesen beiden geben, was bei Verwendung von Transparenz zu Artefakten führen kann.

Diese Funktionalität ist experimentell und kann sich ändern.

Parameter:

gapcolorFarbe oder Liste von Farben oder None

Die Farbe, mit der die Lücken gefüllt werden sollen. Wenn None, bleiben die Lücken ungefüllt.

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linelength(linelength)

Legt die Länge der Linien fest, die zur Markierung jedes Ereignisses verwendet werden.

set_lineoffset(lineoffset)

Legt den Versatz der Linien fest, die zur Markierung jedes Ereignisses verwendet werden.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_orientation(orientation)

Legt die Ausrichtung der Ereignislinie fest.

Parameter:

orientation{{'horizontal', 'vertical'}}

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(segments)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_positions(positions)

Legt die Positionen der Ereignisse fest.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_segments(segments)

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_verts(segments)

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

switch_orientation()

Schaltet die Ausrichtung der Ereignislinie um, entweder von vertikal zu horizontal oder umgekehrt.

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.FillBetweenPolyCollection(t_direction, t, f1, f2, *, where=None, interpolate=False, step=None, **kwargs)

Bases: PolyCollection

PolyCollection, die den Bereich zwischen zwei x- oder y-Kurven füllt.

Parameter:

t_direction{{'x', 'y'}}

Die Achse, auf der die Variable liegt.

• 'x': die Kurven sind (t, f1) und (t, f2).

• 'y': die Kurven sind (f1, t) und (f2, t).

tArray-ähnlich

Die t_direction Koordinaten der Knoten, die die Kurven definieren.

f1Array-ähnlich oder float

Die anderen Koordinaten der Knoten, die die erste Kurve definieren.

f2Array-ähnlich oder float

Die anderen Koordinaten der Knoten, die die zweite Kurve definieren.

wherearray-like von bool, optional

Definiert, *wo* bestimmte {dir}-Bereiche vom Füllen ausgeschlossen werden sollen. Die gefüllten Bereiche werden durch die Koordinaten t[where] definiert. Genauer gesagt, füllen zwischen t[i] und t[i+1], wenn where[i] und where[i+1]. Beachten Sie, dass diese Definition impliziert, dass ein isolierter *True*-Wert zwischen zwei *False*-Werten in *where* kein Füllen zur Folge hat. Beide Seiten der *True*-Position bleiben aufgrund der benachbarten *False*-Werte ungefüllt.

interpolatebool, standard: False

Diese Option ist nur relevant, wenn where verwendet wird und sich die beiden Kurven schneiden.

Semantisch wird *where* oft für *f1* > *f2* oder ähnliches verwendet. Standardmäßig werden die Knoten des Polygons, das den gefüllten Bereich definiert, nur an den Positionen im *t*-Array platziert. Ein solches Polygon kann die obige Semantik nahe der Schnittstelle nicht beschreiben. Die t-Abschnitte, die die Schnittstelle enthalten, werden einfach abgeschnitten.

Wenn interpolate auf True gesetzt wird, wird der tatsächliche Schnittpunkt berechnet und der gefüllte Bereich bis zu diesem Punkt erweitert.

step{{'pre', 'post', 'mid'}}, optional

Definiert *step*, wenn das Füllen eine Stufenfunktion sein soll, d.h. konstant zwischen *t*. Der Wert bestimmt, wo die Stufe auftritt

• 'pre': Der f-Wert wird von jeder *t*-Position konstant nach links fortgesetzt, d.h. das Intervall (t[i-1], t[i]] hat den Wert f[i].

• 'post': Der y-Wert wird von jeder *x*-Position konstant nach rechts fortgesetzt, d.h. das Intervall [t[i], t[i+1]) hat den Wert f[i].

• 'mid': Stufen treten auf halbem Weg zwischen den *t*-Positionen auf.

**kwargs

Weitergeleitet an PolyCollection.

Siehe auch

Axes.fill_between, Axes.fill_betweenx

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Beobachter-ID, die dem Callback zugeordnet ist. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Wenn dies geschieht, müssen sie sicherstellen, dass format_cursor_data die Daten in eine Zeichenfolgendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

Berechnet die Datenlimits und gibt sie als Bbox zurück.

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, data=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Daten	array-like
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	liste von array-like
verts_and_codes	unknown
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_data(t, f1, f2, *, where=None)

Setzt neue Werte für die beiden Begrenzungskurven.

Parameter:

tArray-ähnlich

Die self.t_direction Koordinaten der Knoten, die die Kurven definieren.

f1Array-ähnlich oder float

Die anderen Koordinaten der Knoten, die die erste Kurve definieren.

f2Array-ähnlich oder float

Die anderen Koordinaten der Knoten, die die zweite Kurve definieren.

wherearray-like von bool, optional

Definiert, *wo* bestimmte {dir}-Bereiche vom Füllen ausgeschlossen werden sollen. Die gefüllten Bereiche werden durch die Koordinaten t[where] definiert. Genauer gesagt, füllen zwischen t[i] und t[i+1], wenn where[i] und where[i+1]. Beachten Sie, dass diese Definition impliziert, dass ein isolierter *True*-Wert zwischen zwei *False*-Werten in *where* kein Füllen zur Folge hat. Beide Seiten der *True*-Position bleiben aufgrund der benachbarten *False*-Werte ungefüllt.

Siehe auch

PolyCollection.set_verts, Line2D.set_data

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_verts(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_verts_and_codes(verts, codes)

Initialisiert Eckpunkte mit Pfadcodes.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.LineCollection(segments, *, zorder=2, **kwargs)

Bases: Collection

Repräsentiert eine Sequenz von Line2Ds, die zusammen gezeichnet werden sollen.

Diese Klasse erweitert Collection, um eine Sequenz von Line2Ds anstelle von nur einer Sequenz von Patchs zu repräsentieren. Wie bei Collection kann jede Eigenschaft einer LineCollection entweder ein einzelner Wert oder eine Liste von Werten sein. Diese Liste wird dann zyklisch für jedes Element der LineCollection verwendet, sodass die Eigenschaft des i-ten Elements der Sammlung

prop[i % len(prop)]

Die Eigenschaften jedes Mitglieds einer LineCollection haben standardmäßig ihre Werte aus rcParams["lines.*"] anstelle von rcParams["patch.*"], und die Eigenschaft colors wird anstelle von edgecolors hinzugefügt.

Parameter:

segmentsListe von array-ähnlichen Objekten der Form (N, 2)

Eine Sequenz [line0, line1, ...], wobei jede Linie ein Array der Form (N, 2) enthält, das Punkte enthält

line0 = [(x0, y0), (x1, y1), ...]

Jede Linie kann eine unterschiedliche Anzahl von Punkten enthalten.

linewidthsfloat oder Liste von float, Standard: rcParams["lines.linewidth"] (Standard: 1.5)

Die Dicke jeder Linie in Punkten.

colorsFarbe oder Liste von Farben, Standard: rcParams["lines.color"] (Standard: 'C0')

Eine Sequenz von RGBA-Tupeln (z.B. beliebige Farbstränge etc. nicht erlaubt).

antialiasedsbool oder Liste von bool, Standard: rcParams["lines.antialiased"] (Standard: True)

Ob Antialiasing für jede Linie verwendet werden soll.

zorderfloat, Standard: 2

zorder der Linien, sobald sie gezeichnet sind.

facecolorsFarbe oder Liste von Farben, Standard: 'none'

Beim Setzen von facecolors wird jede Linie als Begrenzung eines Bereichs interpretiert, wobei der Pfad vom letzten Punkt zum ersten Punkt implizit geschlossen wird. Der umschlossene Bereich wird mit facecolor gefüllt. Um manuell anzugeben, was als "Inneres" jeder Linie gelten soll, verwenden Sie stattdessen PathCollection, wobei das "Innere" durch entsprechende Verwendung von CLOSEPOLY angegeben werden kann.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die mit dem Callback verbundene Observer-ID. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub-)Figure, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_color()

get_colors()

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Wenn sie dies tun, müssen sie jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gapcolor()

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_segments()

Gibt zurück:

list

Liste der Segmente in der LineCollection. Jedes Listenelement enthält ein Array von Vertices.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, colors=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gapcolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, segments=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<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
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von Farben
Farben	Farbe oder Liste von Farben
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gapcolor	Farbe oder Liste von Farben oder None
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
segments	unknown
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	unknown
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt die Randfarbe(n) der LineCollection.

Parameter:

cFarbe oder Liste von Farben

Einzelne Farbe (alle Linien haben die gleiche Farbe) oder eine Sequenz von RGBA-Tupeln; wenn es sich um eine Sequenz handelt, werden die Linien durch die Sequenz zyklisch durchlaufen.

set_colors(c)

Setzt die Randfarbe(n) der LineCollection.

Parameter:

cFarbe oder Liste von Farben

Einzelne Farbe (alle Linien haben die gleiche Farbe) oder eine Sequenz von RGBA-Tupeln; wenn es sich um eine Sequenz handelt, werden die Linien durch die Sequenz zyklisch durchlaufen.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gapcolor(gapcolor)

Setzt eine Farbe zum Füllen der Lücken im gestrichelten Linienstil.

Hinweis

Gestrichelte Linien werden durch das Zeichnen zweier überlappender gestrichelter Linien erzeugt. Es kann Überlappungen zwischen diesen beiden geben, was bei Verwendung von Transparenz zu Artefakten führen kann.

Diese Funktionalität ist experimentell und kann sich ändern.

Parameter:

gapcolorFarbe oder Liste von Farben oder None

Die Farbe, mit der die Lücken gefüllt werden sollen. Wenn None, bleiben die Lücken ungefüllt.

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(segments)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_segments(segments)

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_verts(segments)

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.PatchCollection(patches, *, match_original=False, **kwargs)

Bases: Collection

Eine generische Sammlung von Patches.

PatchCollection zeichnet schneller als eine große Anzahl äquivalenter einzelner Patches. Sie erleichtert auch die Zuweisung einer Colormap zu einer heterogenen Sammlung von Patches.

Parameter:

patchesListe von Patch

Eine Sequenz von Patch-Objekten. Diese Liste kann eine heterogene Zusammenstellung verschiedener Patch-Typen enthalten.

match_originalbool, Standard: False

Wenn True, werden die Farben und Linienbreiten der ursprünglichen Patches verwendet. Wenn False, können neue Farben durch Angabe der Standard-Sammlungsargumente facecolor, edgecolor, linewidths, norm oder cmap zugewiesen werden.

**kwargs

Alle anderen Parameter werden an Collection weitergeleitet.

Wenn eines von edgecolors, facecolors, linewidths, antialiaseds None ist, werden sie in der Reihenfolge ihres Erscheinens auf die rcParams-Einstellung für Patches gesetzt.

Anmerkungen

Die Verwendung der ScalarMappable-Funktionalität ist optional. Wenn die ScalarMappable-Matrix _A gesetzt wurde (durch einen Aufruf von set_array), wird zur Zeichenzeit ein Aufruf an den ScalarMappable erfolgen, um die Flächenfarben zu setzen.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die mit dem Callback verknüpft ist. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(patches)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.PathCollection(paths, sizes=None, **kwargs)

Bases: _CollectionWithSizes

Eine Sammlung von Path-Objekten, wie sie z. B. von scatter erstellt werden.

Parameter:

pathsListe von path.Path

Die Pfade, aus denen die Collection bestehen wird.

sizesArray-ähnlich

Der Faktor, um den jeder gezeichnete Path skaliert wird. Eine Einheit im Quadrat des Datenraums des Pfades wird zu sizes**2 Punkten skaliert, wenn er gerendert wird.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die mit dem Callback verbunden ist. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Abbildung (Figure), auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung konvertieren kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

legend_elements(prop='colors', num='auto', fmt=None, func=<function PathCollection.<lambda>>, **kwargs)

Erstellt Legenden-Handles und -Beschriftungen für eine PathCollection.

Jedes Legenden-Handle ist ein Line2D, das den gezeichneten Pfad darstellt, und jede Beschriftung ist eine Zeichenkette, die den Pfad repräsentiert.

Dies ist nützlich, um eine Legende für ein scatter-Plot zu erhalten; z.B.

scatter = plt.scatter([1, 2, 3],  [4, 5, 6],  c=[7, 2, 3], num=None)
plt.legend(*scatter.legend_elements())

erstellt drei Legenden-Elemente, eines für jede Farbe mit den numerischen Werten, die an c übergeben wurden, als Beschriftungen.

Siehe auch das Beispiel Automatische Legenden-Erstellung.

Parameter:

prop{"colors", "sizes"}, Standard: "colors"

Wenn "colors", zeigen die Legenden-Handles die verschiedenen Farben der Sammlung. Wenn "sizes", zeigt die Legende die verschiedenen Größen. Um beides einzustellen, verwenden Sie kwargs, um die Line2D-Eigenschaften direkt zu bearbeiten.

numint, None, "auto" (Standard), array-ähnlich oder Locator

Zielanzahl der zu erstellenden Elemente. Wenn None, werden alle eindeutigen Elemente des abbildbaren Arrays verwendet. Wenn eine Ganzzahl, zielen Sie auf die Verwendung von num Elementen im normierten Bereich. Wenn "auto", versuchen Sie zu ermitteln, welche Option besser zur Art der Daten passt. Die Anzahl der erstellten Elemente kann geringfügig von num abweichen, da ein Locator verwendet wird, um nützliche Positionen zu finden. Wenn eine Liste oder ein Array, verwenden Sie genau diese Elemente für die Legende. Schließlich kann ein Locator bereitgestellt werden.

fmtstr, Formatter, oder None (Standard)

Das Format oder der Formatter, der für die Beschriftungen verwendet werden soll. Wenn eine Zeichenkette, muss sie ein gültiger Eingabewert für ein StrMethodFormatter sein. Wenn None (Standard), wird ein ScalarFormatter verwendet.

funcfunction, Standard: lambda x: x

Funktion zur Berechnung der Beschriftungen. Oft wurde das Größen- (oder Farb-)Argument für scatter vom Benutzer mittels einer Funktion s = f(x) vorverarbeitet, um die Marker sichtbar zu machen; z.B. size = np.log10(x). Die Bereitstellung der Umkehrfunktion hier ermöglicht die Umkehrung dieser Vorverarbeitung, sodass die Legendenbeschriftungen die korrekten Werte haben; z.B. func = lambda x: 10**x.

**kwargs

Zulässige Schlüsselwortargumente sind color und size. Z.B. kann es nützlich sein, die Farbe der Marker einzustellen, wenn prop="sizes" verwendet wird; ebenso die Größe der Marker einzustellen, wenn prop="colors" verwendet wird. Weitere Parameter werden an die Line2D-Instanz weitergegeben. Dies kann nützlich sein, um z.B. einen anderen markeredgecolor oder alpha für die Legenden-Handles anzugeben.

Gibt zurück:

handleslist of Line2D

Visuelle Darstellung jedes Legenden-Elements.

labelslist of str

Die Zeichenkettenbeschriftungen für die Legenden-Elemente.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.PolyCollection(verts, sizes=None, *, closed=True, **kwargs)

Bases: _CollectionWithSizes

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

sizesarray-like, default: None

Quadratische Skalierungsfaktoren für die Polygone. Die Koordinaten jedes Polygons verts_i werden mit der Quadratwurzel des entsprechenden Eintrags in sizes multipliziert (d. h., sizes gibt die Skalierung der Flächen an). Die Skalierung wird vor der Master-Transformation des Artists angewendet.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die ID des Beobachters, die mit dem Callback verbunden ist. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub)Figur, auf der sich der Artist befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Dabei müssen sie jedoch sicherstellen, dass format_cursor_data die Daten in eine String-Darstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	liste von array-like
verts_and_codes	unknown
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_verts(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_verts_and_codes(verts, codes)

Initialisiert Eckpunkte mit Pfadcodes.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.PolyQuadMesh(coordinates, **kwargs)

Bases: _MeshData, PolyCollection

Klasse zum Zeichnen eines Viereckgitters als einzelne Polygone.

Ein Viereckgitter ist ein Gitter von M mal N nebeneinander liegenden Vierecken, die über ein Gitter von (M+1, N+1) Vertices definiert sind. Das Viereck (m, n) ist definiert durch die Vertices

   (m+1, n) ----------- (m+1, n+1)
      /                   /
     /                 /
    /               /
(m, n) -------- (m, n+1)

Das Gitter muss nicht regelmäßig sein und die Polygone müssen nicht konvex sein.

Parameter:

coordinates(M+1, N+1, 2) array-ähnlich

Die Vertices. coordinates[m, n] gibt die (x, y)-Koordinaten des Vertex (m, n) an.

Anmerkungen

Im Gegensatz zu QuadMesh zeichnet diese Klasse jede Zelle als einzelnes Polygon. Dies ist deutlich langsamer, erlaubt aber mehr Flexibilität, wenn zusätzliche Eigenschaften zu den Zellen hinzugefügt werden sollen, wie z. B. Schraffuren.

Ein weiterer Unterschied zu QuadMesh ist, dass, wenn einer der Vertices oder Daten einer Zelle maskiert ist, dieses Polygon **nicht** gezeichnet wird und nicht in der Liste der zurückgegebenen Pfade enthalten ist.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

sizesarray-like, default: None

Quadratische Skalierungsfaktoren für die Polygone. Die Koordinaten jedes Polygons verts_i werden mit der Quadratwurzel des entsprechenden Eintrags in sizes multipliziert (d. h., sizes gibt die Skalierung der Flächen an). Die Skalierung wird vor der Master-Transformation des Artists angewendet.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

**kwargs

Weitergeleitet an Collection.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die mit dem Callback verbunden ist. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_coordinates()

Gibt die Vertices des Gitters als (M+1, N+1, 2) Array zurück.

M, N sind die Anzahl der Vierecke in den Zeilen/Spalten des Gitters, entsprechend (M+1, N+1) Vertices. Die letzte Dimension spezifiziert die Komponenten (x, y).

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Wenn sie dies tun, müssen sie sicherstellen, dass format_cursor_data die Daten in eine Zeichenfolgendarstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	unknown
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	liste von array-like
verts_and_codes	unknown
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Setze die Datenwerte.

Parameter:

Aarray-ähnlich

Die Gitterdaten. Unterstützte Array-Formen sind

• (M, N) oder (M*N,): ein Gitter mit Skalardaten. Die Werte werden mithilfe von Normalisierung und einer Farbskala auf Farben abgebildet. Siehe Parameter norm, cmap, vmin, vmax.

• (M, N, 3): Ein Bild mit RGB-Werten (0-1 Float oder 0-255 Integer).

• (M, N, 4): Ein Bild mit RGBA-Werten (0-1 Float oder 0-255 Integer), d.h. einschließlich Transparenz.

Wenn die Werte als 2D-Gitter bereitgestellt werden, muss die Form mit dem Koordinatengitter übereinstimmen. Wenn die Werte 1D sind, werden sie zu 2D umgeformt. M, N ergeben sich aus dem Koordinatengitter, wobei die Form des Koordinatengitters (M, N) für 'gouraud' shading und (M+1, N+1) für 'flat' shading ist.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_verts(verts, closed=True)

Setzt die Eckpunkte der Polygone.

Parameter:

vertsListe von array-ähnlichen Objekten

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte von Polygon i als 2D-Array mit der Form (M, 2) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_verts_and_codes(verts, codes)

Initialisiert Eckpunkte mit Pfadcodes.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.QuadMesh(coordinates, *, antialiased=True, shading='flat', **kwargs)

Bases: _MeshData, Collection

Klasse für die effiziente Zeichnung eines Viereck-Netzes.

Ein Viereckgitter ist ein Gitter von M mal N nebeneinander liegenden Vierecken, die über ein Gitter von (M+1, N+1) Vertices definiert sind. Das Viereck (m, n) ist definiert durch die Vertices

   (m+1, n) ----------- (m+1, n+1)
      /                   /
     /                 /
    /               /
(m, n) -------- (m, n+1)

Das Gitter muss nicht regelmäßig sein und die Polygone müssen nicht konvex sein.

Parameter:

coordinates(M+1, N+1, 2) array-ähnlich

Die Vertices. coordinates[m, n] gibt die (x, y)-Koordinaten des Vertex (m, n) an.

antialiasedbool, Standard: True

shading{'flat', 'gouraud'}, default: 'flat'

Anmerkungen

Im Gegensatz zu anderen Collections ist der Standard-pickradius von QuadMesh 0, d. h. contains prüft, ob der Testpunkt innerhalb eines der Vierecke des Netzes liegt.

Parameter:

edgecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.edgecolor"] (Standard: 'black')

Randfarbe für jeden Patch, der die Collection bildet. Der spezielle Wert 'face' kann übergeben werden, um die Randfarbe der Flächenfarbe anzupassen.

facecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.facecolor"] (Standard: 'C0')

Flächenfarbe für jeden Patch, der die Collection bildet.

linewidthsfloat oder Liste von Floats, Standard: rcParams["patch.linewidth"] (Standard: 1.0)

Linienbreite für jeden Patch, der die Collection bildet.

linestylesstr oder Tupel oder Liste davon, Standard: 'solid'

Gültige Strings sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Bindestrich-Tupel sollten die Form haben

(offset, onoffseq),

wobei onoffseq ein Tupel gerader Länge von An- und Aus-Tintenlängen in Punkten ist. Beispiele finden Sie unter Linienstile.

capstyleCapStyle-ähnlich, Standard: 'butt'

Stil, der für die Kappen von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'butt', 'projecting', 'round'}.

joinstyleJoinStyle-ähnlich, Standard: 'round'

Stil, der für das Verbinden von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'miter', 'round', 'bevel'}.

antialiasedsbool oder Liste von bools, Standard: rcParams["patch.antialiased"] (Standard: True)

Ob jeder Patch in der Collection mit Antialiasing gezeichnet werden soll.

offsets(float, float) oder Liste davon, Standard: (0, 0)

Ein Vektor, um jeden Patch nach dem Rendern zu verschieben (Standard ist keine Verschiebung). Die Verschiebung erfolgt in Bildschirmkoordinaten (Pixel) (d. h. nach Anwendung der Transformation des Artists).

offset_transformTransform, Standard: IdentityTransform

Eine einzelne Transformation, die auf jeden offsets-Vektor angewendet wird, bevor er verwendet wird.

cmap, norm

Daten-Normalisierungs- und Farbkartenparameter. Siehe ScalarMappable für eine detaillierte Beschreibung.

hatchstr, optional

Schraffierungsmuster, das in gefüllten Pfaden verwendet wird, falls vorhanden. Gültige Strings sind ['/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*']. Siehe Referenz für Schraffierungsstile für die Bedeutung jedes Schraffurtyps.

pickradiusfloat, Standard: 5.0

Wenn pickradius <= 0, dann gibt Collection.contains True zurück, wenn der Testpunkt innerhalb eines der Polygone liegt, die aus den Kontrollpunkten eines Pfades in der Collection gebildet werden. Wenn er größer als 0 ist, wird stattdessen geprüft, ob der Testpunkt in einem Strich der Breite 2*pickradius liegt, der einem der Pfade in der Collection folgt.

urlsListe von str, Standard: None

Eine URL für jeden Patch, zu der nach dem Zeichnen verlinkt werden soll. Funktioniert derzeit nur für das SVG-Backend. Beispiele finden Sie unter Hyperlinks.

zorderfloat, Standard: 1

Die Zeichenreihenfolge, die für alle Patches in der Collection gilt. Siehe Zorder Demo für alle Standardwerte und Beispiele.

**kwargs

Verbleibende Schlüsselwortargumente werden verwendet, um Eigenschaften als Collection.set_{key}(val) für jedes Schlüssel-Wert-Paar in kwargs zu setzen.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die ID des Beobachters, die mit dem Callback verbunden ist. Diese ID kann verwendet werden, um den Callback später mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Grafik, auf der sich die Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_coordinates()

Gibt die Vertices des Gitters als (M+1, N+1, 2) Array zurück.

M, N sind die Anzahl der Vierecke in den Zeilen/Spalten des Gitters, entsprechend (M+1, N+1) Vertices. Die letzte Dimension spezifiziert die Komponenten (x, y).

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine String-Darstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	array-like
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Setze die Datenwerte.

Parameter:

Aarray-ähnlich

Die Gitterdaten. Unterstützte Array-Formen sind

• (M, N) oder (M*N,): ein Gitter mit Skalardaten. Die Werte werden mithilfe von Normalisierung und einer Farbskala auf Farben abgebildet. Siehe Parameter norm, cmap, vmin, vmax.

• (M, N, 3): Ein Bild mit RGB-Werten (0-1 Float oder 0-255 Integer).

• (M, N, 4): Ein Bild mit RGBA-Werten (0-1 Float oder 0-255 Integer), d.h. einschließlich Transparenz.

Wenn die Werte als 2D-Gitter bereitgestellt werden, muss die Form mit dem Koordinatengitter übereinstimmen. Wenn die Werte 1D sind, werden sie zu 2D umgeformt. M, N ergeben sich aus dem Koordinatengitter, wobei die Form des Koordinatengitters (M, N) für 'gouraud' shading und (M+1, N+1) für 'flat' shading ist.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths()

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.RegularPolyCollection(numsides, *, rotation=0, sizes=(1,), **kwargs)

Bases: _CollectionWithSizes

Eine Sammlung von regelmäßigen Polygonen mit n Seiten.

Parameter:

numsidesint

Die Anzahl der Seiten des Polygons.

rotationfloat

Die Rotation des Polygons in Radiant.

sizestuple of float

Die Fläche des Kreises, der das Polygon umschreibt, in Punkte^2.

**kwargs

Weitergeleitet an Collection.

Beispiele

Siehe Lasso Demo für ein vollständiges Beispiel

offsets = np.random.rand(20, 2)
facecolors = [cm.jet(x) for x in np.random.rand(20)]

collection = RegularPolyCollection(
    numsides=5, # a pentagon
    rotation=0, sizes=(50,),
    facecolors=facecolors,
    edgecolors=("black",),
    linewidths=(1,),
    offsets=offsets,
    offset_transform=ax.transData,
    )

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die ID des Beobachters, die mit dem Callback assoziiert ist. Diese ID kann später verwendet werden, um den Callback mit remove_callback zu entfernen.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Unter-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine String-Darstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_numsides()

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_rotation()

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

Eigenschaft norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

Eigenschaft stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

Eigenschaft sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

Klasse matplotlib.collections.StarPolygonCollection(numsides, *, rotation=0, sizes=(1,), **kwargs)

Basen: RegularPolyCollection

Zeichnet eine Sammlung von regelmäßigen Sternen mit numsides Spitzen.

Parameter:

numsidesint

Die Anzahl der Seiten des Polygons.

rotationfloat

Die Rotation des Polygons in Radiant.

sizestuple of float

Die Fläche des Kreises, der das Polygon umschreibt, in Punkte^2.

**kwargs

Weitergeleitet an Collection.

Beispiele

Siehe Lasso Demo für ein vollständiges Beispiel

offsets = np.random.rand(20, 2)
facecolors = [cm.jet(x) for x in np.random.rand(20)]

collection = RegularPolyCollection(
    numsides=5, # a pentagon
    rotation=0, sizes=(50,),
    facecolors=facecolors,
    edgecolors=("black",),
    linewidths=(1,),
    offsets=offsets,
    offset_transform=ax.transData,
    )

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die Observer-ID, die dem Callback zugeordnet ist. Diese ID kann später mit remove_callback zum Entfernen des Callbacks verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

Eigenschaft axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

Eigenschaft cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub)Figure, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine Zeichenkettendarstellung konvertieren kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_numsides()

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_rotation()

get_sizes()

Gibt die Größen ('Flächen') der Elemente in der Sammlung zurück.

Gibt zurück:

Array

Die 'Fläche' jedes Elements.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist *True*, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(**, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths(paths)

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sizes(sizes, dpi=72.0)

Setzt die Größen jedes Elements der Sammlung.

Parameter:

sizesnumpy.ndarray oder None

Der für jedes Element der Sammlung einzustellende Wert ist die 'Fläche' des Elements.

dpifloat, Standard: 72

Die DPI der Leinwand.

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0

class matplotlib.collections.TriMesh(triangulation, **kwargs)

Bases: Collection

Klasse zur effizienten Darstellung eines Dreiecksnetzes mittels Gouraud-Schattierung.

Ein Dreiecksnetz ist ein Triangulation-Objekt.

Parameter:

edgecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.edgecolor"] (Standard: 'black')

Randfarbe für jeden Patch, der die Collection bildet. Der spezielle Wert 'face' kann übergeben werden, um die Randfarbe der Flächenfarbe anzupassen.

facecolorsFarbe oder Liste von Farben, Standard: rcParams["patch.facecolor"] (Standard: 'C0')

Flächenfarbe für jeden Patch, der die Collection bildet.

linewidthsfloat oder Liste von Floats, Standard: rcParams["patch.linewidth"] (Standard: 1.0)

Linienbreite für jeden Patch, der die Collection bildet.

linestylesstr oder Tupel oder Liste davon, Standard: 'solid'

Gültige Strings sind ['solid', 'dashed', 'dashdot', 'dotted', '-', '--', '-.', ':']. Bindestrich-Tupel sollten die Form haben

(offset, onoffseq),

wobei onoffseq ein Tupel gerader Länge von An- und Aus-Tintenlängen in Punkten ist. Beispiele finden Sie unter Linienstile.

capstyleCapStyle-ähnlich, Standard: 'butt'

Stil, der für die Kappen von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'butt', 'projecting', 'round'}.

joinstyleJoinStyle-ähnlich, Standard: 'round'

Stil, der für das Verbinden von Linien für alle Pfade in der Collection verwendet wird. Zulässige Werte sind {'miter', 'round', 'bevel'}.

antialiasedsbool oder Liste von bools, Standard: rcParams["patch.antialiased"] (Standard: True)

Ob jeder Patch in der Collection mit Antialiasing gezeichnet werden soll.

offsets(float, float) oder Liste davon, Standard: (0, 0)

Ein Vektor, um jeden Patch nach dem Rendern zu verschieben (Standard ist keine Verschiebung). Die Verschiebung erfolgt in Bildschirmkoordinaten (Pixel) (d. h. nach Anwendung der Transformation des Artists).

offset_transformTransform, Standard: IdentityTransform

Eine einzelne Transformation, die auf jeden offsets-Vektor angewendet wird, bevor er verwendet wird.

cmap, norm

Daten-Normalisierungs- und Farbkartenparameter. Siehe ScalarMappable für eine detaillierte Beschreibung.

hatchstr, optional

Schraffierungsmuster, das in gefüllten Pfaden verwendet wird, falls vorhanden. Gültige Strings sind ['/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*']. Siehe Referenz für Schraffierungsstile für die Bedeutung jedes Schraffurtyps.

pickradiusfloat, Standard: 5.0

Wenn pickradius <= 0, dann gibt Collection.contains True zurück, wenn der Testpunkt innerhalb eines der Polygone liegt, die aus den Kontrollpunkten eines Pfades in der Collection gebildet werden. Wenn er größer als 0 ist, wird stattdessen geprüft, ob der Testpunkt in einem Strich der Breite 2*pickradius liegt, der einem der Pfade in der Collection folgt.

urlsListe von str, Standard: None

Eine URL für jeden Patch, zu der nach dem Zeichnen verlinkt werden soll. Funktioniert derzeit nur für das SVG-Backend. Beispiele finden Sie unter Hyperlinks.

zorderfloat, Standard: 1

Die Zeichenreihenfolge, die für alle Patches in der Collection gilt. Siehe Zorder Demo für alle Standardwerte und Beispiele.

**kwargs

Verbleibende Schlüsselwortargumente werden verwendet, um Eigenschaften als Collection.set_{key}(val) für jedes Schlüssel-Wert-Paar in kwargs zu setzen.

add_callback(func)

Fügt eine Callback-Funktion hinzu, die aufgerufen wird, wenn sich eine der Eigenschaften des Artist ändert.

Parameter:

funcaufrufbar

Die Callback-Funktion. Sie muss die Signatur haben

def func(artist: Artist) -> Any

wobei artist das aufrufende Artist ist. Rückgabewerte können vorhanden sein, werden aber ignoriert.

Gibt zurück:

int

Die ID des Beobachters, die mit dem Callback assoziiert ist. Diese ID kann später zum Entfernen des Callbacks mit remove_callback verwendet werden.

Siehe auch

remove_callback

autoscale()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays.

autoscale_None()

Automatische Skalierung der Skalarwerte auf der Norm-Instanz unter Verwendung des aktuellen Arrays, wobei nur Limits geändert werden, die None sind.

property axes

Die Axes-Instanz, in der sich der Artist befindet, oder None.

changed()

Rufen Sie dies auf, wenn sich die Mappable geändert hat, um alle Callback-Listener für das Signal 'changed' zu benachrichtigen.

property cmap

property colorbar

Die letzte Farbleiste, die diesem Objekt zugeordnet ist. Kann None sein

property colorizer

contains(mouseevent)

Prüft, ob das Mausereignis in der Sammlung aufgetreten ist.

Gibt bool, dict(ind=itemlist) zurück, wobei jedes Element in itemlist das Ereignis enthält.

static convert_mesh_to_paths(tri)

Konvertiert ein gegebenes Netz in eine Sequenz von Path-Objekten.

Diese Funktion ist hauptsächlich für Implementierer von Backends gedacht, die Netze nicht direkt unterstützen.

convert_xunits(x)

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die x-Achse keine Einheiten hat, wird x selbst zurückgegeben.

convert_yunits(y)

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Wenn der Künstler nicht in einem Achsenobjekt enthalten ist oder wenn die y-Achse keine Einheiten hat, wird y selbst zurückgegeben.

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 figure

Die (Sub-)Figur, auf der sich der Künstler befindet. Für mehr Kontrolle verwenden Sie die Methode get_figure.

findobj(match=None, include_self=True)

Findet Künstlerobjekte.

Rekursiv alle Artist-Instanzen finden, die im Künstler enthalten sind.

Parameter:

match

Ein Filterkriterium für die Übereinstimmungen. Dies kann sein

• None: Gibt alle im Künstler enthaltenen Objekte zurück.

• Eine Funktion mit der Signatur def match(artist: Artist) -> bool. Das Ergebnis enthält nur Künstler, für die die Funktion True zurückgibt.

• Eine Klasseninstanz: z.B. Line2D. Das Ergebnis enthält nur Künstler dieser Klasse oder ihrer Unterklassen (isinstance-Prüfung).

include_selfbool

Schließt self in die zu prüfende Liste ein.

Gibt zurück:

Liste von Artist

format_cursor_data(data)

Gibt eine Zeichenkettendarstellung von data zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Die Standardimplementierung wandelt Ganzzahlen und Fließkommazahlen sowie Arrays von Ganzzahlen und Fließkommazahlen in eine kommaseparierte Zeichenkette um, die in eckige Klammern eingeschlossen ist, es sei denn, der Künstler hat eine zugeordnete Farbleiste, in welchem Fall Skalarwerte mit dem Formatierer der Farbleiste formatiert werden.

Siehe auch

get_cursor_data

get_aa()

Alias für get_antialiased.

get_agg_filter()

Gibt die Filterfunktion zurück, die für den Agg-Filter verwendet werden soll.

get_alpha()

Gibt den für die Mischung verwendeten Alpha-Wert zurück - wird nicht von allen Backends unterstützt.

get_animated()

Gibt zurück, ob der Artist animiert ist.

get_antialiased()

Ruft den Antialiasing-Zustand für das Rendern ab.

Gibt zurück:

Array von bools

get_antialiaseds()

Alias für get_antialiased.

get_array()

Gibt das Array von Werten zurück, die Farben zugeordnet sind.

Die Basisklasse ScalarMappable macht keine Annahmen über die Dimensionalität und Form des Arrays.

get_capstyle()

Gibt den Cap-Stil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'butt', 'projecting', 'round'} oder None

get_children()

Gibt eine Liste der untergeordneten Artists dieses Artist zurück.

get_clim()

Gibt die Werte (min, max) zurück, die den Colormap-Grenzen zugeordnet sind.

get_clip_box()

Gibt die Beschneidungsbox zurück.

get_clip_on()

Gibt zurück, ob der Artist Beschneiden verwendet.

get_clip_path()

Gibt den Beschneidungspfad zurück.

get_cmap()

Gibt die Colormap-Instanz zurück.

get_cursor_data(event)

Gibt die Cursor-Daten für ein gegebenes Ereignis zurück.

Hinweis

Diese Methode ist dazu bestimmt, von Künstler-Unterklassen überschrieben zu werden. Als Endbenutzer von Matplotlib werden Sie diese Methode höchstwahrscheinlich nicht selbst aufrufen.

Cursor-Daten können von Künstlern verwendet werden, um zusätzliche Kontextinformationen für ein gegebenes Ereignis bereitzustellen. Die Standardimplementierung gibt einfach None zurück.

Unterklassen können die Methode überschreiben und beliebige Daten zurückgeben. Sie müssen jedoch sicherstellen, dass format_cursor_data die Daten in eine String-Darstellung umwandeln kann.

Der einzige aktuelle Anwendungsfall ist die Anzeige des z-Wertes eines AxesImage in der Statusleiste eines Plot-Fensters, während die Maus bewegt wird.

Parameter:

eventMouseEvent

Siehe auch

format_cursor_data

get_dashes()

Alias für get_linestyle.

get_datalim(transData)

get_ec()

Alias für get_edgecolor.

get_edgecolor()

get_edgecolors()

Alias für get_edgecolor.

get_facecolor()

get_facecolors()

Alias für get_facecolor.

get_fc()

Alias für get_facecolor.

get_figure(root=False)

Gibt die Figure oder SubFigure-Instanz zurück, zu der der Künstler gehört.

Parameter:

rootbool, default=False

Wenn False, wird die (Sub)Figure zurückgegeben, auf der sich dieser Künstler befindet. Wenn True, wird die Wurzel-Figure für einen verschachtelten Baum von SubFigures zurückgegeben.

get_fill()

Gibt zurück, ob die Fläche gefärbt ist.

get_gid()

Gibt die Gruppen-ID zurück.

get_hatch()

Gibt das aktuelle Schattierungsmuster zurück.

get_hatch_linewidth()

Gibt die Liniendicke der Schattierung zurück.

get_in_layout()

Gibt ein boolesches Flag zurück, True, wenn der Artist in Layoutberechnungen einbezogen ist.

Z.B. Constrained layout guide, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

get_joinstyle()

Gibt den Verbindungsstil für die Sammlung (für alle ihre Elemente) zurück.

Gibt zurück:

{'miter', 'round', 'bevel'} oder None

get_label()

Gibt die für diesen Artist in der Legende verwendete Beschriftung zurück.

get_linestyle()

get_linestyles()

Alias für get_linestyle.

get_linewidth()

get_linewidths()

Alias für get_linewidth.

get_ls()

Alias für get_linestyle.

get_lw()

Alias für get_linewidth.

get_mouseover()

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

get_offset_transform()

Gibt die Transform-Instanz zurück, die vom Offset dieses Künstlers verwendet wird.

get_offsets()

Gibt die Offsets für die Sammlung zurück.

get_path_effects()

get_paths()

get_picker()

Gibt das Auswahlverhalten des Artists zurück.

Die möglichen Werte sind in Artist.set_picker beschrieben.

Siehe auch

Artist.set_picker, Artist.pickable, Artist.pick

get_pickradius()

get_rasterized()

Gibt zurück, ob der Artist gerastert werden soll.

get_sketch_params()

Gibt die Skizzenparameter für den Artist zurück.

Gibt zurück:

Tupel oder None

Ein 3-Tupel mit den folgenden Elementen

• scale: Die Amplitude des Wackelns senkrecht zur Quelllinie.

• length: Die Länge des Wackelns entlang der Linie.

• randomness: Der Skalierungsfaktor, um den die Länge geschrumpft oder erweitert wird.

Gibt None zurück, wenn keine Skizzenparameter gesetzt wurden.

get_snap()

Gibt die Snapping-Einstellung zurück.

Siehe set_snap für Details.

get_tightbbox(renderer=None)

Ähnlich wie Artist.get_window_extent, aber inklusive jeglichen Beschneidens.

Parameter:

rendererRendererBase subclass, optional

Renderer, der zum Zeichnen der Figuren verwendet wird (d. h. fig.canvas.get_renderer())

Gibt zurück:

Bbox oder None

Die umschließende Bounding Box (in Figure-Pixelkoordinaten). Gibt None zurück, wenn durch Clipping keine Schnittmenge entsteht.

get_transOffset()

Alias für get_offset_transform.

get_transform()

Gibt die Transform-Instanz zurück, die von diesem Künstler verwendet wird.

get_transformed_clip_path_and_affine()

Gibt den Clip-Pfad mit dem angewendeten nicht-affinen Teil seiner Transformation zurück, und den verbleibenden affinen Teil seiner Transformation.

get_transforms()

get_url()

Gibt die URL zurück.

get_urls()

Gibt eine Liste von URLs zurück, eine für jedes Element der Sammlung.

Die Liste enthält None für Elemente ohne URL. Siehe Hyperlinks für ein Beispiel.

get_visible()

Gibt die Sichtbarkeit zurück.

get_window_extent(renderer=None)

Ruft die Bounding Box des Künstlers im Anzeigeraum ab.

Die Breite und Höhe der Bounding Box sind nicht negativ.

Unterklassen sollten für die Aufnahme in die "enge" Bounding-Box-Berechnung überschrieben werden. Standard ist die Rückgabe einer leeren Bounding Box bei 0, 0.

Seien Sie vorsichtig bei der Verwendung dieser Funktion, die Ergebnisse werden nicht aktualisiert, wenn sich die Fenstererweiterung des Künstlers ändert. Die Erweiterung kann sich aufgrund von Änderungen im Transformationsstapel ändern, wie z. B. Änderungen der Axes-Limits, der Figure-Größe oder der verwendeten Canvas (wie beim Speichern einer Figure). Dies kann zu unerwartetem Verhalten führen, bei dem interaktive Figures auf dem Bildschirm gut aussehen, aber falsch gespeichert werden.

get_zorder()

Gibt die zorder des Artists zurück.

have_units()

Gibt zurück, ob Einheiten auf einer Achse gesetzt sind.

is_transform_set()

Gibt zurück, ob für den Artist explizit eine Transformation festgelegt wurde.

Dies ist True, nachdem set_transform aufgerufen wurde.

property mouseover

Gibt zurück, ob dieser Künstler für benutzerdefinierte Kontextinformationen abgefragt wird, wenn sich der Mauszeiger darüber bewegt.

property norm

pchanged()

Ruft alle registrierten Callbacks auf.

Diese Funktion wird intern ausgelöst, wenn eine Eigenschaft geändert wird.

Siehe auch

add_callback

remove_callback

pick(mouseevent)

Verarbeitet ein Pick-Ereignis.

Jeder Kind-Künstler löst ein Pick-Ereignis aus, wenn mouseevent über dem Künstler liegt und der Künstler ein Picker gesetzt hat.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pickable

pickable()

Gibt zurück, ob der Artist auswählbar ist.

Siehe auch

Artist.set_picker, Artist.get_picker, Artist.pick

properties()

Gibt ein Wörterbuch aller Eigenschaften des Artists zurück.

remove()

Entfernt den Künstler aus der Abbildung, wenn möglich.

Die Auswirkung wird erst sichtbar, wenn die Abbildung neu gezeichnet wird, z. B. mit FigureCanvasBase.draw_idle. Rufen Sie relim auf, um die Achsen-Limits bei Bedarf zu aktualisieren.

Hinweis: relim sieht keine Sammlungen, auch wenn die Sammlung mit autolim = True zu den Achsen hinzugefügt wurde.

Hinweis: Es gibt keine Unterstützung für das Entfernen des Legendeneintrags des Künstlers.

remove_callback(oid)

Entfernt einen Callback basierend auf seiner Observer-ID.

Siehe auch

add_callback

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<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	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
Randfarbe oder ec oder Randfarben	Farbe oder Liste von Farben oder 'face'
Flächenfarbe oder Flächenfarben oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
Linienstil oder Striche oder Linienstile oder ls	str oder Tupel oder Liste davon
Linienbreite oder Linienbreiten oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	liste von AbstractPathEffect
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

set_aa(aa)

Alias für set_antialiased.

set_agg_filter(filter_func)

Legt den Agg-Filter fest.

Parameter:

filter_funccallable

Eine Filterfunktion, die ein (m, n, depth) Float-Array und einen DPI-Wert nimmt und ein (m, n, depth) Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt.

set_alpha(alpha)

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

Parameter:

alphaarray-like oder float oder None

Alle Werte müssen im Bereich 0-1 liegen, einschließlich. Maskierte Werte und NaNs werden nicht unterstützt.

set_animated(b)

Legt fest, ob der Artist für eine Animation verwendet werden soll.

Wenn True, ist das Objekt von der regulären Zeichnung der Abbildung ausgeschlossen. Sie müssen Figure.draw_artist / Axes.draw_artist explizit für das Objekt aufrufen. Dieser Ansatz wird verwendet, um Animationen mithilfe von Blitting zu beschleunigen.

Siehe auch matplotlib.animation und Schnellere Darstellung durch Blitting.

Parameter:

bbool

set_antialiased(aa)

Setzt den Antialiasing-Zustand für das Rendering.

Parameter:

aabool oder Liste von bools

set_antialiaseds(aa)

Alias für set_antialiased.

set_array(A)

Legt das Werte-Array aus einem Array-ähnlichen Objekt A fest.

Parameter:

Aarray-like oder None

Die Werte, die Farben zugeordnet werden.

Die Basisklasse ScalarMappable trifft keine Annahmen über die Dimensionalität und Form des Wertarrays A.

set_capstyle(cs)

Setzt den CapStyle für die Sammlung (für alle ihre Elemente).

Parameter:

csCapStyle oder {'butt', 'projecting', 'round'}

set_clim(vmin=None, vmax=None)

Legt die Norm-Grenzen für die Bildskalierung fest.

Parameter:

vmin, vmaxfloat

Die Grenzen.

Für Skalardaten können die Grenzen auch als Tupel (vmin, vmax) als einzelnes positionsgebundenes Argument übergeben werden.

set_clip_box(clipbox)

Legt die Beschneidungs-Bbox des Artists fest Bbox.

Parameter:

clipboxBboxBase oder None

Wird typischerweise aus einem TransformedBbox erstellt. Zum Beispiel ist TransformedBbox(Bbox([[0, 0], [1, 1]]), ax.transAxes) die Standard-Clipbox für ein Objekt, das zu einer Achse hinzugefügt wurde.

set_clip_on(b)

Legt fest, ob der Artist Beschneiden verwendet.

Wenn False, werden Künstler außerhalb der Achsen sichtbar sein, was zu unerwarteten Ergebnissen führen kann.

Parameter:

bbool

set_clip_path(path, transform=None)

Legt den Beschneidungspfad des Artists fest.

Parameter:

pathPatch oder Path oder TransformedPath oder None

Der Clip-Pfad. Wenn ein Path angegeben wird, muss transform ebenfalls angegeben werden. Wenn None, wird ein zuvor gesetzter Clip-Pfad entfernt.

transformTransform, optional

Wird nur verwendet, wenn path ein Path ist, in diesem Fall wird der angegebene Path unter Verwendung von transform in ein TransformedPath umgewandelt.

Anmerkungen

Aus Effizienzgründen, wenn path ein Rectangle ist, setzt diese Methode die Clipping-Box auf das entsprechende Rechteck und den Clipping-Pfad auf None.

Aus technischen Gründen (Unterstützung von set) wird ein Tupel (path, transform) auch als einzelner positional Parameter akzeptiert.

set_cmap(cmap)

Legt die Colormap für Luminanzdaten fest.

Parameter:

cmapColormap oder str oder None

set_color(c)

Setzt sowohl die Randfarbe als auch die Flächenfarbe.

Parameter:

cFarbe oder Liste von RGBA-Tupeln

Siehe auch

Collection.set_facecolor, Collection.set_edgecolor

Zum individuellen Setzen der Rand- oder Flächenfarbe.

set_dashes(ls)

Alias für set_linestyle.

set_ec(c)

Alias für set_edgecolor.

set_edgecolor(c)

Setzt die Randfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Randfarbe(n) der Sammlung. Wenn eine Sequenz, werden die Patches durch diese Sequenz zyklisch durchlaufen. Wenn 'face', wird die Flächenfarbe übernommen.

set_edgecolors(c)

Alias für set_edgecolor.

set_facecolor(c)

Setzt die Flächenfarbe(n) der Sammlung. c kann eine Farbe (alle Patches haben die gleiche Farbe) oder eine Sequenz von Farben sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Wenn c 'none' ist, wird der Patch nicht gefüllt.

Parameter:

cFarbe oder Liste von Farben

set_facecolors(c)

Alias für set_facecolor.

set_fc(c)

Alias für set_facecolor.

set_figure(fig)

Legt die Figure- oder SubFigure-Instanz fest, zu der der Artist gehört.

Parameter:

figFigure oder SubFigure

set_gid(gid)

Legt die (Gruppen-)ID für den Artist fest.

Parameter:

gidstr

set_hatch(hatch)

Setzt das Schattierungsmuster

hatch kann eines der folgenden sein

/   - diagonal hatching
\   - back diagonal
|   - vertical
-   - horizontal
+   - crossed
x   - crossed diagonal
o   - small circle
O   - large circle
.   - dots
*   - stars

Buchstaben können kombiniert werden, in diesem Fall werden alle angegebenen Schattierungen durchgeführt. Wenn der gleiche Buchstabe wiederholt wird, erhöht sich die Dichte der Schattierung dieses Musters.

Im Gegensatz zu anderen Eigenschaften wie Linienbreite und Farben kann die Schattierung nur für die gesamte Sammlung angegeben werden, nicht einzeln für jedes Mitglied.

Parameter:

hatch{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}

set_hatch_linewidth(lw)

Setzt die Linienstärke der Schraffur.

set_in_layout(in_layout)

Legt fest, ob das Objekt in Layoutberechnungen einbezogen werden soll, z. B. Leitfaden zum Constrained Layout, Figure.tight_layout() und fig.savefig(fname, bbox_inches='tight').

Parameter:

in_layoutbool

set_joinstyle(js)

Setzt den JoinStyle für die Sammlung (für alle ihre Elemente).

Parameter:

jsJoinStyle oder {'miter', 'round', 'bevel'}

set_label(s)

Legt eine Beschriftung fest, die in der Legende angezeigt wird.

Parameter:

sObjekt

s wird durch Aufruf von str in einen String konvertiert.

set_linestyle(ls)

Setzt den Linienstil für die Sammlung.

Linienstil (linestyle)	Beschreibung
'-' oder 'solid'	durchgezogene Linie
'--' oder 'dashed'	gestrichelte Linie
'-.' oder 'dashdot'	Strichpunktlinie
':' oder 'dotted'	gepunktete Linie

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:

lsstr oder Tupel oder Liste davon

Gültige Werte für einzelne Linienstile sind {'-', '--', '-.', ':', '', (offset, on-off-seq)}. Eine vollständige Beschreibung finden Sie unter Line2D.set_linestyle.

set_linestyles(ls)

Alias für set_linestyle.

set_linewidth(lw)

Setzt die Linienstärke(n) für die Sammlung. lw kann ein Skalar oder eine Sequenz sein; wenn es sich um eine Sequenz handelt, werden die Patches durch die Sequenz geschaltet.

Parameter:

lwfloat oder Liste von floats

set_linewidths(lw)

Alias für set_linewidth.

set_ls(ls)

Alias für set_linestyle.

set_lw(lw)

Alias für set_linewidth.

set_mouseover(mouseover)

Legt fest, ob dieser Artist für benutzerdefinierte Kontextinformationen abgefragt wird, wenn der Mauszeiger darüber bewegt wird.

Parameter:

mouseoverbool

Siehe auch

get_cursor_data

ToolCursorPosition

NavigationToolbar2

set_norm(norm)

Legt die Normalisierungsinstanz fest.

Parameter:

normNormalize oder str oder None

Anmerkungen

Wenn es Farbleisten gibt, die die Mappable für diese Norm verwenden, wird durch das Festlegen der Norm der Mappable die Norm, der Locator und die Formatierer auf der Farbleiste auf Standardwerte zurückgesetzt.

set_offset_transform(offset_transform)

Setzt die Offset-Transformation des Künstlers.

Parameter:

offset_transformTransform

set_offsets(offsets)

Setzt die Offsets für die Sammlung.

Parameter:

offsets(N, 2) oder (2,) array-ähnlich

set_path_effects(path_effects)

Legt die Pfadeffekte fest.

Parameter:

path_effectsListe von AbstractPathEffect

set_paths()

set_picker(picker)

Definiert das Auswahlverhalten des Artists.

Parameter:

pickerNone oder bool oder float oder aufrufbar

Dies kann einer der folgenden sein

• None: Picking ist für diesen Künstler deaktiviert (Standard).

• Ein boolescher Wert: Wenn True, dann wird Picking aktiviert und der Künstler löst ein Pick-Ereignis aus, wenn sich das Mausereignis über dem Künstler befindet.

• Ein float: Wenn picker eine Zahl ist, wird sie als Epsilon-Toleranz in Punkten interpretiert und der Künstler löst ein Ereignis aus, wenn seine Daten innerhalb von Epsilon des Mausereignisses liegen. Für einige Künstler wie Linien und Patch-Sammlungen kann der Künstler zusätzliche Daten für das generierte Pick-Ereignis bereitstellen, z. B. die Indizes der Daten innerhalb von Epsilon des Pick-Ereignisses.

• Eine Funktion: Wenn picker aufrufbar ist, ist es eine vom Benutzer bereitgestellte Funktion, die bestimmt, ob der Künstler vom Mausereignis getroffen wird.

  hit, props = picker(artist, mouseevent)
  

  um den Treffertest zu bestimmen. Wenn sich das Mausereignis über dem Künstler befindet, geben Sie hit=True zurück und props ist ein Wörterbuch mit Eigenschaften, die Sie den Attributen von PickEvent hinzufügen möchten.

set_pickradius(pickradius)

Setzt den Pick-Radius für Containment-Tests.

Parameter:

pickradiusfloat

Pick-Radius in Punkten.

set_rasterized(rasterized)

Erzwingt das gerasterte (Bitmap-)Zeichnen für Vektorgrafikausgaben.

Rasterisierte Zeichnung wird nicht von allen Künstlern unterstützt. Wenn Sie versuchen, dies auf einem Künstler zu aktivieren, der es nicht unterstützt, hat der Befehl keine Auswirkung und eine Warnung wird ausgegeben.

Diese Einstellung wird für pixelbasierte Ausgaben ignoriert.

Siehe auch Rasterisierung für Vektorgrafiken.

Parameter:

rasterizedbool

set_sketch_params(scale=None, length=None, randomness=None)

Legt die Skizzenparameter fest.

Parameter:

scalefloat, optional

Die Amplitude der Auslenkung senkrecht zur Quelllinie in Pixeln. Wenn scale None ist oder nicht angegeben wird, wird kein Skizzenfilter bereitgestellt.

lengthfloat, optional

Die Länge des Wackelns entlang der Linie in Pixeln (Standard 128,0)

randomnessfloat, optional

Der Skalierungsfaktor, mit dem die Länge verkleinert oder vergrößert wird (Standard 16,0)

Das PGF-Backend verwendet dieses Argument als RNG-Seed und nicht wie oben beschrieben. Die Verwendung desselben Seeds ergibt die gleiche zufällige Form.

set_snap(snap)

Legt das Snapping-Verhalten fest.

Snapping richtet Positionen am Pixelraster aus, was zu klareren Bildern führt. Wenn beispielsweise eine schwarze Linie von 1px Breite an einer Position zwischen zwei Pixeln definiert war, enthält das resultierende Bild den interpolierten Wert dieser Linie im Pixelraster, der ein Grauwert an beiden benachbarten Pixelpositionen wäre. Im Gegensatz dazu verschiebt Snapping die Linie zum nächstgelegenen ganzzahligen Pixelwert, sodass das resultierende Bild tatsächlich eine 1px breite schwarze Linie enthält.

Snapping wird derzeit nur von den Backends Agg und MacOSX unterstützt.

Parameter:

snapbool oder None

Mögliche Werte

• True: Eckpunkte am nächstgelegenen Pixelzentrum ausrichten.

• False: Keine Änderung der Eckpunktpositionen.

• None: (auto) Wenn der Pfad nur rektilineare Liniensegmente enthält, auf das nächstgelegene Pixelzentrum runden.

set_transOffset(offset_transform)

Alias für set_offset_transform.

set_transform(t)

Legt die Artist-Transformation fest.

Parameter:

tTransform

set_url(url)

Legt die URL für den Artist fest.

Parameter:

urlstr

set_urls(urls)

Parameter:

urlsListe von str oder None

Anmerkungen

URLs werden derzeit nur vom SVG-Backend implementiert. Sie werden von allen anderen Backends ignoriert.

set_visible(b)

Legt die Sichtbarkeit des Artists fest.

Parameter:

bbool

set_zorder(level)

Setzt die zorder für den Künstler. Künstler mit niedrigeren zorder-Werten werden zuerst gezeichnet.

Parameter:

levelfloat

property stale

Ob der Künstler 'veraltet' ist und neu gezeichnet werden muss, damit die Ausgabe dem internen Zustand des Künstlers entspricht.

property sticky_edges

x- und y-Sticky-Kantenlisten für automatische Skalierung.

Bei der automatischen Skalierung wird, wenn ein Datenlimit mit einem Wert in der entsprechenden sticky_edges-Liste übereinstimmt, kein Rand hinzugefügt – das Ansichtslimit "klebt" am Rand. Ein typischer Anwendungsfall sind Histogramme, bei denen man normalerweise keinen Rand am unteren Rand (0) des Histogramms erwartet.

Darüber hinaus stoßen Randexpansionen gegen sticky edges und können diese nicht überschreiten. Wenn beispielsweise das obere Datenlimit 1,0 ist, das obere Ansichtslimit, das durch einfache Randanwendung berechnet wird, 1,2 ist, aber ein sticky edge bei 1,1 vorhanden ist, dann ist das tatsächliche obere Ansichtslimit 1,1.

Dieses Attribut kann nicht zugewiesen werden; die Listen x und y können jedoch bei Bedarf direkt geändert werden.

Beispiele

>>> artist.sticky_edges.x[:] = (xmin, xmax)
>>> artist.sticky_edges.y[:] = (ymin, ymax)

to_rgba(x, alpha=None, bytes=False, norm=True)

Gibt ein normalisiertes RGBA-Array zurück, das x entspricht.

Im normalen Fall ist x eine 1D- oder 2D-Sequenz von Skalaren, und das entsprechende ndarray von RGBA-Werten wird basierend auf der für diesen Colorizer eingestellten Norm und Colormap zurückgegeben.

Es gibt einen Sonderfall für die Behandlung von Bildern, die bereits RGB oder RGBA sind, wie sie möglicherweise aus einer Bilddatei gelesen wurden. Wenn x ein ndarray mit 3 Dimensionen ist und die letzte Dimension entweder 3 oder 4 ist, wird es als RGB- oder RGBA-Array behandelt und keine Zuordnung vorgenommen. Das Array kann uint8 sein, oder es kann sich um Gleitkommazahlen mit Werten im Bereich 0-1 handeln; andernfalls wird ein ValueError ausgelöst. NaN-Werte oder maskierte Elemente werden auf den Alpha-Wert 0 gesetzt. Wenn die letzte Dimension 3 ist, wird das alpha-Argument (standardmäßig 1) verwendet, um die Transparenz zu füllen. Wenn die letzte Dimension 4 ist, wird das alpha-Argument ignoriert; es ersetzt nicht die vorhandene Transparenz. Wenn die dritte Dimension nicht 3 oder 4 ist, wird ein ValueError ausgelöst.

In beiden Fällen, wenn bytes False (Standard) ist, ist das RGBA-Array ein Float im Bereich 0-1; wenn es True ist, ist das zurückgegebene RGBA-Array uint8 im Bereich 0 bis 255.

Wenn norm False ist, erfolgt keine Normalisierung der Eingabedaten, und es wird angenommen, dass sie im Bereich (0-1) liegen.

update(props)

Aktualisiert die Eigenschaften dieses Artists aus dem Wörterbuch props.

Parameter:

propsdict

update_from(other)

Kopiert Eigenschaften von other zu self.

update_scalarmappable()

Aktualisiert Farben aus dem ScalarMappable-Array, falls vorhanden.

Weist Farben Kanten und Flächen basierend auf dem Array und/oder den direkt gesetzten Farben zu, wie es angemessen ist.

zorder = 0