mpl_toolkits.mplot3d.axes3d.Axes3D

Klasse mpl_toolkits.mplot3d.axes3d. Axes3D ( fig , rect = None , * args , elev = 30 , azim = -60 , roll = 0 , sharez = None , proj_type = 'persp' , box_aspect = None , computed_zorder = True , focus_length = None , ** kwargs )

Basen:Axes

3D-Achsenobjekt.

Parameter :

Abb. Abbildung

Die Elternfigur.

Rect- Tupel (links, unten, Breite, Höhe), Standard: Keine.

Die Achsenposition.(left, bottom, width, height)

Höhenfloat , Standard: 30

Der Höhenwinkel in Grad dreht die Kamera über und unter die xy-Ebene, wobei ein positiver Winkel einer Position über der Ebene entspricht.

Azim- Float, Standard: -60

Der Azimutwinkel in Grad dreht die Kamera um die z-Achse, wobei ein positiver Winkel einer Rechtsdrehung entspricht. Mit anderen Worten, ein positiver Azimut dreht die Kamera um den Ursprung von ihrer Position entlang der +x-Achse in Richtung der +y-Achse.

Rollfloat , Standard: 0

Der Rollwinkel in Grad dreht die Kamera um die Betrachtungsachse. Ein positiver Winkel dreht die Kamera im Uhrzeigersinn, wodurch sich die Szene gegen den Uhrzeigersinn dreht.

sharez Axes3D, optional

Andere Achsen, mit denen Z-Grenzen geteilt werden können.

proj_type {'persp', 'ortho'}

Der Projektionstyp, standardmäßig „persp“.

box_aspect 3-Tupel von Gleitkommazahlen, Standard: Keine

Ändert die physikalischen Abmessungen von Axes3D, sodass das Verhältnis der Achsenlängen in Anzeigeeinheiten x:y:z ist. Wenn None, wird standardmäßig 4:4:3 verwendet

computed_zorder bool, Standard: True

Bei True wird die Zeichnungsreihenfolge basierend auf der durchschnittlichen Position der Artists entlang der Ansichtsrichtung berechnet. Legen Sie False fest, wenn Sie die Reihenfolge, in der Künstler übereinander gezeichnet werden, manuell steuern möchten, indem Sie ihr zorder- Attribut verwenden. Dies kann zur Feinabstimmung genutzt werden, wenn die automatische Bestellung nicht zum gewünschten Ergebnis führt. Beachten Sie jedoch, dass eine manuelle Zorder nur für einen begrenzten Betrachtungswinkel korrekt ist. Wenn die Figur vom Benutzer gedreht wird, sieht sie aus bestimmten Winkeln falsch aus.

auto_add_to_figure bool, Standard: False

Vor Matplotlib 3.4 fügte sich Axes3D zu ihrer Host-Figur auf init hinzu. Andere Axes-Klassen tun dies nicht.

Dieses Verhalten ist in 3.4 veraltet, der Standardwert wurde in 3.6 in False geändert. Das Schlüsselwort ist undokumentiert und ein Wert ungleich False ist ein Fehler in 3.7.

Fokallänge Float, Standard: Keine

Bei einem Projektionstyp „Persp“ die Brennweite der virtuellen Kamera. Muss > 0 sein. Wenn None, Standardwert 1. Für einen Projektionstyp „Ortho“ muss entweder None oder Unendlich (numpy.inf) festgelegt werden. Wenn keine, wird standardmäßig auf unendlich gesetzt. Die Brennweite kann aus einem gewünschten Sichtfeld über die folgende Gleichung berechnet werden: Brennweite = 1/tan(FOV/2)

**Kwarg

Weitere optionale Schlüsselwortargumente:

Eigentum	Beschreibung
adjustable	{'box', 'datalim'}
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
anchor	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalz'}
autoscale_on	bool
autoscalex_on	Unbekannt
autoscaley_on	Unbekannt
autoscalez_on	Unbekannt
axes_locator	Callable[[Achsen, Renderer], Bbox]
axisbelow	bool oder 'line'
box_aspect	3-Tupel von Floats oder None
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
facecoloroder FC	Farbe
figure	Figure
frame_on	bool
gid	Str
in_layout	bool
label	Objekt
mouseover	bool
navigate	bool
navigate_mode	Unbekannt
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
position	[links, unten, Breite, Höhe] oderBbox
proj_type	{'persp', 'ortho'}
prop_cycle	Unbekannt
rasterization_zorder	Float oder None
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
title	Unbekannt
transform	Transform
url	Str
visible	bool
xbound	Unbekannt
xlabel	Str
xlimoder xlim3d	(unten: Schwimmer, oben: Schwimmer)
xlim3d	(unten: Schwimmer, oben: Schwimmer)
xmargin	Schwimmer größer als -0,5
xscale	Unbekannt
xticklabels	Unbekannt
xticks	Unbekannt
ybound	Unbekannt
ylabel	Str
ylimoder ylim3d	(unten: Schwimmer, oben: Schwimmer)
ylim3d	(unten: Schwimmer, oben: Schwimmer)
ymargin	Schwimmer größer als -0,5
yscale	Unbekannt
yticklabels	Unbekannt
yticks	Unbekannt
zbound	Unbekannt
zlabel	Unbekannt
zlimoder zlim3d	Unbekannt
zmargin	Schwimmer größer als -0,5
zorder	schweben
zscale	Unbekannt
zticklabels	Unbekannt
zticks	Unbekannt

add_collection3d ( col , zs = 0 , zdir = 'z' )

Fügen Sie dem Diagramm ein 3D-Erfassungsobjekt hinzu.

2D-Sammlungstypen werden in eine 3D-Version konvertiert, indem das Objekt geändert und Z-Koordinateninformationen hinzugefügt werden.

Unterstützt werden:

• PolyCollection

• LineCollection

• PatchCollection

add_contour_set ( cset , extend3d = False , stride = 5 , zdir = 'z' , offset = None )

add_contourf_set ( cset , zdir = 'z' , offset = None )

apply_aspect ( position = None )

Passen Sie die Achsen für ein bestimmtes Datenseitenverhältnis an.

Abhängig get_adjustabledavon wird entweder das Achsenfeld (Position) oder die Ansichtsgrenzen geändert. Im ersteren Fall wirkt sich dies get_anchorauf die Position aus.

Parameter :

position Keine oder .Bbox

Wenn nicht None, definiert dies die Position der Achsen innerhalb der Figur als Bbox. Siehe get_position für weitere Details.

Siehe auch

matplotlib.axes.Axes.set_aspect

Für eine Beschreibung der Handhabung des Seitenverhältnisses.

matplotlib.axes.Axes.set_adjustable

Legen Sie fest, wie die Achsen angepasst werden, um das erforderliche Seitenverhältnis zu erreichen.

matplotlib.axes.Axes.set_anchor

Legen Sie die Position fest, falls zusätzlicher Platz vorhanden ist.

Anmerkungen

Dies wird automatisch aufgerufen, wenn jede Achse gezeichnet wird. Möglicherweise müssen Sie es selbst aufrufen, wenn Sie die Achsenposition aktualisieren und/oder Grenzen anzeigen müssen, bevor die Figur gezeichnet wird.

auto_scale_xyz ( X , Y , Z = None , had_data = None )

Autoskalierung ( enable = True , axis = 'both' , tight = None )

Praktische Methode für die automatische Skalierung einfacher Achsenansichten.

Siehe Axes.autoscalefür die vollständige Dokumentation. Da diese Funktion für 3D-Achsen gilt, kann die Achse auch auf „z“ gesetzt werden, und wenn die Achse auf „beide“ gesetzt wird, werden alle drei Achsen automatisch skaliert.

autoscale_view ( tight = None , scalex = True , scaley = True , scalez = True )

Skalieren Sie die Ansichtsgrenzen mithilfe der Datengrenzen automatisch.

Siehe Axes.autoscale_viewfür die vollständige Dokumentation. Da diese Funktion für 3D-Achsen gilt, nimmt sie auch ein scalez- Argument an.

bar ( left , height , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs )

2D-Balken hinzufügen.

Parameter :

links 1D-Array-ähnlich

Die x-Koordinaten der linken Seiten der Balken.

Höhe 1D-Array-ähnlich

Die Höhe der Balken.

zs Float oder 1D-Array-ähnlich

Z-Koordinate der Stäbe; Wenn ein einzelner Wert angegeben wird, wird er für alle Balken verwendet.

zdir {'x', 'y', 'z'}, Standard: 'z'

Beim Plotten von 2D-Daten die zu verwendende Richtung als z ('x', 'y' oder 'z').

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.bar.

Rückgaben :

mpl_toolkits.mplot3d.art3d.Patch3DCollection

bar3d ( x , y , z , dx , dy , dz , color = None , zsort = 'average' , shade = True , lightsource = None , * args , data = None , ** kwargs )

Generieren Sie ein 3D-Balkendiagramm.

Diese Methode erstellt ein dreidimensionales Balkendiagramm, bei dem die Breite, Tiefe, Höhe und Farbe der Balken alle eindeutig eingestellt werden können.

Parameter :

x, y, z Array-artig

Die Koordinaten des Ankerpunkts der Stäbe.

dx, dy, dz float oder arrayartig

Die Breite, Tiefe und Höhe der Balken.

Farbreihenfolge , optional

Die Farbe der Balken kann global oder individuell festgelegt werden. Dieser Parameter kann sein:

• Eine einzige Farbe, um alle Balken in derselben Farbe zu färben.

• Ein Array von Farben mit einer Länge von N Balken, um jeden Balken unabhängig zu färben.

• Ein Array von Farben der Länge 6, um die Flächen der Balken ähnlich zu färben.

• Ein Array von Farben mit einer Länge von 6 * N Balken, um jedes Gesicht unabhängig zu färben.

Wenn Sie die Flächen der Kästchen speziell färben, ist dies die Reihenfolge der Färbung:

1. -Z (unten in der Box)

2. +Z (Oberseite der Box)

3. -Y

4. +Y

5. -X

6. +X

zsort str, optional

Das z-Achsen-Sortierschema wird weitergegebenPoly3DCollection

Shade bool, Standard: True

Wenn dies wahr ist, schattiert dies die dunklen Seiten der Balken (relativ zur Lichtquelle des Plots).

LichtquelleLightSource

Die zu verwendende Lichtquelle, wenn Schatten wahr ist.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Alle zusätzlichen Schlüsselwortargumente werden an übergeben Poly3DCollection.

Rückgaben :

SammlungPoly3DCollection

Eine Sammlung dreidimensionaler Polygone, die die Balken darstellen.

can_pan ( )

Gibt zurück, ob diese Achse die Pan/Zoom-Schaltflächenfunktionalität unterstützt.

Axes3d-Objekte verwenden die Schwenk-/Zoom-Schaltfläche nicht.

can_zoom ( )

Gibt zurück, ob diese Axes die Funktionalität der Zoombox-Schaltfläche unterstützt.

Axes3D-Objekte verwenden die Zoombox-Schaltfläche nicht.

clabel ( * args , ** kwargs )

Derzeit nicht für 3D-Achsen implementiert und gibt None zurück .

löschen ( )

Säubere die Äxte.

Kontur ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein 3D-Konturdiagramm.

Parameter :

X, Y, Z Array-artig,

Eingabedaten. Informationen Axes.contourzu unterstützten Datenformen finden Sie unter.

extend3d bool, Standard: False

Ob die Kontur in 3D erweitert werden soll.

Schritt int

Schrittweite zum Verlängern der Kontur.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.contour.

Rückgaben :

matplotlib.contour.QuadContourSet

contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein 3D-Konturdiagramm.

Parameter :

X, Y, Z Array-artig,

Eingabedaten. Informationen Axes.contourzu unterstützten Datenformen finden Sie unter.

extend3d bool, Standard: False

Ob die Kontur in 3D erweitert werden soll.

Schritt int

Schrittweite zum Verlängern der Kontur.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.contour.

Rückgaben :

matplotlib.contour.QuadContourSet

contourf ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein gefülltes 3D-Konturdiagramm.

Parameter :

X, Y, Z Array-artig

Eingabedaten. Informationen Axes.contourfzu unterstützten Datenformen finden Sie unter.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.contourf.

Rückgaben :

matplotlib.contour.QuadContourSet

contourf3D ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein gefülltes 3D-Konturdiagramm.

Parameter :

X, Y, Z Array-artig

Eingabedaten. Informationen Axes.contourfzu unterstützten Datenformen finden Sie unter.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.contourf.

Rückgaben :

matplotlib.contour.QuadContourSet

convert_zunits ( z )

Konvertieren Sie z für Künstler in einer Achse, wenn die Zaxis Einheiten unterstützt, mithilfe des Zaxis-Einheitentyps

disable_mouse_rotation ( )

Deaktivieren Sie die Maustasten für 3D-Rotation und Zoomen.

Eigenschaft dist

draw ( Renderer )

Zeichnen Sie den Künstler (und seine Kinder) mit dem angegebenen Renderer.

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

Parameter :

Renderer- RendererBaseUnterklasse.

Anmerkungen

Diese Methode wird in den Artist-Unterklassen überschrieben.

errorbar ( x , y , z , zerr = None , yerr = None , xerr = None , fmt = '' , barsabove = False , errorevery = 1 , ecolor = None , elinewidth = None , capsize = None , capthick = None , xlolims = Falsch , xuplims= False , ylolims = False , yuplims = False , zlolims = False , zuplims = False , * , data = None , ** kwargs )

Zeichnen Sie Linien und/oder Markierungen mit Fehlerbalken um sie herum.

x / y / z definieren die Datenspeicherorte und xerr / yerr / zerr definieren die Fehlerbalkengrößen. Standardmäßig zeichnet dies die Datenmarker/-linien sowie die Fehlerbalken. Verwenden Sie fmt='none', um nur Fehlerbalken zu zeichnen.

Parameter :

x, y, z Float oder Array-artig

Die Datenpositionen.

xerr, yerr, zerr float oder arrayartig, Form (N,) oder (2, N), optional

Die Fehlerbalkengrößen:

• Skalar: Symmetrische +/- Werte für alle Datenpunkte.

• shape(N,): Symmetrische +/-Werte für jeden Datenpunkt.

• shape(2, N): Separate - und + Werte für jeden Balken. Die erste Reihe enthält die unteren Fehler, die zweite Reihe die oberen Fehler.

• None : Keine Fehlerleiste.

Beachten Sie, dass alle Fehlerarrays positive Werte haben sollten.

fmt str, Standard: ''

Das Format für die Datenpunkte / Datenzeilen. Siehe plotfür Details.

Verwenden Sie „none“ (Groß-/Kleinschreibung wird nicht beachtet), um Fehlerbalken ohne Datenmarkierungen zu zeichnen.

ecolor -Farbe, Standard: Keine

Die Farbe der Fehlerbalkenlinien. Wenn keine, verwenden Sie die Farbe der Linie, die die Markierungen verbindet.

elinewidth float, Standard: Keine

Die Linienbreite der Fehlerbalkenlinien. Wenn None, wird die Linienbreite des aktuellen Stils verwendet.

Float kentern , Standard: (Standard: )rcParams["errorbar.capsize"]0.0

Die Länge des Fehlerbalkens wird in Punkten begrenzt.

capthick Float, Standard: Keine

Ein Alias ​​für das Schlüsselwortargument markeredgewidth (auch bekannt als mew ). Diese Einstellung ist ein sinnvollerer Name für die Eigenschaft, die die Dicke der Fehlerbalkenkappe in Punkten steuert. Wenn mew oder markeredgewidth angegeben sind, überschreiben sie aus Gründen der Abwärtskompatibilität capthick . Dies kann sich in zukünftigen Versionen ändern.

Barsabove bool, Standard: False

Wenn True, werden die Fehlerbalken über den Diagrammsymbolen gezeichnet. Standard ist unten.

xlolims, ylolims, zlolims bool, Standard: False

Diese Argumente können verwendet werden, um anzuzeigen, dass ein Wert nur niedrigere Grenzen angibt. In diesem Fall wird ein Caret-Symbol verwendet, um dies anzuzeigen. lims -Argumente können Skalare oder Arrays sein, die dieselbe Länge wie die Fehler haben. Um Limits mit invertierten Achsen zu verwenden, muss set_xlimoder vorher aufgerufen werden . Beachten Sie die kniffligen Parameternamen: Das Setzen von zB ylolims auf True bedeutet, dass der y-Wert eine untere Grenze des True-Werts ist, also wird nur ein nach oben zeigender Pfeil gezeichnet!set_ylimerrorbar

xuplims, yuplims, zuplims bool, Standard: False

Wie oben, jedoch zur Kontrolle der Obergrenzen.

errorevery int oder (int, int), Standard: 1

zeichnet Fehlerbalken auf einer Teilmenge der Daten. errorevery =N zeichnet Fehlerbalken auf die Punkte (x[::N], y[::N], z[::N]). errorevery =(start, N) zeichnet Fehlerbalken an den Punkten (x[start::N], y[start::N], z[start::N]). zB errorevery=(6, 3) fügt Fehlerbalken zu den Daten bei (x[6], x[9], x[12], x[15], ...) hinzu. Wird verwendet, um überlappende Fehlerbalken zu vermeiden, wenn zwei Reihen gemeinsame x-Achsenwerte haben.

Rückgaben :

Fehlerliste _

Liste der Line3DCollectionInstanzen, die jeweils eine Fehlerleistenzeile enthalten.

Caplines- Liste

Liste der Line3DInstanzen, die jeweils ein capline-Objekt enthalten.

Limmarks- Liste

Liste von Line3DInstanzen, die jeweils einen Marker mit einer Ober- oder Untergrenze enthalten.

Andere Parameter :

data indexierbares Objekt, optional

Falls angegeben, akzeptieren die folgenden Parameter auch einen String s, der interpretiert wird als data[s](es sei denn, dies löst eine Ausnahme aus):

x , y , z , xerr , yerr , zerr

**Kwarg

Alle anderen Schlüsselwortargumente zum Gestalten von Fehlerbalkenzeilen werden übergeben Line3DCollection.

Beispiele

( Quellcode , png )

format_coord ( xd , yd )

Versuchen Sie anhand der 2D-Ansichtskoordinaten, eine 3D-Koordinate zu erraten. Sucht nach der nächstgelegenen Kante zum Punkt und geht dann davon aus, dass sich der Punkt an derselben z-Position wie der nächstgelegene Punkt auf der Kante befindet.

format_zdata ( z )

Z -String formatiert zurückgeben . Diese Funktion verwendet das fmt_zdataAttribut, wenn es aufrufbar ist, ansonsten greift sie auf den zaxis-Hauptformatierer zurück

get_autoscalez_on ( )

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

get_axis_position ( )

get_frame_on ( )

Ermitteln Sie, ob die 3D-Achsenfelder gezeichnet sind.

get_proj ( )

Erstellen Sie die Projektionsmatrix aus der aktuellen Betrachtungsposition.

get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False )

Geben Sie den engen Begrenzungsrahmen der Achsen zurück, einschließlich der Achse und ihrer Dekorateure (Xlabel, Titel usw.).

Künstler, die haben, artist.set_in_layout(False)sind nicht in der bbox enthalten.

Parameter :

Renderer- RendererBaseUnterklasse

Renderer, der zum Zeichnen der Figuren verwendet wird (z. B. fig.canvas.get_renderer())

bbox_extra_artists Liste von ArtistoderNone

Liste der Künstler, die in den engen Begrenzungsrahmen aufgenommen werden sollen. Wenn None(Standard), dann sind alle untergeordneten Künstler der Achsen in der engen Begrenzungsbox enthalten.

call_axes_locator bool, Standard: True

Wenn call_axes_locator gleich ist False, wird das Attribut nicht aufgerufen _axes_locator, das erforderlich ist, um den korrekten Begrenzungsrahmen zu erhalten. call_axes_locator=Falsekann verwendet werden, wenn der Anrufer nur an der relativen Größe der tightbbox im Vergleich zur Axes-bbox interessiert ist.

for_layout_only Standard: False

Der Begrenzungsrahmen enthält weder die x-Ausdehnung des Titels und des xlabels noch die y-Ausdehnung des ylabels.

Rückgaben :

BboxBase

Begrenzungsrahmen in Pixelkoordinaten der Abbildung.

Siehe auch

matplotlib.axes.Axes.get_window_extent

matplotlib.axis.Axis.get_tightbbox

matplotlib.spines.Spine.get_window_extent

get_w_lims ( )

Holen Sie sich 3D-Weltgrenzen.

get_xlim ( )

Gibt die X-Achsen-Ansichtsgrenzen zurück.

Rückgaben :

links, rechts (float, float)

Die aktuellen X-Achsen-Grenzwerte in Datenkoordinaten.

Siehe auch

Axes.set_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

Anmerkungen

Die x-Achse kann invertiert sein, in diesem Fall ist der linke Wert größer als der rechte Wert.

get_xlim3d ( )

Pseudonym für get_xlim.

get_ylim ( )

Gibt die Ansichtsgrenzen der Y-Achse zurück.

Rückgaben :

unten, oben (schweben, schweben)

Die aktuellen Grenzwerte der y-Achse in Datenkoordinaten.

Siehe auch

Axes.set_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

Anmerkungen

Die y-Achse kann invertiert werden, in diesem Fall ist der untere Wert größer als der obere Wert.

get_ylim3d ( )

Pseudonym für get_ylim.

get_zaxis ( )

Gibt die ZAxis( Axis)-Instanz zurück.

get_zbound ( )

Geben Sie die unteren und oberen Z-Achsen-Grenzen in aufsteigender Reihenfolge zurück.

get_zgridlines ( )

Gibt die Gitterlinien der zaxis als Liste von Line2Ds zurück.

get_zlabel ( )

Rufen Sie die Z-Label-Textzeichenfolge ab.

get_zlim ( )

Holen Sie sich 3D-Z-Limits.

get_zlim3d ( )

Pseudonym für get_zlim.

get_zmajorticklabels ( )

Gibt die Hauptstrichbeschriftungen der zaxis als Liste von zurück Text.

get_zminorticklabels ( )

Gibt die kleinen Tick-Beschriftungen der zaxis als Liste von zurück Text.

get_zscale ( )

Gibt die Skala der zaxis (als str) zurück.

get_zticklabels ( minor = False , which = None )

Holen Sie sich die Tick-Labels der zaxis.

Parameter :

kleiner bool

Ob die kleinen oder die großen Ticklabels zurückgegeben werden sollen.

welche Keine, ('minor', 'major', 'both')

Überschreibt Minor .

Wählt aus, welche Ticklabels zurückgegeben werden sollen

Rückgaben :

Liste vonText

get_zticklines ( minor = False )

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

get_zticks ( * , minor = False )

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

Die Positionen werden nicht auf die aktuellen Achsengrenzen zugeschnitten und können daher Positionen enthalten, die in der Ausgabe nicht sichtbar sind.

Parameter :

Minor Bool, Standard: False

True, um die kleineren Tickrichtungen zurückzugeben, False, um die großen Tickrichtungen zurückzugeben.

Rückgaben :

numpy Array von Tick-Positionen

grid ( sichtbar = True , ** kwargs )

3D-Gitter aktivieren/deaktivieren.

Notiz

Derzeit verhält sich diese Funktion nicht wie axes.Axes.grid, soll dieses Verhalten aber letztendlich unterstützen.

invert_zaxis ( )

Invertieren Sie die z-Achse.

Ränder ( * Ränder , x = None , y = None , z = None , tight = True )

Autoscaling-Ränder festlegen oder abrufen.

Siehe Axes.marginsfür die vollständige Dokumentation. Da diese Funktion für 3D-Achsen gilt, akzeptiert sie auch ein z - Argument und gibt zurück .(xmargin, ymargin, zmargin)

mouse_init ( rotate_btn = 1 , zoom_btn = 3 )

Stellen Sie die Maustasten für 3D-Rotation und Zoomen ein.

Parameter :

Rotate_btn int oder Liste von int, Standard: 1

Die Maustaste oder Tasten zur Verwendung für die 3D-Rotation der Achsen.

zoom_btn int oder Liste von int, Standard: 3

Die Maustaste oder die Tasten zum Zoomen der 3D-Achsen.

name = '3d'

plot ( xs , ys , * args , zdir = 'z' , ** kwargs )

Zeichnen Sie 2D- oder 3D-Daten.

Parameter :

xs 1D-Array-ähnlich

x-Koordinaten der Scheitelpunkte.

ys 1D-Array-ähnlich

y-Koordinaten der Eckpunkte.

zs Float oder 1D-Array-ähnlich

z-Koordinaten von Scheitelpunkten; entweder eine für alle Punkte oder eine für jeden Punkt.

zdir {'x', 'y', 'z'}, Standard: 'z'

Beim Plotten von 2D-Daten die zu verwendende Richtung als z ('x', 'y' oder 'z').

**Kwarg

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.plot.

plot3D ( xs , ys , * args , zdir = 'z' , ** kwargs )

Zeichnen Sie 2D- oder 3D-Daten.

Parameter :

xs 1D-Array-ähnlich

x-Koordinaten der Scheitelpunkte.

ys 1D-Array-ähnlich

y-Koordinaten der Eckpunkte.

zs Float oder 1D-Array-ähnlich

z-Koordinaten von Scheitelpunkten; entweder eine für alle Punkte oder eine für jeden Punkt.

zdir {'x', 'y', 'z'}, Standard: 'z'

Beim Plotten von 2D-Daten die zu verwendende Richtung als z ('x', 'y' oder 'z').

**Kwarg

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.plot.

plot_surface ( X , Y , Z , * , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs )

Erstellen Sie ein Oberflächendiagramm.

Standardmäßig wird es in Schattierungen einer Volltonfarbe gefärbt, aber es unterstützt auch die Farbzuordnung, indem es das cmap- Argument bereitstellt.

Notiz

Die rcount- und ccount- kwargs, die beide standardmäßig auf 50 eingestellt sind, bestimmen die maximale Anzahl von Samples, die in jeder Richtung verwendet werden. Wenn die Eingabedaten größer sind, werden sie (durch Slicing) auf diese Anzahl von Punkten heruntergesampelt.

Notiz

Um die Rendering-Geschwindigkeit zu maximieren, sollten Sie rstride und cstride auf Teiler der Anzahl der Zeilen minus 1 bzw. Spalten minus 1 setzen. Beispielsweise kann rstride bei 51 Zeilen ein beliebiger Teiler von 50 sein.

Ebenso kann eine Einstellung von rstride und cstride gleich 1 (oder rcount und ccount gleich der Anzahl von Zeilen und Spalten) den optimierten Pfad verwenden.

Parameter :

X, Y, Z 2D-Arrays

Datenwerte.

rcount, Konto int

Maximale Anzahl von Samples, die in jeder Richtung verwendet werden. Wenn die Eingabedaten größer sind, werden sie (durch Slicing) auf diese Anzahl von Punkten heruntergesampelt. Standardmäßig 50.

rstride, cstride int

Downsampling-Schritte in jede Richtung. Diese Argumente schließen sich bei rcount und account gegenseitig aus . Wenn nur einer von rstride oder cstride festgelegt ist, wird der andere standardmäßig auf 10 gesetzt.

Der „klassische“ Modus verwendet anstelle des neuen Standardwerts den Standardwert .rstride = cstride = 10rcount = ccount = 50

Farbe farblich

Farbe der Oberflächenflecken.

cmap Farbkarte

Farbkarte der Oberflächenpatches.

facecolors Array-ähnliche Farben.

Farben jedes einzelnen Patches.

Norm Normalisieren

Normalisierung für die Farbtabelle.

vmin, vmax Float

Grenzen für die Normalisierung.

Shade bool, Standard: True

Ob die Gesichtsfarben schattiert werden sollen. Die Schattierung ist immer deaktiviert, wenn cmap angegeben ist.

LichtquelleLightSource

Die zu verwendende Lichtquelle, wenn Schatten wahr ist.

**Kwarg

Andere Argumente werden an weitergeleitet Poly3DCollection.

plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs )

Zeichnen Sie eine triangulierte Fläche.

Die (optionale) Triangulation kann auf zwei Arten angegeben werden; entweder:

plot_trisurf(triangulation, ...)

wobei Triangulation ein TriangulationObjekt ist, oder:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

In diesem Fall wird ein Triangulationsobjekt erstellt. Siehe Triangulationfür eine Erläuterung dieser Möglichkeiten.

Die restlichen Argumente sind:

plot_trisurf(..., Z)

wobei Z das Array der zu konturierenden Werte ist, einer pro Punkt in der Triangulation.

Parameter :

X, Y, Z Array-artig

Datenwerte als 1D-Arrays.

Farbe

Farbe der Oberflächenflecken.

cmap

Eine Farbkarte für die Oberflächenpatches.

Norm Normalisieren

Eine Instanz von Normalize, um Werte Farben zuzuordnen.

vmin, vmax Float, Standard: Keine

Zuzuordnender Mindest- und Höchstwert.

Shade bool, Standard: True

Ob die Gesichtsfarben schattiert werden sollen. Die Schattierung ist immer deaktiviert, wenn cmap angegeben ist.

LichtquelleLightSource

Die zu verwendende Lichtquelle, wenn Schatten wahr ist.

**Kwarg

Alle anderen Argumente werden weitergegeben Poly3DCollection

Beispiele

( Quellcode , png )

( Quellcode , png )

plot_wireframe ( X , Y , Z , ** kwargs )

Zeichnen Sie ein 3D-Drahtmodell.

Notiz

Die rcount- und ccount- kwargs, die beide standardmäßig auf 50 eingestellt sind, bestimmen die maximale Anzahl von Samples, die in jeder Richtung verwendet werden. Wenn die Eingabedaten größer sind, werden sie (durch Slicing) auf diese Anzahl von Punkten heruntergesampelt.

Parameter :

X, Y, Z 2D-Arrays

Datenwerte.

rcount, Konto int

Maximale Anzahl von Samples, die in jeder Richtung verwendet werden. Wenn die Eingabedaten größer sind, werden sie (durch Slicing) auf diese Anzahl von Punkten heruntergesampelt. Wenn Sie einen Zähler auf Null setzen, werden die Daten nicht in der entsprechenden Richtung abgetastet, wodurch ein 3D-Liniendiagramm anstelle eines Drahtgitterdiagramms erzeugt wird. Standardmäßig 50.

rstride, cstride int

Downsampling-Schritte in jede Richtung. Diese Argumente schließen sich bei rcount und account gegenseitig aus . Wenn nur einer von rstride oder cstride eingestellt ist, wird der andere standardmäßig auf 1 gesetzt. Wenn Sie einen Schritt auf Null setzen, werden die Daten nicht in der entsprechenden Richtung abgetastet, wodurch ein 3D-Liniendiagramm anstelle eines Drahtgitterdiagramms erzeugt wird.

Der „klassische“ Modus verwendet anstelle des neuen Standardwerts den Standardwert .rstride = cstride = 1rcount = ccount = 50

**Kwarg

Andere Argumente werden an weitergeleitet Line3DCollection.

quiver ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

Zeichnen Sie ein 3D-Pfeilfeld.

Die Argumente könnten Array-ähnlich oder Skalare sein, solange sie zusammen gesendet werden können. Die Argumente können auch maskierte Arrays sein. Wenn ein Element in einem der Argumente maskiert ist, wird das entsprechende Köcherelement nicht gezeichnet.

Parameter :

X, Y, Z Array-artig

Die x-, y- und z-Koordinaten der Pfeilpositionen (Standard ist Pfeilende; siehe Pivot -Kwarg).

U, V, W Array-artig

Die x-, y- und z-Komponenten der Pfeilvektoren.

Länge Float, Standard: 1

Die Länge jedes Köchers.

arrow_length_ratio Float, Standard: 0,3

Das Verhältnis der Pfeilspitze zum Köcher.

Pivot {'Schwanz', 'Mitte', 'Spitze'}, Standard: 'Schwanz'

Der Teil des Pfeils, der sich am Rasterpunkt befindet; der Pfeil dreht sich um diesen Punkt, daher der Name Pivot .

normalize bool, Standard: False

Ob alle Pfeile so normalisiert werden, dass sie dieselbe Länge haben, oder ob die durch u , v und w definierten Längen beibehalten werden .

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Alle zusätzlichen Schlüsselwortargumente werden an delegiert LineCollection

quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs )

Zeichnen Sie ein 3D-Pfeilfeld.

Die Argumente könnten Array-ähnlich oder Skalare sein, solange sie zusammen gesendet werden können. Die Argumente können auch maskierte Arrays sein. Wenn ein Element in einem der Argumente maskiert ist, wird das entsprechende Köcherelement nicht gezeichnet.

Parameter :

X, Y, Z Array-artig

Die x-, y- und z-Koordinaten der Pfeilpositionen (Standard ist Pfeilende; siehe Pivot -Kwarg).

U, V, W Array-artig

Die x-, y- und z-Komponenten der Pfeilvektoren.

Länge Float, Standard: 1

Die Länge jedes Köchers.

arrow_length_ratio Float, Standard: 0,3

Das Verhältnis der Pfeilspitze zum Köcher.

Pivot {'Schwanz', 'Mitte', 'Spitze'}, Standard: 'Schwanz'

Der Teil des Pfeils, der sich am Rasterpunkt befindet; der Pfeil dreht sich um diesen Punkt, daher der Name Pivot .

normalize bool, Standard: False

Ob alle Pfeile so normalisiert werden, dass sie dieselbe Länge haben, oder ob die durch u , v und w definierten Längen beibehalten werden .

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Alle zusätzlichen Schlüsselwortargumente werden an delegiert LineCollection

scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , Depthshade = True , * args , data = None , ** kwargs )

Erstellen Sie ein Streudiagramm.

Parameter :

xs, ys Array-ähnlich

Die Datenpositionen.

zs Float oder Array-ähnlich, Standard: 0

Die z-Positionen. Entweder ein Array mit der gleichen Länge wie xs und ys oder ein einzelner Wert, um alle Punkte in derselben Ebene zu platzieren.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, Standard: 'z'

Die Achsenrichtung für die zs . Dies ist nützlich beim Plotten von 2D-Daten auf 3D-Achsen. Die Daten müssen als xs , ys übergeben werden . Das Setzen von zdir auf 'y' zeichnet dann die Daten in der xz-Ebene.

Siehe auch Plotten von 2D-Daten auf 3D-Plot .

s Float oder Array-ähnlich, Standard: 20

Die Markergröße in Punkten**2. Entweder ein Array mit der gleichen Länge wie xs und ys oder ein einzelner Wert, damit alle Marker die gleiche Größe haben.

c Farbe, Sequenz oder Farbsequenz, optional

Die Markierungsfarbe. Mögliche Werte:

• Eine einfarbige Formatzeichenfolge.

• Eine Folge von Farben der Länge n.

• Eine Folge von n Zahlen, die mit cmap und norm Farben zugeordnet werden sollen .

• Ein 2D-Array, in dem die Zeilen RGB oder RGBA sind.

Weitere Einzelheiten finden Sie im Argument cscatter von .

Tiefenschatten bool, Standard: True

Ob die Scatter-Marker schattiert werden sollen, um den Eindruck von Tiefe zu vermitteln. Jeder Aufruf von scatter()führt seine Tiefenschattierung unabhängig aus.

data indexierbares Objekt, optional

Falls angegeben, akzeptieren die folgenden Parameter auch einen String s, der interpretiert wird als data[s](es sei denn, dies löst eine Ausnahme aus):

xs , ys , zs , s , Kantenfarben , c , Gesichtsfarbe , Gesichtsfarben , Farbe

**Kwarg

Alle anderen Argumente werden an übergeben scatter.

Rückgaben :

PfadePathCollection

scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , Depthshade = True , * args , data = None , ** kwargs )

Erstellen Sie ein Streudiagramm.

Parameter :

xs, ys Array-ähnlich

Die Datenpositionen.

zs Float oder Array-ähnlich, Standard: 0

Die z-Positionen. Entweder ein Array mit der gleichen Länge wie xs und ys oder ein einzelner Wert, um alle Punkte in derselben Ebene zu platzieren.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, Standard: 'z'

Die Achsenrichtung für die zs . Dies ist nützlich beim Plotten von 2D-Daten auf 3D-Achsen. Die Daten müssen als xs , ys übergeben werden . Das Setzen von zdir auf 'y' zeichnet dann die Daten in der xz-Ebene.

Siehe auch Plotten von 2D-Daten auf 3D-Plot .

s Float oder Array-ähnlich, Standard: 20

Die Markergröße in Punkten**2. Entweder ein Array mit der gleichen Länge wie xs und ys oder ein einzelner Wert, damit alle Marker die gleiche Größe haben.

c Farbe, Sequenz oder Farbsequenz, optional

Die Markierungsfarbe. Mögliche Werte:

• Eine einfarbige Formatzeichenfolge.

• Eine Folge von Farben der Länge n.

• Eine Folge von n Zahlen, die mit cmap und norm Farben zugeordnet werden sollen .

• Ein 2D-Array, in dem die Zeilen RGB oder RGBA sind.

Weitere Einzelheiten finden Sie im Argument cscatter von .

Tiefenschatten bool, Standard: True

Ob die Scatter-Marker schattiert werden sollen, um den Eindruck von Tiefe zu vermitteln. Jeder Aufruf von scatter()führt seine Tiefenschattierung unabhängig aus.

data indexierbares Objekt, optional

Falls angegeben, akzeptieren die folgenden Parameter auch einen String s, der interpretiert wird als data[s](es sei denn, dies löst eine Ausnahme aus):

xs , ys , zs , s , Kantenfarben , c , Gesichtsfarbe , Gesichtsfarben , Farbe

**Kwarg

Alle anderen Argumente werden an übergeben scatter.

Rückgaben :

PfadePathCollection

set ( * , einstellbar=<UNSCHARF> , agg_filter=<UNSCHARF> , alpha=<UNSCHARF> , Anker=<UNSCHARF> , animation =<UNSCHARF> , Aspekt=<UNSCHARF> , autoscale_on=<UNSCHARF> , autoscalex_on=<UNSCHARF > , autoscaley_on =<UNSET> , autoscalez_on=<UNSET> , axis_locator=<UNSET> , axisbelow=<UNSET> , box_aspect=< UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , Gesichtsfarbe=<UNSCHARF> , frame_on=<UNSCHARF>, gid=<UNSCHARF> , in_layout=<UNSCHARF> , label=<UNSCHARF> , mouseover=<UNSCHARF> , navigation=<UNSCHARF> , path_effects=< UNSCHARF> , picker=< UNSCHARF> , position =<UNSCHARF> , proj_type =<UNSET> , prop_cycle=<UNSET> , rasterization_zorder =<UNSET> , rasterized= <UNSET> , sketch_params=<UNSET> , snap=<UNSET> , title=<UNSET> , transform=<UNSET> , url=< UNSCHARF> , sichtbar=<UNSCHARF>, xbound=<UNSET> ,xlabel=<UNSCHARF> , xlim=<UNSCHARF> , xlim3d=<UNSCHARF> , xmargin=<UNSCHARF> , xscale=<UNSCHARF> , xticklabels=<UNSCHARF> , xticks=<UNSCHARF> , ybound=<UNSCHARF> , ylabel= <UNSCHARF> , ylim=<UNSCHARF> , ylim3d=<UNSCHARF> , ymargin=<UNSCHARF> , yscale=<UNSCHARF> , yticklabels=<UNSCHARF> , yticks=<UNSCHARF> , zbound=<UNSCHARF> , zlabel=<UNSCHARF > , zlim=<UNSCHARF> , zlim3d=<UNSCHARF>, zmargin=<UNSET> ,zorder=<UNSCHARF> , zscale=<UNSCHARF> , zticklabels=<UNSCHARF> , zticks=<UNSCHARF> )

Legen Sie mehrere Eigenschaften gleichzeitig fest.

Unterstützte Eigenschaften sind

Eigentum	Beschreibung
adjustable	{'box', 'datalim'}
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
anchor	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
animated	bool
aspect	{'auto', 'equal', 'equalxy', 'equalxz', 'equalz'}
autoscale_on	bool
autoscalex_on	Unbekannt
autoscaley_on	Unbekannt
autoscalez_on	Unbekannt
axes_locator	Callable[[Achsen, Renderer], Bbox]
axisbelow	bool oder 'line'
box_aspect	3-Tupel von Floats oder None
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
facecoloroder FC	Farbe
figure	Figure
frame_on	bool
gid	Str
in_layout	bool
label	Objekt
mouseover	bool
navigate	bool
navigate_mode	Unbekannt
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
position	[links, unten, Breite, Höhe] oderBbox
proj_type	{'persp', 'ortho'}
prop_cycle	Unbekannt
rasterization_zorder	Float oder None
rasterized	bool
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
title	Unbekannt
transform	Transform
url	Str
visible	bool
xbound	Unbekannt
xlabel	Str
xlim	(unten: Schwimmer, oben: Schwimmer)
xlim3d	(unten: Schwimmer, oben: Schwimmer)
xmargin	Schwimmer größer als -0,5
xscale	Unbekannt
xticklabels	Unbekannt
xticks	Unbekannt
ybound	Unbekannt
ylabel	Str
ylim	(unten: Schwimmer, oben: Schwimmer)
ylim3d	(unten: Schwimmer, oben: Schwimmer)
ymargin	Schwimmer größer als -0,5
yscale	Unbekannt
yticklabels	Unbekannt
yticks	Unbekannt
zbound	Unbekannt
zlabel	Unbekannt
zlim	Unbekannt
zlim3d	Unbekannt
zmargin	Schwimmer größer als -0,5
zorder	schweben
zscale	Unbekannt
zticklabels	Unbekannt
zticks	Unbekannt

set_aspect ( Aspekt , anpassbar = None , Anker = None , Share = False )

Stellen Sie die Seitenverhältnisse ein.

Parameter :

Aspekt {'auto', 'equal', 'equalxy', 'equalxz', 'equalz'}

Mögliche Werte:

Wert	Bezeichnung
'Auto'	automatisch; Füllen Sie das Positionsrechteck mit Daten.
'gleich'	Passen Sie alle Achsen an, um gleiche Seitenverhältnisse zu haben.
'equalxy'	Passen Sie die x- und y-Achsen an, um gleiche Seitenverhältnisse zu haben.
'equalxz'	Passen Sie die x- und z-Achsen an, um gleiche Seitenverhältnisse zu haben.
'Equaliz'	Passen Sie die y- und z-Achsen an, um gleiche Seitenverhältnisse zu haben.

einstellbar Keine

Derzeit von Axes3D ignoriert

Wenn nicht None , definiert dies, welcher Parameter angepasst wird, um den erforderlichen Aspekt zu erfüllen. Siehe set_adjustablefür weitere Details.

Anker Keine oder Str oder 2-Tupel von Float, optional

Wenn nicht None , definiert dies, wo die Achsen gezeichnet werden, wenn aufgrund von Aspektbeschränkungen zusätzlicher Platz vorhanden ist. Die gebräuchlichste Art, den Anker anzugeben, sind Abkürzungen von Himmelsrichtungen:

Wert	Bezeichnung
'C'	zentriert
'SW'	untere linke Ecke
'S'	Mitte des unteren Randes
'SE'	untere rechte Ecke
usw.

Siehe set_anchorfür weitere Details.

Share bool, Standard: False

Wenn True, wenden Sie die Einstellungen auf alle gemeinsam genutzten Achsen an.

Siehe auch

mpl_toolkits.mplot3d.axes3d.Axes3D.set_box_aspect

set_autoscalez_on ( b )

Legen Sie fest, ob die Z-Achse beim Zeichnen automatisch skaliert wird oder um Axes.autoscale_view.

Parameter :

b bool

set_axis_off ( )

Schalten Sie die x- und y-Achse aus.

Dies wirkt sich auf die Achsenlinien, Ticks, Ticklabels, Gitter und Achsenbeschriftungen aus.

set_axis_on ( )

Schalten Sie die x- und y-Achse ein.

Dies wirkt sich auf die Achsenlinien, Ticks, Ticklabels, Gitter und Achsenbeschriftungen aus.

set_box_aspect ( Aspekt , * , Zoom = 1 )

Stellen Sie das Aussehen des Achsenfelds ein.

Der Kastenaspekt ist das Verhältnis von Höhe zu Breite in Anzeigeeinheiten für jede Seite des Kastens, wenn er senkrecht zu dieser Seite betrachtet wird. Dies ist nicht mit dem Datenaspekt zu verwechseln (der für Axes3D immer 'auto' ist). Die Standardverhältnisse sind 4:4:3 (x:y:z).

Um einen gleichen Aspekt im Datenraum zu simulieren, stellen Sie den Box-Aspekt so ein, dass er Ihrem Datenbereich in jeder Dimension entspricht.

Zoom steuert die Gesamtgröße von Axes3D in der Abbildung.

Parameter :

Aspekt 3-Tupel von Floats oder None

Ändert die physikalischen Abmessungen von Axes3D, sodass das Verhältnis der Achsenlängen in Anzeigeeinheiten x:y:z ist. Wenn keine, wird standardmäßig (4,4,3) verwendet.

Zoom Float, Standard: 1

Kontrollieren Sie die Gesamtgröße des Axes3D in der Abbildung. Muss > 0 sein.

set_frame_on ( b )

Legen Sie fest, ob die 3D-Achsenfelder gezeichnet werden.

Parameter :

b bool

set_proj_type ( proj_type , focus_length = None )

Stellen Sie den Projektionstyp ein.

Parameter :

proj_type {'persp', 'ortho'}

Der Projektionstyp.

Fokallänge Float, Standard: Keine

Bei einem Projektionstyp „Persp“ die Brennweite der virtuellen Kamera. Muss > 0 sein. Wenn None, Standardwert 1. Die Brennweite kann aus einem gewünschten Sichtfeld über die folgende Gleichung berechnet werden: Brennweite = 1/tan(FOV/2)

set_title ( label , fontdict = None , loc = 'center' , ** kwargs )

Legen Sie einen Titel für die Achsen fest.

Stellen Sie einen der drei verfügbaren Axes-Titel ein. Die verfügbaren Titel sind über den Achsen in der Mitte positioniert, bündig mit dem linken Rand und bündig mit dem rechten Rand.

Parameter :

Etikettenstr _

Text, der für den Titel verwendet werden soll

fontdict dict

Ein Wörterbuch, das das Erscheinungsbild des Titeltexts steuert, das Standard -Fontdict ist:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

loc {'Mitte', 'links', 'rechts'}, Standard: rcParams["axes.titlelocation"](Standard: 'center')

Welcher Titel soll eingestellt werden.

y Float, Standard: rcParams["axes.titley"](Standard: None)

Position der vertikalen Achsen für den Titel (1.0 ist oben). Wenn None (der Standard) und rcParams["axes.titley"](Standard: None) ebenfalls None ist, wird y automatisch bestimmt, um Decorators auf den Achsen zu vermeiden.

Pad Float, Standard: rcParams["axes.titlepad"](Standard: 6.0)

Der Versatz des Titels von der Oberkante der Achsen in Punkten.

Rückgaben :

Text

Die Matplotlib-Textinstanz, die den Titel darstellt

Andere Parameter :

**kwargs- TextEigenschaften

Andere Schlüsselwortargumente sind Texteigenschaften, siehe Textfür eine Liste gültiger Texteigenschaften.

set_top_view ( )

set_xlim3d ( left = None , right = None , * , emit = True , auto = False , xmin = None , xmax = None )

Legen Sie die Anzeigegrenzen für die X-Achse fest.

Parameter :

linker Schwimmer, optional

Das linke xlim in Datenkoordinaten. Das Übergeben von None lässt das Limit unverändert.

Die linken und rechten Xlims können auch als Tupel ( left , right ) als erstes Positionsargument (oder als linkes Schlüsselwortargument) übergeben werden.

rechter Schwimmer, optional

Das rechte xlim in Datenkoordinaten. Das Übergeben von None lässt das Limit unverändert.

Bool ausgeben , Standard: True

Ob Beobachter über Grenzwertänderungen benachrichtigt werden sollen.

auto bool oder None, Standard: False

Ob die automatische Skalierung der x-Achse aktiviert werden soll. True schaltet sich ein, False schaltet sich aus, None bleibt unverändert.

xmin, xmax Float, optional

Sie entsprechen left bzw. right, und es ist ein Fehler, sowohl xmin als auch left oder xmax und right zu übergeben .

Rückgaben :

links, rechts (float, float)

Die neuen X-Achsen-Grenzwerte in Datenkoordinaten.

Siehe auch

get_xlim

set_xbound,get_xbound

invert_xaxis,xaxis_inverted

Anmerkungen

Der linke Wert kann größer als der rechte Wert sein, in diesem Fall nehmen die x-Achsenwerte von links nach rechts ab.

Beispiele

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

Eine Grenze kann unverändert bleiben.

>>> set_xlim(right=right_lim)

Grenzwerte können in umgekehrter Reihenfolge übergeben werden, um die Richtung der x-Achse umzukehren. Angenommen, x steht beispielsweise für die Anzahl der Jahre vor der Gegenwart. Die X-Achsen-Grenzwerte können wie folgt eingestellt werden, so dass „vor 5000 Jahren“ auf der linken Seite des Diagramms und die Gegenwart auf der rechten Seite ist.

>>> set_xlim(5000, 0)

set_xscale ( value , ** kwargs )

Legen Sie die Skalierung der x-Achse fest.

Parameter :

Wert {"linear"}

Der anzuwendende Achsenskalierungstyp. 3D-Achsen unterstützen derzeit nur lineare Skalen; andere Skalen liefern unsinnige Ergebnisse.

**Kwarg

Schlüsselwortargumente werden nominell an die Skalenklasse weitergeleitet, aber keines davon ist auf lineare Skalen anwendbar.

set_ylim3d ( bottom = None , top = None , * , emit = True , auto = False , ymin = None , ymax = None )

Legen Sie die Anzeigegrenzen für die Y-Achse fest.

Parameter :

Bodenschwimmer , optional

Das untere Ylim in Datenkoordinaten. Das Übergeben von None lässt das Limit unverändert.

Die unteren und oberen Ylims können auch als Tupel ( bottom , top ) als erstes Positionsargument (oder als unteres Schlüsselwortargument) übergeben werden.

Oberschwimmer , optional

Das oberste Ylim in Datenkoordinaten. Das Übergeben von None lässt das Limit unverändert.

Bool ausgeben , Standard: True

Ob Beobachter über Grenzwertänderungen benachrichtigt werden sollen.

auto bool oder None, Standard: False

Ob die automatische Skalierung der Y-Achse aktiviert werden soll. True schaltet sich ein, False schaltet sich aus, None bleibt unverändert.

ymin, ymax Float, optional

Sie entsprechen jeweils bottom und top, und es ist ein Fehler, sowohl ymin als auch bottom oder ymax und top zu übergeben .

Rückgaben :

unten, oben (schweben, schweben)

Die neuen y-Achsen-Grenzwerte in Datenkoordinaten.

Siehe auch

get_ylim

set_ybound,get_ybound

invert_yaxis,yaxis_inverted

Anmerkungen

Der untere Wert kann größer als der obere Wert sein, in diesem Fall nehmen die Werte auf der y-Achse von unten nach oben ab .

Beispiele

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

Eine Grenze kann unverändert bleiben.

>>> set_ylim(top=top_lim)

Grenzwerte können in umgekehrter Reihenfolge übergeben werden, um die Richtung der y-Achse umzukehren. Nehmen wir zum Beispiel an, dass ydie Tiefe des Ozeans in m steht. Die y-Achsen-Grenzwerte können wie folgt eingestellt werden, sodass sich 5000 m Tiefe am unteren Rand des Diagramms und die Oberfläche, 0 m, oben befindet.

>>> set_ylim(5000, 0)

set_yscale ( value , ** kwargs )

Legen Sie die Skala der y-Achse fest.

Parameter :

Wert {"linear"}

Der anzuwendende Achsenskalierungstyp. 3D-Achsen unterstützen derzeit nur lineare Skalen; andere Skalen liefern unsinnige Ergebnisse.

**Kwarg

Schlüsselwortargumente werden nominell an die Skalenklasse weitergeleitet, aber keines davon ist auf lineare Skalen anwendbar.

set_zbound ( untere = Keine , obere = Keine )

Legen Sie die unteren und oberen numerischen Grenzen der z-Achse fest.

Diese Methode berücksichtigt die Achsenumkehrung unabhängig von der Parameterreihenfolge. Die Autoscaling-Einstellung ( get_autoscalez_on()) wird dadurch nicht geändert.

set_zlabel ( zlabel , fontdict = None , labelpad = None , ** kwargs )

zlabel setzen. Siehe doc für set_ylabeleine Beschreibung.

set_zlim ( bottom = None , top = None , * , emit = True , auto = False , zmin = None , zmax = None )

Legen Sie 3D-Z-Grenzen fest.

Siehe Axes.set_ylimfür die vollständige Dokumentation

set_zlim3d ( bottom = None , top = None , * , emit = True , auto = False , zmin = None , zmax = None )

Pseudonym für set_zlim.

set_zmargin ( m )

Legen Sie das Auffüllen der Z-Datengrenzen vor der automatischen Skalierung fest.

Das m -fache des Datenintervalls wird an jedem Ende dieses Intervalls hinzugefügt, bevor es bei der automatischen Skalierung verwendet wird. Wenn m negativ ist, wird der Datenbereich abgeschnitten, anstatt ihn zu erweitern.

Wenn Ihre Daten beispielsweise im Bereich [0, 2] liegen, führt eine Spanne von 0,1 zu einem Bereich [-0,2, 2,2]; eine Spanne von -0,1 ergibt einen Bereich von [0,2, 1,8].

Parameter :

m Float größer als -0,5

set_zscale ( value , ** kwargs )

Stellen Sie die Skalierung der z-Achse ein.

Parameter :

Wert {"linear"}

Der anzuwendende Achsenskalierungstyp. 3D-Achsen unterstützen derzeit nur lineare Skalen; andere Skalen liefern unsinnige Ergebnisse.

**Kwarg

Schlüsselwortargumente werden nominell an die Skalenklasse weitergeleitet, aber keines davon ist auf lineare Skalen anwendbar.

set_zticklabels ( labels , * , fontdict = None , minor = False , ** kwargs )

Legen Sie die Zaxis-Labels mit einer Liste von String-Labels fest.

Warnung

Diese Methode sollte nur verwendet werden, nachdem die Tick-Positionen mit fixiert wurden Axes3D.set_zticks. Andernfalls können die Etiketten an unerwarteten Positionen landen.

Parameter :

Etikettenliste von str

Die Etikettentexte.

fontdict dict, optional

Ein Wörterbuch, das das Aussehen der Ticklabels steuert. Das Standardfontdict ist :

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}

Minor Bool, Standard: False

Ob die kleineren Ticklabels anstelle der großen gesetzt werden sollen.

Rückgaben :

Liste vonText

Die Etiketten.

Andere Parameter :

**kwargs- TextEigenschaften.

set_zticks ( Ticks , Labels = None , * , Minor = False , ** Kwargs )

Legen Sie die Tick-Positionen und optionalen Beschriftungen der Zaxis fest.

Bei Bedarf werden die Sichtgrenzen der Achse erweitert, sodass alle angegebenen Ticks sichtbar sind.

Parameter :

Ticks Liste von Floats

Liste der Zeckenstandorte. Die Achse Locatorwird durch ein ersetzt FixedLocator.

Einige Tick-Formatierer beschriften keine beliebigen Tick-Positionen; zB beschriften Protokollformatierer standardmäßig nur Dekadenticks. In einem solchen Fall können Sie mit explizit einen Formatierer auf die Achse setzen Axis.set_major_formatteroder selbst formatierte Beschriftungen bereitstellen .

Etikettenliste von str, optional

Liste der Tick-Labels. Wenn nicht gesetzt, werden die Beschriftungen mit dem Achsentick generiert Formatter.

Minor Bool, Standard: False

Wenn False, setze die großen Häkchen; wenn True, tickt der Moll.

**Kwarg

TextEigenschaften für die Etiketten. Diese werden nur wirksam, wenn Sie Labels übergeben . In anderen Fällen verwenden Sie bitte tick_params.

Anmerkungen

Die obligatorische Erweiterung der Sichtgrenzen ist eine bewusste Designentscheidung, um die Überraschung eines nicht sichtbaren Häkchens zu vermeiden. Wenn Sie andere Limits benötigen, sollten Sie die Limits explizit nach dem Setzen der Häkchen setzen.

sharez ( andere )

Teilen Sie die z-Achse mit anderen .

Dies entspricht dem Übergeben sharex=otherbeim Erstellen der Achsen und kann nicht verwendet werden, wenn die z-Achse bereits mit anderen Achsen geteilt wird.

stem ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , direction = 'z' , data = None )

Erstellen Sie ein 3D-Stammdiagramm.

Ein Stammdiagramm zeichnet Linien senkrecht zu einer Grundlinie und platziert Markierungen an den Köpfen. Standardmäßig wird die Grundlinie durch x und y definiert , und Stiele werden vertikal von unten nach z gezeichnet .

Parameter :

x, y, z Array-artig

Die Positionen der Köpfe der Stiele. Die Stiele werden entlang der Orientierungsrichtung von der Grundlinie unten (in der Orientierungskoordinate ) zu den Köpfen gezeichnet. Standardmäßig werden die x- und y - Positionen für die Grundlinie und z für die Kopfposition verwendet, dies kann jedoch durch Ausrichtung geändert werden .

linefmt str, Standard: 'C0-'

Eine Zeichenfolge, die die Eigenschaften der vertikalen Linien definiert. Normalerweise ist dies eine Farbe oder eine Farbe und ein Linienstil:

Charakter	Linienstil
'-'	durchgezogene Linie
'--'	gestrichelte Linie
'-.'	Strichpunktlinie
':'	gepunktete Linie

Hinweis: Obwohl es technisch möglich ist, andere gültige Formate als Farbe oder Farbe und Linienstil anzugeben (z. B. „rx“ oder „-.“), geht dies über die Absicht der Methode hinaus und wird höchstwahrscheinlich nicht zu einem vernünftigen Plot führen.

markerfmt str, Standard: 'C0o'

Eine Zeichenfolge, die die Eigenschaften der Markierungen an den Stielköpfen definiert.

basefmt str, Standard: 'C3-'

Eine Formatzeichenfolge, die die Eigenschaften der Baseline definiert.

unterer Float, Standard: 0

Die Position der Grundlinie in Orientierungskoordinaten .

label str, Standard: Keine

Die Beschriftung, die für die Stiele in Legenden verwendet werden soll.

Ausrichtung {'x', 'y', 'z'}, Standard: 'z'

Die Richtung, entlang der Stiele gezeichnet werden.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

Rückgaben :

StemContainer

Der Container kann wie ein Tupel behandelt werden ( markerline , stemlines , baseline )

Beispiele

( Quellcode , png )

( png )

( png )

stem3D ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , direction = 'z' , data = None )

Erstellen Sie ein 3D-Stammdiagramm.

Ein Stammdiagramm zeichnet Linien senkrecht zu einer Grundlinie und platziert Markierungen an den Köpfen. Standardmäßig wird die Grundlinie durch x und y definiert , und Stiele werden vertikal von unten nach z gezeichnet .

Parameter :

x, y, z Array-artig

Die Positionen der Köpfe der Stiele. Die Stiele werden entlang der Orientierungsrichtung von der Grundlinie unten (in der Orientierungskoordinate ) zu den Köpfen gezeichnet. Standardmäßig werden die x- und y - Positionen für die Grundlinie und z für die Kopfposition verwendet, dies kann jedoch durch Ausrichtung geändert werden .

linefmt str, Standard: 'C0-'

Eine Zeichenfolge, die die Eigenschaften der vertikalen Linien definiert. Normalerweise ist dies eine Farbe oder eine Farbe und ein Linienstil:

Charakter	Linienstil
'-'	durchgezogene Linie
'--'	gestrichelte Linie
'-.'	Strichpunktlinie
':'	gepunktete Linie

Hinweis: Obwohl es technisch möglich ist, andere gültige Formate als Farbe oder Farbe und Linienstil anzugeben (z. B. „rx“ oder „-.“), geht dies über die Absicht der Methode hinaus und wird höchstwahrscheinlich nicht zu einem vernünftigen Plot führen.

markerfmt str, Standard: 'C0o'

Eine Zeichenfolge, die die Eigenschaften der Markierungen an den Stielköpfen definiert.

basefmt str, Standard: 'C3-'

Eine Formatzeichenfolge, die die Eigenschaften der Baseline definiert.

unterer Float, Standard: 0

Die Position der Grundlinie in Orientierungskoordinaten .

label str, Standard: Keine

Die Beschriftung, die für die Stiele in Legenden verwendet werden soll.

Ausrichtung {'x', 'y', 'z'}, Standard: 'z'

Die Richtung, entlang der Stiele gezeichnet werden.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

Rückgaben :

StemContainer

Der Container kann wie ein Tupel behandelt werden ( markerline , stemlines , baseline )

Beispiele

( Quellcode , png )

( png )

( png )

text ( x , y , z , s , zdir = None , ** kwargs )

Fügen Sie dem Diagramm Text hinzu. kwargs werden an Axes.text weitergegeben, mit Ausnahme des Schlüsselworts zdir , das die Richtung festlegt, die als z-Richtung verwendet werden soll.

text2D ( x , y , s , fontdict = None , ** kwargs )

Fügen Sie den Achsen Text hinzu.

Fügen Sie den Text s zu den Achsen an Position x , y in Datenkoordinaten hinzu.

Parameter :

x, y schweben

Die Position, an der der Text platziert werden soll. Standardmäßig ist dies in Datenkoordinaten. Das Koordinatensystem kann mit dem Transformationsparameter geändert werden .

s -str

Der Text.

fontdict dict, Standard: Keine

Ein Wörterbuch zum Überschreiben der Standardtexteigenschaften. Wenn fontdict None ist, werden die Standardwerte durch bestimmt rcParams.

Rückgaben :

Text

Die erstellte TextInstanz.

Andere Parameter :

**kwargs- TextEigenschaften.

Andere verschiedene Textparameter.

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Skalar oder Keine
animated	bool
backgroundcolor	Farbe
bbox	Diktat mit Eigenschaften fürpatches.FancyBboxPatch
clip_box	Unbekannt
clip_on	Unbekannt
clip_path	Unbekannt
coloroder c	Farbe
figure	Figure
fontfamilyoder Familie	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesoder font oder font_properties	font_manager.FontPropertiesoder stroderpathlib.Path
fontsizeoder Größe	float oder {'xx-klein', 'x-klein', 'klein', 'mittel', 'groß', 'x-groß', 'xx-groß'}
fontstretchoder dehnen	{ein numerischer Wert im Bereich 0-1000, 'ultra-kondensiert', 'extra-kondensiert', 'kondensiert', 'semi-kondensiert', 'normal', 'semi-expanded', 'expanded', 'extra-expanded ', 'ultra-erweitert'}
fontstyleoder Stil	{'normal', 'kursiv', 'schräg'}
fontvariantoder Variante	{'normal', 'Small-Caps'}
fontweightoder Gewicht	{ein numerischer Wert im Bereich 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'fett', 'schwer', 'extra fett', 'schwarz'}
gid	Str
horizontalalignmentoder ha	{'links', 'mitte', 'rechts'}
in_layout	bool
label	Objekt
linespacing	Float (Vielfaches der Schriftgröße)
math_fontfamily	Str
mouseover	bool
multialignmentoder ma	{'links', 'rechts', 'Mitte'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None oder bool oder float oder aufrufbar
position	(schweben, schweben)
rasterized	bool
rotation	float oder {'vertikal', 'horizontal'}
rotation_mode	{Keine, 'Standard', 'Anker'}
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
text	Objekt
transform	Transform
transform_rotates_text	bool
url	Str
usetex	bool oder Keine
verticalalignmentoder va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	schweben
y	schweben
zorder	schweben

Beispiele

Einzelne Schlüsselwortargumente können verwendet werden, um jeden gegebenen Parameter zu überschreiben:

>>> text(x, y, s, fontsize=12)

Die Standardtransformation gibt an, dass sich Text in Datenkoordinaten befindet, alternativ können Sie Text in Achsenkoordinaten angeben ((0, 0) ist unten links und (1, 1) ist oben rechts). Das folgende Beispiel platziert Text in der Mitte der Achsen:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Sie können eine rechteckige Box um die Textinstanz legen (zB um eine Hintergrundfarbe festzulegen), indem Sie das Schlüsselwort bbox verwenden . bbox ist ein Wörterbuch von Rectangle Eigenschaften. Zum Beispiel:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

text3D ( x , y , z , s , zdir = None , ** kwargs )

Fügen Sie dem Diagramm Text hinzu. kwargs werden an Axes.text weitergegeben, mit Ausnahme des Schlüsselworts zdir , das die Richtung festlegt, die als z-Richtung verwendet werden soll.

tick_params ( axis = 'both' , ** kwargs )

Praktische Methode zum Ändern des Aussehens von Häkchen und Häkchenbeschriftungen.

Siehe Axes.tick_paramsfür die vollständige Dokumentation. Da diese Funktion für 3D-Achsen gilt, kann die Achse auch auf „z“ gesetzt werden, und wenn die Achse auf „beide“ gesetzt wird, werden alle drei Achsen automatisch skaliert.

Da Axes3D-Objekte sehr unterschiedlich von normalen 2D-Achsen gezeichnet werden, haben einige dieser Einstellungen möglicherweise eine mehrdeutige Bedeutung. Der Einfachheit halber akzeptiert die 'z'-Achse Einstellungen, als wäre sie wie die 'y'-Achse.

Notiz

Axes3D ignoriert derzeit einige dieser Einstellungen.

tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein 3D-Konturdiagramm.

Notiz

Diese Methode erzeugt derzeit aufgrund eines seit langem bestehenden Fehlers im 3D-PolyCollection-Rendering eine falsche Ausgabe.

Parameter :

X, Y, Z Array-artig

Eingabedaten. Informationen Axes.tricontourzu unterstützten Datenformen finden Sie unter.

extend3d bool, Standard: False

Ob die Kontur in 3D erweitert werden soll.

Schritt int

Schrittweite zum Verlängern der Kontur.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.tricontour.

Rückgaben :

matplotlib.tri.tricontour.TriContourSet

tricontourf ( * args , zdir = 'z' , offset = None , data = None , ** kwargs )

Erstellen Sie ein gefülltes 3D-Konturdiagramm.

Notiz

Diese Methode erzeugt derzeit aufgrund eines seit langem bestehenden Fehlers im 3D-PolyCollection-Rendering eine falsche Ausgabe.

Parameter :

X, Y, Z Array-artig

Eingabedaten. Informationen Axes.tricontourfzu unterstützten Datenformen finden Sie unter.

zdir {'x', 'y', 'z'}, Standard: 'z'

Die zu verwendende Richtung.

Offset -Float, optional

Falls angegeben, zeichnen Sie eine Projektion der Höhenlinien an dieser Position in einer Ebene senkrecht zu zdir.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

*args, **kwargs

Andere Argumente werden an weitergeleitet matplotlib.axes.Axes.tricontourf.

Rückgaben :

matplotlib.tri.tricontour.TriContourSet

tunit_cube ( vals = None , M = None )

tunit_edges ( vals = None , M = None )

unit_cube ( vals = None )

update_datalim ( xys , ** kwargs )

Erweitern Sie die dataLimBbox um die angegebenen Punkte.

Wenn derzeit keine Daten gesetzt sind, ignoriert die Bbox ihre Grenzen und setzt die Grenze auf die Grenzen der xydata ( xys ). Andernfalls berechnet es die Grenzen der Vereinigung seiner aktuellen Daten und der Daten in xys .

Parameter :

xys 2D-Array-ähnlich

Die Punkte, die in die Datengrenzen Bbox aufgenommen werden sollen. Dies kann entweder eine Liste von (x, y)-Tupeln oder ein Nx2-Array sein.

updatex, updatey bool, Standard: True

Ob die x/y-Grenzwerte aktualisiert werden sollen.

view_init ( elev = None , azim = None , roll = None , vertical_axis = 'z' )

Stellen Sie die Höhe und den Azimut der Achsen in Grad (nicht im Bogenmaß) ein.

Dies kann verwendet werden, um die Achsen programmgesteuert zu drehen.

Um normal zu den Primärebenen zu schauen, können die folgenden Elevations- und Azimutwinkel verwendet werden. Ein Rollwinkel von 0, 90, 180 oder 270 Grad dreht diese Ansichten, während die Achsen im rechten Winkel bleiben.

Ebene ansehen	Höhe	Azim
XY	90	-90
XZ	0	-90
YZ	0	0
-XY	-90	90
-XZ	0	90
-YZ	0	180

Parameter :

elev Float, Standard: Keine

Der Höhenwinkel in Grad dreht die Kamera über der Ebene, die von der vertikalen Achse durchbohrt wird, wobei ein positiver Winkel einer Position über dieser Ebene entspricht. Mit der standardmäßigen vertikalen Achse „z“ definiert die Höhe beispielsweise den Winkel der Kameraposition über der xy-Ebene. Axes3D Wenn None, wird der im Konstruktor angegebene Anfangswert verwendet.

Azim Float, Standard: Keine

Der Azimutwinkel in Grad dreht die Kamera um die vertikale Achse, wobei ein positiver Winkel einer Rechtsdrehung entspricht. Bei der standardmäßigen vertikalen Achse „z“ beispielsweise dreht ein positiver Azimut die Kamera um den Ursprung von ihrer Position entlang der +x-Achse in Richtung der +y-Achse. Axes3D Wenn None, wird der im Konstruktor angegebene Anfangswert verwendet.

roll float, Standard: Keine

Der Rollwinkel in Grad dreht die Kamera um die Betrachtungsachse. Ein positiver Winkel dreht die Kamera im Uhrzeigersinn, wodurch sich die Szene gegen den Uhrzeigersinn dreht. Axes3D Wenn None, wird der im Konstruktor angegebene Anfangswert verwendet.

vertikale_achse {"z", "x", "y"}, Standard: "z"

Die vertikal auszurichtende Achse. Azim rotiert um diese Achse.

Voxel ( [ x , y , z , ] / , gefüllt , facecolors=None , edgecolors=None , **kwargs )

Zeichnen Sie einen Satz gefüllter Voxel

Alle Voxel werden als 1x1x1-Würfel auf der Achse aufgetragen, wobei sie mit ihrer unteren Ecke am Ursprung platziert werden. Verdeckte Flächen werden nicht geplottet.filled[0, 0, 0]

Parameter :

gefülltes 3D np.array of bool

Ein 3D-Array von Werten mit Wahrheitswerten, die angeben, welche Voxel gefüllt werden sollen

x, y, z 3D-NP-Array, optional

Die Koordinaten der Ecken der Voxel. Dies sollte zu einer Form übertragen werden, die in jeder Dimension um eins größer ist als die Form der gefüllten . Diese können verwendet werden, um nicht-kubische Voxel darzustellen.

Wenn nicht angegeben, werden standardmäßig ganze Zahlen entlang jeder Achse erhöht, wie die von zurückgegebenen indices(). Wie durch das /in der Funktionssignatur angegeben, können diese Argumente nur positionsbezogen übergeben werden.

facecolors, edgecolors arrayartig , optional

Die Farbe zum Zeichnen der Flächen und Kanten der Voxel. Kann nur als Schlüsselwortargument übergeben werden. Diese Parameter können sein:

• Ein einzelner Farbwert, um alle Voxel in derselben Farbe einzufärben. Dies kann entweder eine Zeichenfolge oder ein 1D-rgb/rgba-Array sein

• None, die Standardeinstellung, um eine einzelne Farbe für die Flächen zu verwenden, und die Stilvorgabe für die Kanten.

• Ein 3D-Array mit Farbnamen, wobei jedes Element die Farbe für das entsprechende Voxel enthält. Die Größe muss zu den Voxeln passen.

• Ein 4D-Darray von RGB/RGBA-Daten mit den Komponenten entlang der letzten Achse.

Shade bool, Standard: True

Ob die Gesichtsfarben schattiert werden sollen. Die Schattierung ist immer deaktiviert, wenn cmap angegeben ist.

LichtquelleLightSource

Die zu verwendende Lichtquelle, wenn Schatten wahr ist.

**Kwarg

Zusätzliche Schlüsselwortargumente, die an übergeben werden sollen Poly3DCollection.

Rückgaben :

Gesichter dict

Ein nach Koordinaten indiziertes Wörterbuch, wobei a der für das Voxel gezeichneten Flächen ist . Wenn für ein bestimmtes Voxel keine Flächen gezeichnet wurden, entweder weil es nicht zum Zeichnen aufgefordert wurde oder weil es vollständig verdeckt ist, dann .faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

Beispiele

( Quellcode , png )

( Quellcode , png )

( Quellcode , png )

( Quellcode , png )

Eigenschaft w_xaxis

Eigenschaft w_yaxis

Eigenschaft w_zaxis

zaxis_date ( tz = None )

Richten Sie Achsenstriche und Beschriftungen ein, um Daten entlang der Z-Achse als Datum zu behandeln.

Parameter :

tz str oder datetime.tzinfo, Standard: rcParams["timezone"](Standard: 'UTC')

Die zum Erstellen von Datumslabels verwendete Zeitzone.

Anmerkungen

Diese Funktion wird lediglich der Vollständigkeit halber bereitgestellt, aber 3D-Achsen unterstützen keine Datumsangaben für Ticks, sodass dies möglicherweise nicht wie erwartet funktioniert.

zaxis_inverted ( )

Gibt True zurück, wenn die Z-Achse invertiert ist.