matplotlib.axes#

Die Klasse Axes repräsentiert eine einzelne (Teil-)Grafik in einer Figur. Sie enthält die geplotteten Daten, Achsenbeschriftungen, Titel, Legenden usw. Ihre Methoden sind die Hauptschnittstelle zur Manipulation der Grafik.

Die Axes-Klasse#

Axes

Ein Axes-Objekt kapselt alle Elemente einer einzelnen (Teil-)Grafik in einer Figur.

Attribute#

Axes.viewLim

Die Ansichtsgrenzen als Bbox in Datenkoordinaten.

Axes.dataLim

Die umschließende Bbox, die alle im Axes dargestellten Daten umschließt.

Axes.spines

Der Spines-Container für die Spines des Axes, d.h. die Linien, die die Grenzen des Datenbereichs bezeichnen.

Plotten#

Grundlegend#

Axes.plot

Zeichnet y gegen x als Linien und/oder Markierungen.

Axes.errorbar

Plottet y gegen x als Linien und/oder Markierungen mit angehängten Fehlerbalken.

Axes.scatter

Ein Streudiagramm von y gegen.

Axes.plot_date

[Veraltet] Plottet, indem die Achse gezwungen wird, Fließkommazahlen als Daten zu behandeln.

Axes.step

Erzeugt einen Stufenplot.

Axes.loglog

Erzeugt einen Plot mit logarithmischer Skalierung auf der x- und y-Achse.

Axes.semilogx

Erzeugt einen Plot mit logarithmischer Skalierung auf der x-Achse.

Axes.semilogy

Erzeugt einen Plot mit logarithmischer Skalierung auf der y-Achse.

Axes.fill_between

Füllt den Bereich zwischen zwei horizontalen Kurven.

Axes.fill_betweenx

Füllt den Bereich zwischen zwei vertikalen Kurven.

Axes.bar

Erzeugt ein Balkendiagramm.

Axes.barh

Erzeugt ein horizontales Balkendiagramm.

Axes.bar_label

Beschriftet ein Balkendiagramm.

Axes.stem

Erzeugt einen Stielplot.

Axes.eventplot

Plottet identische parallele Linien an den angegebenen Positionen.

Axes.pie

Erzeugt ein Tortendiagramm.

Axes.stackplot

Zeichnet ein gestapeltes Flächendiagramm oder ein Streamgraph.

Axes.broken_barh

Plottet eine horizontale Sequenz von Rechtecken.

Axes.vlines

Plottet vertikale Linien bei jedem x von ymin bis ymax.

Axes.hlines

Plottet horizontale Linien bei jedem y von xmin bis xmax.

Axes.fill

Plottet gefüllte Polygone.

Spannen#

Axes.axhline

Fügt eine horizontale Linie hinzu, die den gesamten oder einen Bruchteil des Axes überspannt.

Axes.axhspan

Fügt eine horizontale Spanne (Rechteck) über den Axes hinzu.

Axes.axvline

Fügt eine vertikale Linie hinzu, die den gesamten oder einen Bruchteil des Axes überspannt.

Axes.axvspan

Fügt eine vertikale Spanne (Rechteck) über den Axes hinzu.

Axes.axline

Fügt eine unendlich lange gerade Linie hinzu.

Spektral#

Axes.acorr

Plottet die Autokorrelation von x.

Axes.angle_spectrum

Plottet das Winkelspektrum.

Axes.cohere

Plottet die Kohärenz zwischen x und y.

Axes.csd

Plottet die Kreuzspektraldichte.

Axes.magnitude_spectrum

Plottet das Magnitudenspektrum.

Axes.phase_spectrum

Plottet das Phasenspektrum.

Axes.psd

Plottet die Leistungsdichtespektrum.

Axes.specgram

Plottet ein Spektrogramm.

Axes.xcorr

Plottet die Kreuzkorrelation zwischen x und y.

Statistik#

Axes.ecdf

Berechnet und plottet die empirische kumulative Verteilungsfunktion von x.

Axes.boxplot

Zeichnet ein Box-Whisker-Diagramm.

Axes.violinplot

Erstellt ein Violinen-Diagramm.

Axes.bxp

Zeichnet ein Box-Whisker-Diagramm aus voremporechneten Statistiken.

Axes.violin

Zeichnet ein Violinen-Diagramm aus voremporechneten Statistiken.

Geclustert#

Axes.hexbin

Erstellt ein 2D-Hexagonal-Binning-Diagramm von Punkten x, y.

Axes.hist

Berechnet und plottet ein Histogramm.

Axes.hist2d

Erstellt ein 2D-Histogramm.

Axes.stairs

Zeichnet eine schrittweise konstante Funktion als Linie oder gefüllten Plot.

Konturen#

Axes.clabel

Beschriftet einen Konturplot.

Axes.contour

Plottet Konturlinien.

Axes.contourf

Plottet gefüllte Konturen.

2D-Arrays#

Axes.imshow

Zeigt Daten als Bild an, d.h. auf einem 2D-regulären Raster.

Axes.matshow

Plottet die Werte einer 2D-Matrix oder eines Arrays als farbkodiertes Bild.

Axes.pcolor

Erstellt einen Pseudofarben-Plot mit einem nicht-regulären rechteckigen Gitter.

Axes.pcolorfast

Erstellt einen Pseudofarben-Plot mit einem nicht-regulären rechteckigen Gitter.

Axes.pcolormesh

Erstellt einen Pseudofarben-Plot mit einem nicht-regulären rechteckigen Gitter.

Axes.spy

Plottet das Sparsity-Muster eines 2D-Arrays.

Unstrukturierte Dreiecke#

Axes.tripcolor

Erstellt einen Pseudofarben-Plot eines unstrukturierten Dreiecksgitters.

Axes.triplot

Zeichnet ein unstrukturiertes Dreiecksgitter als Linien und/oder Markierungen.

Axes.tricontour

Zeichnet Konturlinien auf einem unstrukturierten Dreiecksgitter.

Axes.tricontourf

Zeichnet Konturbereiche auf einem unstrukturierten Dreiecksgitter.

Text und Anmerkungen#

Axes.annotate

Annotiert den Punkt xy mit dem Text text.

Axes.text

Fügt Text zum Axes hinzu.

Axes.table

Fügt eine Tabelle zu einem Axes hinzu.

Axes.arrow

[Abgeraten] Fügt einen Pfeil zum Axes hinzu.

Axes.inset_axes

Fügt diesem bestehenden Axes einen untergeordneten inset Axes hinzu.

Axes.indicate_inset

Fügt dem Axes einen inset-Indikator hinzu.

Axes.indicate_inset_zoom

Fügt dem Axes ein inset-Indikatorrechteck hinzu, das auf den Achsenbegrenzungen für einen inset_ax basiert, und zeichnet Verbindungen zwischen inset_ax und dem Rechteck.

Axes.secondary_xaxis

Fügt diesem Axes eine zweite x-Achse hinzu.

Axes.secondary_yaxis

Fügt diesem Axes eine zweite y-Achse hinzu.

Vektorfelder#

Axes.barbs

Plottet ein 2D-Feld von Windfahnen.

Axes.quiver

Plottet ein 2D-Feld von Pfeilen.

Axes.quiverkey

Fügt einem Quiver-Plot eine Legende hinzu.

Axes.streamplot

Zeichnet Stromlinien eines Vektorflusses.

Löschen#

Axes.cla

Löscht den Axes.

Axes.clear

Löscht den Axes.

Erscheinungsbild#

Axes.axis

Bequemlichkeitsmethode zum Abrufen oder Setzen einiger Achseneigenschaften.

Axes.set_axis_off

Verbirgt alle visuellen Komponenten der x- und y-Achse.

Axes.set_axis_on

Verbirgt nicht alle visuellen Komponenten der x- und y-Achse.

Axes.set_frame_on

Setzt, ob das Rechteck-Patch des Axes gezeichnet wird.

Axes.get_frame_on

Ruft ab, ob das Rechteck-Patch des Axes gezeichnet wird.

Axes.set_axisbelow

Setzt, ob Achsen-Ticks und Gitterlinien über oder unter den meisten Künstlern liegen.

Axes.get_axisbelow

Ruft ab, ob Achsen-Ticks und Gitterlinien über oder unter den meisten Künstlern liegen.

Axes.grid

Konfiguriert die Gitterlinien.

Axes.get_facecolor

Ruft die Füllfarbe des Axes ab.

Axes.set_facecolor

Setzt die Füllfarbe des Axes.

Eigenschaftszyklus#

Axes.set_prop_cycle

Setzt den Eigenschaftszyklus des Axes.

Achse / Grenzen#

Achsenzugriff#

Axes.xaxis

Die XAxis-Instanz.

Axes.yaxis

Die YAxis-Instanz.

Axes.get_xaxis

[Abgeraten] Gibt die XAxis-Instanz zurück.

Axes.get_yaxis

[Abgeraten] Gibt die YAxis-Instanz zurück.

Achsen- und Richtungsbegrenzungen#

Axes.invert_xaxis

Kehrt die x-Achse um.

Axes.xaxis_inverted

Gibt zurück, ob die x-Achse in die "inverse" Richtung ausgerichtet ist.

Axes.invert_yaxis

Kehrt die y-Achse um.

Axes.yaxis_inverted

Gibt zurück, ob die y-Achse in die "inverse" Richtung ausgerichtet ist.

Axes.set_xlim

Setzt die Sichtgrenzen der x-Achse.

Axes.get_xlim

Gibt die Sichtgrenzen der x-Achse zurück.

Axes.set_ylim

Setzt die Sichtgrenzen der y-Achse.

Axes.get_ylim

Gibt die Sichtgrenzen der y-Achse zurück.

Axes.update_datalim

Erweitert die dataLim Bbox, um die gegebenen Punkte einzuschließen.

Axes.set_xbound

Setzt die untere und obere numerische Grenze der x-Achse.

Axes.get_xbound

Gibt die unteren und oberen Grenzen der x-Achse in aufsteigender Reihenfolge zurück.

Axes.set_ybound

Setzt die untere und obere numerische Grenze der y-Achse.

Axes.get_ybound

Gibt die unteren und oberen Grenzen der y-Achse in aufsteigender Reihenfolge zurück.

Achsenbeschriftungen, Titel und Legende#

Axes.set_xlabel

Setzt die Beschriftung für die x-Achse.

Axes.get_xlabel

Ruft den Textstring der x-Achsenbeschriftung ab.

Axes.set_ylabel

Setzt die Beschriftung für die y-Achse.

Axes.get_ylabel

Ruft den Textstring der y-Achsenbeschriftung ab.

Axes.label_outer

Zeigt nur "äußere" Beschriftungen und Tick-Beschriftungen an.

Axes.set_title

Setzt einen Titel für den Axes.

Axes.get_title

Ruft einen Achsentitel ab.

Axes.legend

Platziert eine Legende im Axes.

Axes.get_legend

Gibt die Legend-Instanz zurück oder None, wenn keine Legende definiert ist.

Axes.get_legend_handles_labels

Gibt Handles und Beschriftungen für die Legende zurück

Achsenskalen#

Axes.set_xscale

Setzt die Skala der x-Achse.

Axes.get_xscale

Gibt die Skala der x-Achse zurück (als String).

Axes.set_yscale

Setzt die Skala der y-Achse.

Axes.get_yscale

Gibt die Skala der y-Achse zurück (als String).

Automatische Skalierung und Ränder#

Axes.use_sticky_edges

Ob beim automatischen Skalieren alle Artist.sticky_edges berücksichtigt werden.

Axes.margins

Setzt oder ruft Ränder um die Daten für die automatische Skalierung der Achsenbegrenzungen ab.

Axes.get_xmargin

Ruft den automatischen Skalierungsrand der x-Achse ab.

Axes.get_ymargin

Ruft den automatischen Skalierungsrand der y-Achse ab.

Axes.set_xmargin

Setzt den Abstand der x-Datenbegrenzungen vor der automatischen Skalierung.

Axes.set_ymargin

Setzt den Abstand der y-Datenbegrenzungen vor der automatischen Skalierung.

Axes.relim

Berechnet die Datengrenzen basierend auf den aktuellen Künstlern neu.

Axes.autoscale

Skaliert die Achsenansicht automatisch auf die Daten (umschalten).

Axes.autoscale_view

Skaliert die Ansichtsgrenzen automatisch anhand der Datengrenzen.

Axes.set_autoscale_on

Setzt, ob die automatische Skalierung auf jede Achse beim nächsten Zeichnen oder Aufruf von Axes.autoscale_view angewendet wird.

Axes.get_autoscale_on

Gibt True zurück, wenn jede Achse automatisch skaliert wird, andernfalls False.

Axes.set_autoscalex_on

Setzt, ob die x-Achse beim Zeichnen oder durch Axes.autoscale_view automatisch skaliert wird.

Axes.get_autoscalex_on

Gibt zurück, ob die x-Achse automatisch skaliert wird.

Axes.set_autoscaley_on

Setzt, ob die y-Achse beim Zeichnen oder durch Axes.autoscale_view automatisch skaliert wird.

Axes.get_autoscaley_on

Gibt zurück, ob die y-Achse automatisch skaliert wird.

Seitenverhältnis#

Axes.apply_aspect

Passt den Axes für ein bestimmtes Daten-Seitenverhältnis an.

Axes.set_aspect

Setzt das Seitenverhältnis der Achsenskalierung, d.h. y/x-Skala.

Axes.get_aspect

Gibt das Seitenverhältnis der Achsenskalierung zurück.

Axes.set_box_aspect

Setzt das Seitenverhältnis der Achsenbox, d.h. das Verhältnis von Höhe zu Breite.

Axes.get_box_aspect

Gibt das Seitenverhältnis der Achsenbox zurück, d.h. das Verhältnis von Höhe zu Breite.

Axes.set_adjustable

Legt fest, wie der Axes angepasst wird, um das erforderliche Seitenverhältnis zu erreichen.

Axes.get_adjustable

Gibt zurück, ob der Axes seine physische Dimension ('box') oder seine Datengrenzen ('datalim') anpasst, um das gewünschte Seitenverhältnis zu erreichen.

Ticks und Tick-Beschriftungen#

Axes.set_xticks

Setzt die Tick-Positionen der x-Achse und optional die Tick-Beschriftungen.

Axes.get_xticks

Gibt die Tick-Positionen der x-Achse in Datenkoordinaten zurück.

Axes.set_xticklabels

[Abgeraten] Setzt die Tick-Beschriftungen der x-Achse mit einer Liste von Zeichenkettenbeschriftungen.

Axes.get_xticklabels

Ruft die Tick-Beschriftungen der x-Achse ab.

Axes.get_xmajorticklabels

Gibt die Haupt-Tick-Beschriftungen der x-Achse als Liste von Text-Objekten zurück.

Axes.get_xminorticklabels

Gibt die Neben-Tick-Beschriftungen der x-Achse als Liste von Text-Objekten zurück.

Axes.get_xgridlines

Gibt die Gitterlinien der x-Achse als Liste von Line2Ds zurück.

Axes.get_xticklines

Gibt die Tick-Linien der x-Achse als Liste von Line2Ds zurück.

Axes.xaxis_date

Konfiguriert die Achsen-Ticks und -Beschriftungen so, dass Daten entlang der x-Achse als Daten behandelt werden.

Axes.set_yticks

Setzt die Tick-Positionen der y-Achse und optional die Tick-Beschriftungen.

Axes.get_yticks

Gibt die Tick-Positionen der y-Achse in Datenkoordinaten zurück.

Axes.set_yticklabels

[Abgeraten] Setzt die Tick-Beschriftungen der y-Achse mit einer Liste von Zeichenkettenbeschriftungen.

Axes.get_yticklabels

Ruft die Tick-Beschriftungen der y-Achse ab.

Axes.get_ymajorticklabels

Gibt die Haupt-Tick-Beschriftungen der y-Achse als Liste von Text-Objekten zurück.

Axes.get_yminorticklabels

Gibt die Neben-Tick-Beschriftungen der y-Achse als Liste von Text-Objekten zurück.

Axes.get_ygridlines

Gibt die Gitterlinien der y-Achse als Liste von Line2Ds zurück.

Axes.get_yticklines

Gibt die Tick-Linien der y-Achse als Liste von Line2Ds zurück.

Axes.yaxis_date

Konfiguriert die Achsen-Ticks und -Beschriftungen so, dass Daten entlang der y-Achse als Daten behandelt werden.

Axes.minorticks_off

Entfernt Neben-Ticks vom Axes.

Axes.minorticks_on

Zeigt Neben-Ticks auf dem Axes an.

Axes.ticklabel_format

Konfiguriert den ScalarFormatter, der standardmäßig für lineare Axes verwendet wird.

Axes.tick_params

Ändert das Erscheinungsbild von Ticks, Tick-Beschriftungen und Gitterlinien.

Axes.locator_params

Steuert das Verhalten von Haupt-Tick-Locators.

Einheiten#

Axes.convert_xunits

Konvertiert x unter Verwendung des Einheitentyps der x-Achse.

Axes.convert_yunits

Konvertiert y unter Verwendung des Einheitentyps der y-Achse.

Axes.have_units

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

Hinzufügen von Künstlern#

Axes.add_artist

Fügt einen Artist zum Axes hinzu; gibt den Künstler zurück.

Axes.add_child_axes

Fügt dem Kind-Axes einen Axes hinzu; gibt den Kind-Axes zurück.

Axes.add_collection

Fügt dem Axes eine Collection hinzu; gibt die Collection zurück.

Axes.add_container

Fügt dem Container des Axes einen Container hinzu; gibt den Container zurück.

Axes.add_image

Fügt dem Axes ein AxesImage hinzu; gibt das Bild zurück.

Axes.add_line

Fügt dem Axes eine Line2D hinzu; gibt die Linie zurück.

Axes.add_patch

Fügt dem Axes einen Patch hinzu; gibt das Patch zurück.

Axes.add_table

Fügt dem Axes eine Table hinzu; gibt die Tabelle zurück.

Twinning und Teilen#

Axes.twinx

Erstellt einen Zwillings-Axes, der die x-Achse teilt.

Axes.twiny

Erstellt einen Zwillings-Axes, der die y-Achse teilt.

Axes.sharex

Teilt die x-Achse mit other.

Axes.sharey

Teilt die y-Achse mit other.

Axes.get_shared_x_axes

Gibt eine unveränderliche Ansicht des shared x-axes Grouper zurück.

Axes.get_shared_y_axes

Gibt eine unveränderliche Ansicht des shared y-axes Grouper zurück.

Achsenposition#

Axes.get_anchor

Ruft den Ankerpunkt ab.

Axes.set_anchor

Definiert den Ankerpunkt.

Axes.get_axes_locator

Gibt den Axes-Locator zurück.

Axes.set_axes_locator

Setzt den Axes-Locator.

Axes.get_subplotspec

Gibt die SubplotSpec zurück, die dem Subplot zugeordnet ist, oder None.

Axes.set_subplotspec

Setzt die SubplotSpec.

Axes.reset_position

Setzt die aktive Position auf die ursprüngliche Position zurück.

Axes.get_position

Gibt die Position des Axes innerhalb der Figur als Bbox zurück.

Axes.set_position

Setzt die Position des Axes.

Asynchron/Event-basiert#

Axes.stale

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

Axes.pchanged

Ruft alle registrierten Callbacks auf.

Axes.add_callback

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

Axes.remove_callback

Entfernt einen Callback basierend auf seiner Observer-ID.

Interaktiv#

Axes.can_pan

Gibt zurück, ob dieser Axes eine Schwenk-/Zoom-Button-Funktionalität unterstützt.

Axes.can_zoom

Gibt zurück, ob dieser Axes die Zoom-Box-Button-Funktionalität unterstützt.

Axes.get_navigate

Ruft ab, ob der Axes auf Navigationsbefehle reagiert.

Axes.set_navigate

Legt fest, ob der Axes auf Befehle der Navigations-Symbolleiste reagiert.

Axes.get_navigate_mode

Ruft den Status der Navigations-Symbolleiste ab: 'PAN', 'ZOOM' oder None.

Axes.set_navigate_mode

Setzt den Status der Navigations-Symbolleiste.

Axes.get_forward_navigation_events

Ruft ab, wie Schwenk-/Zoom-Ereignisse an Axes unterhalb dieser weitergeleitet werden.

Axes.set_forward_navigation_events

Legt fest, wie Schwenk-/Zoom-Ereignisse an Axes unterhalb dieser weitergeleitet werden.

Axes.start_pan

Wird aufgerufen, wenn ein Schwenkvorgang gestartet wurde.

Axes.drag_pan

Wird aufgerufen, wenn sich die Maus während eines Schwenkvorgangs bewegt.

Axes.end_pan

Wird aufgerufen, wenn ein Schwenkvorgang abgeschlossen ist (wenn die Maustaste losgelassen wird).

Axes.format_coord

Gibt eine Formatierungszeichenkette für die x-, y-Koordinaten zurück.

Axes.format_cursor_data

Gibt eine Zeichenkettendarstellung von data zurück.

Axes.format_xdata

Gibt x als x-Wert formatiert zurück.

Axes.format_ydata

Gibt y als y-Wert formatiert zurück.

Axes.mouseover

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

Axes.in_axes

Gibt zurück, ob das gegebene Ereignis (in Anzeigekoordinaten) im Axes liegt.

Axes.contains

Testet, ob der Künstler das Mausereignis enthält.

Axes.contains_point

Gibt zurück, ob point (Paar von Pixelkoordinaten) innerhalb des Axes-Patches liegt.

Axes.get_cursor_data

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

Kinder#

Axes.get_children

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

Axes.get_images

Gibt eine Liste der im Axes enthaltenen AxesImages zurück.

Axes.get_lines

Gibt eine Liste der im Axes enthaltenen Linien zurück.

Axes.findobj

Findet Künstlerobjekte.

Zeichnen#

Axes.draw

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

Axes.draw_artist

Zeichnet einen einzelnen Künstler effizient neu.

Axes.redraw_in_frame

Zeichnet die Achsendaten effizient neu, aber nicht Achsen-Ticks, Beschriftungen usw.

Axes.get_rasterization_zorder

Gibt den zorder-Wert zurück, unter dem Künstler rasterisiert werden.

Axes.set_rasterization_zorder

Setzt den zorder-Schwellenwert für die Rasterisierung für Vektorgrafikausgaben.

Axes.get_window_extent

Gibt die Bounding Box des Axes im Anzeigebereich zurück.

Axes.get_tightbbox

Gibt die eng anliegende Bounding Box des Axes zurück, einschließlich der Achsen und ihrer Dekorationen (xlabel, title, etc).

Projektion#

Methoden, die von Axis verwendet werden und für nicht-rechteckige Axes überschrieben werden müssen.

Axes.name

Axes.get_xaxis_transform

Ruft die Transformation ab, die zum Zeichnen von X-Achsen-Beschriftungen, Ticks und Gitterlinien verwendet wird.

Axes.get_yaxis_transform

Ruft die Transformation ab, die zum Zeichnen von Y-Achsen-Beschriftungen, Ticks und Gitterlinien verwendet wird.

Axes.get_data_ratio

Gibt das Seitenverhältnis der skalierten Daten zurück.

Axes.get_xaxis_text1_transform

Axes.get_xaxis_text2_transform

Axes.get_yaxis_text1_transform

Axes.get_yaxis_text2_transform

Andere#

Axes.zorder

Axes.get_default_bbox_extra_artists

Gibt eine Standardliste von Künstlern zurück, die für die Berechnung der Begrenzungsbox verwendet werden.

Axes.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.

Axes.has_data

Gibt zurück, ob dem Achsenobjekt Künstler hinzugefügt wurden.

Axes.set

Setzt mehrere Eigenschaften auf einmal.

Axes.remove

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

class matplotlib.axes.Axes.ArtistList(axes, prop_name, valid_types=None, invalid_types=None)#

Eine Unterliste von Achsen-Kindern, basierend auf ihrem Typ.

Die typenspezifischen Unterlisten von Kindern wurden in Matplotlib 3.7 unveränderlich gemacht. In Zukunft können diese Künstlerlisten durch Tupel ersetzt werden. Verwenden Sie sie so, als wären sie bereits ein Tupel.

Parameter:
axesAxes

Das Achsenobjekt, aus dem diese Unterliste die Künstler-Kinder ziehen wird.

prop_namestr

Der Eigenschaftsname, der zum Zugriff auf diese Unterliste aus den Achsen verwendet wird; wird zur Generierung von Deprecation-Warnungen verwendet.

valid_typeslist of type, optional

Eine Liste von Typen, die bestimmen, welche Kinder von dieser Unterliste zurückgegeben werden. Wenn angegeben, müssen die Künstler in der Unterliste Instanzen eines dieser Typen sein. Wenn nicht angegeben, ist jeder Typ von Künstler gültig (sofern nicht durch invalid_types eingeschränkt).

invalid_typestuple, optional

Eine Liste von Typen, die bestimmen, welche Kinder von dieser Unterliste *nicht* zurückgegeben werden. Wenn angegeben, sind die Künstler in der Unterliste niemals Instanzen dieser Typen. Andernfalls werden keine Typen ausgeschlossen.