mpl_toolkits.mplot3d.axes3d.Axes3D#

class mpl_toolkits.mplot3d.axes3d.Axes3D(fig, rect=None, *args, elev=30, azim=-60, roll=0, shareview=None, sharez=None, proj_type='persp', focal_length=None, box_aspect=None, computed_zorder=True, **kwargs)[Quelle]#

Bases: Axes

3D-Achsen-Objekt.

Hinweis

Als Benutzer instanziieren Sie Achsen nicht direkt, sondern verwenden stattdessen Achsenerstellungsmethoden; z.B. aus pyplot oder Figure: subplots, subplot_mosaic oder Figure.add_axes.

Parameter:

figFigure

Die Elternfigur.

recttuple (links, unten, breite, höhe), Standard: None.

Die Achsenposition (links, unten, breite, höhe).

elevfloat, Standard: 30

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

azimfloat, Standard: -60

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

rollfloat, Standard: 0

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

shareviewAxes3D, optional

Andere Achsen, mit denen Ansichtswinkel geteilt werden sollen. Beachten Sie, dass es nicht möglich ist, Achsen zu entkoppeln.

sharezAxes3D, optional

Andere Achsen, mit denen z-Limits geteilt werden sollen. Beachten Sie, dass es nicht möglich ist, Achsen zu entkoppeln.

proj_type{'persp', 'ortho'}

Der Projektionstyp, Standard ist 'persp'.

focal_lengthfloat, Standard: None

Für den Projektionstyp 'persp' die Brennweite der virtuellen Kamera. Muss > 0 sein. Wenn None, ist der Standardwert 1. Für den Projektionstyp 'ortho' muss dies entweder auf None oder auf Unendlich (numpy.inf) gesetzt werden. Wenn None, ist der Standardwert Unendlich. Die Brennweite kann über die Gleichung berechnet werden: focal_length = 1/tan(FOV/2) aus einem gewünschten Sichtfeld (Field Of View).

box_aspect3-Tupel aus Gleitkommazahlen, Standard: None

Ändert die physischen Abmessungen von Axes3D, sodass das Verhältnis der Achsenlängen in Anzeigeeinheiten x:y:z ist. Wenn None, ist der Standardwert 4:4:3.

computed_zorderbool, Standard: True

Wenn True, wird die Zeichenreihenfolge basierend auf der durchschnittlichen Position der Artists entlang der Sichtrichtung berechnet. Auf False setzen, wenn Sie die Reihenfolge, in der Künstler übereinander gezeichnet werden, manuell über ihr zorder-Attribut steuern möchten. Dies kann zur Feinabstimmung verwendet werden, wenn die automatische Reihenfolge nicht das gewünschte Ergebnis liefert. Beachten Sie jedoch, dass ein manueller zorder nur für einen begrenzten Blickwinkel korrekt ist. Wenn die Figur vom Benutzer gedreht wird, sieht sie aus bestimmten Winkeln falsch aus.

Eigenschaft	Beschreibung
`adjustable`	{'box', 'datalim'}
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
`alpha`	float oder None
`anchor`	(float, float) oder {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
`animated`	bool
`aspect`	{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
`autoscale_on`	bool
`autoscalex_on`	unknown
`autoscaley_on`	unknown
`autoscalez_on`	unknown
`axes_locator`	Callable[[Axes, Renderer], Bbox]
`axisbelow`	bool oder 'line'
`box_aspect`	3-Tupel aus Gleitkommazahlen oder None
`clip_box`	`BboxBase` oder None
`clip_on`	bool
`clip_path`	Patch oder (Path, Transform) oder None
`facecolor` oder `fc`	color
`figure`	`Figure` oder `SubFigure`
`forward_navigation_events`	bool oder "auto"
`gid`	str
`in_layout`	bool
`label`	object
`mouseover`	bool
`navigate`	bool
`navigate_mode`	unknown
`path_effects`	Liste von `AbstractPathEffect`
`picker`	None oder bool oder float oder callable
`position`	[links, unten, breite, höhe] oder `Bbox`
`proj_type`	{'persp', 'ortho'}
`prop_cycle`	`Cycler`
`rasterization_zorder`	float oder None
`rasterized`	bool
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool oder None
`subplotspec`	unknown
`title`	unknown
`transform`	`Transform`
`url`	str
`visible`	bool
`xbound`	unknown
`xlabel`	str
`xlim` oder `xlim3d`	(left: float, right: float)
`xmargin`	float größer als -0.5
`xscale`	unknown
`xticklabels`	unknown
`xticks`	unknown
`ybound`	unknown
`ylabel`	str
`ylim` oder `ylim3d`	(bottom: float, top: float)
`ymargin`	float größer als -0.5
`yscale`	unknown
`yticklabels`	unknown
`yticks`	unknown
`zbound`	unknown
`zlabel`	unknown
`zlim` oder `zlim3d`	(bottom: float, top: float)
`zmargin`	float größer als -0.5
`zorder`	float
`zscale`	unknown
`zticklabels`	unknown
`zticks`	unknown

`plot`	2D- oder 3D-Daten plotten.
`scatter`	Streudiagramm erstellen.
`bar`	2D-Balken hinzufügen.
`bar3d`	Generiert ein 3D-Balkendiagramm.
`plot_surface`	Erstellt ein Oberflächenplot.
`plot_wireframe`	Plottet einen 3D-Drahtgitter.
`plot_trisurf`	Plottet eine triangulierte Oberfläche.
`fill_between`	Füllt den Bereich zwischen zwei 3D-Kurven.
`clabel`	Derzeit nicht für 3D-Achsen implementiert und gibt None zurück.
`contour`	Erstellt einen 3D-Konturplot.
`tricontour`	Erstellt einen 3D-Konturplot.
`contourf`	Erstellt einen 3D-gefüllten Konturplot.
`tricontourf`	Erstellt einen 3D-gefüllten Konturplot.
`quiver`	Plottet ein 3D-Pfeilfeld.
`voxels`	Plottet eine Reihe von gefüllten Voxeln.
`errorbar`	Zeichnet Linien und/oder Markierungen mit Fehlerbalken.
`stem`	Erstellt ein 3D-Stammplot.

`text`	Fügt den Text s an der Position x, y, z in Datenkoordinaten zu den 3D-Achsen hinzu.
`text2D`	Fügt Text zum Axes hinzu.

`set_axis_off`	Verbirgt alle visuellen Komponenten der x- und y-Achse.
`set_axis_on`	Verbirgt nicht alle visuellen Komponenten der x- und y-Achse.
`grid`	3D-Raster setzen / entfernen.

`get_zaxis`	Gibt die `ZAxis` (`Axis`) Instanz zurück.
`get_xlim`	Gibt die Sichtgrenzen der x-Achse zurück.
`set_xlim`	Setzt die 3D-X-Achsen-Ansichtslimits.
`get_ylim`	Gibt die Sichtgrenzen der y-Achse zurück.
`set_ylim`	Setzt die 3D-Y-Achsen-Ansichtslimits.
`get_zlim`	Gibt die 3D-Z-Achsen-Ansichtslimits zurück.
`set_zlim`	Setzt die 3D-Z-Achsen-Ansichtslimits.
`get_w_lims`	3D-Weltlimits abrufen.
`invert_xaxis`	Kehrt die x-Achse um.
`xaxis_inverted`	Gibt zurück, ob die x-Achse in die "inverse" Richtung ausgerichtet ist.
`invert_yaxis`	Kehrt die y-Achse um.
`yaxis_inverted`	Gibt zurück, ob die y-Achse in die "inverse" Richtung ausgerichtet ist.
`invert_zaxis`	Kehrt die Z-Achse um.
`zaxis_inverted`	Gibt zurück, ob die Z-Achse in die "umgekehrte" Richtung orientiert ist.
`get_xbound`	Gibt die unteren und oberen Grenzen der x-Achse in aufsteigender Reihenfolge zurück.
`set_xbound`	Setzt die untere und obere numerische Grenze der x-Achse.
`get_ybound`	Gibt die unteren und oberen Grenzen der y-Achse in aufsteigender Reihenfolge zurück.
`set_ybound`	Setzt die untere und obere numerische Grenze der y-Achse.
`get_zbound`	Gibt die unteren und oberen Z-Achsen-Grenzen in aufsteigender Reihenfolge zurück.
`set_zbound`	Legt die unteren und oberen numerischen Grenzen der Z-Achse fest.

`set_zlabel`	Z-Achsenbeschriftung setzen.
`get_zlabel`	Ruft den Z-Achsenbeschriftungstext ab.
`set_title`	Setzt einen Titel für den Axes.

`set_xscale`	Setzt die X-Achsenskala.
`set_yscale`	Setzt die Y-Achsenskala.
`set_zscale`	Setzt die Z-Achsenskala.
`get_zscale`	Gibt die Skala der Z-Achse zurück (als Zeichenkette).

`get_zmargin`	Ruft den Autoskalierungsrand der Z-Achse ab.
`set_zmargin`	Legt den Abstand der Z-Datenlimits vor der Autoskalierung fest.
`margins`	Setzt oder ruft Autoskalierungsränder ab.
`autoscale`	Hilfsmethode für einfache Achsenansicht-Autoskalierung.
`autoscale_view`	Skaliert die Ansichtsgrenzen automatisch anhand der Datengrenzen.
`set_autoscalez_on`	Legt fest, ob die Z-Achse beim Zeichnen oder von `Axes.autoscale_view` autoskaliert wird.
`get_autoscalez_on`	Gibt zurück, ob die Z-Achse autoskaliert wird.
`auto_scale_xyz`

`set_aspect`	Setzt die Seitenverhältnisse.
`set_box_aspect`	Setzt das Achsen-Box-Seitenverhältnis.
`apply_aspect`	Passt den Axes für ein bestimmtes Daten-Seitenverhältnis an.

`tick_params`	Hilfsmethode zum Ändern des Erscheinungsbilds von Ticks und Tick-Labels.
`set_zticks`	Legt die Positionen der Z-Achsen-Ticks und optional die Tick-Labels fest.
`get_zticks`	Gibt die Z-Achsen-Tick-Positionen in Datenkoordinaten zurück.
`set_zticklabels`	[Nicht empfohlen] Setzt die Z-Achsen-Tick-Labels mit einer Liste von Zeichenketten-Labels.
`get_zticklines`	Gibt die Z-Achsen-Tick-Linien als Liste von `Line2D`s zurück.
`get_zgridlines`	Gibt die Z-Achsen-Gitterlinien als Liste von `Line2D`s zurück.
`get_zminorticklabels`	Gibt die Z-Achsen-Kleinstintervall-Ticks-Labels als Liste von `Text` zurück.
`get_zmajorticklabels`	Gibt die Z-Achsen-Hauptintervall-Ticks-Labels als Liste von `Text` zurück.
`zaxis_date`	Richtet Tick-Positionen und -Beschriftungen ein, um Daten entlang der Z-Achse als Daten zu behandeln.

`sharez`	Teilt die Z-Achse mit other.
`shareview`	Teilt die Ansichtswinkel mit other.

`can_zoom`	Gibt zurück, ob dieser Axes die Zoom-Box-Button-Funktionalität unterstützt.
`can_pan`	Gibt zurück, ob dieser Axes eine Schwenk-/Zoom-Button-Funktionalität unterstützt.
`disable_mouse_rotation`	Deaktiviert Maustasten für 3D-Rotation, Schwenken und Zoomen.
`mouse_init`	Legt die Maustasten für 3D-Rotation und Zoom fest.
`drag_pan`	Wird aufgerufen, wenn sich die Maus während eines Schwenkvorgangs bewegt.
`format_zdata`	Gibt z formatiert als Zeichenkette zurück.
`format_coord`	Gibt die aktuellen Ansichtswinkel oder die x-, y-, z-Koordinaten des Punktes auf der nächstgelegenen Achsenebene unter dem Mauszeiger zurück, abhängig von der gedrückten Maustaste.

`draw`	Zeichnet den Künstler (und seine Kinder) mit dem gegebenen Renderer.
`get_tightbbox`	Gibt die eng anliegende Bounding Box des Axes zurück, einschließlich der Achsen und ihrer Dekorationen (xlabel, title, etc).

`view_init`	Legt die Elevation und den Azimut der Achsen in Grad (nicht Radiant) fest.
`set_proj_type`	Legt den Projektionstyp fest.
`get_proj`	Erstellt die Projektionsmatrix aus der aktuellen Ansichtsposition.
`set_top_view`

`set_zlim3d`	Alias für `set_zlim`.
`stem3D`	Erstellt ein 3D-Stammplot.
`text3D`	Fügt den Text s an der Position x, y, z in Datenkoordinaten zu den 3D-Achsen hinzu.

`get_axis_position`
`add_contour_set`
`add_contourf_set`
`update_datalim`	Nicht implementiert in `Axes3D`.

mpl_toolkits.mplot3d.axes3d.Axes3D#

Plotten#

Text und Annotationen#

Löschen#

Erscheinungsbild#

Achse#

Achsenlimits und Richtung#

Achsenbeschriftungen und Titel#

Achsenskalen#

Autoskalierung und Ränder#

Seitenverhältnis#

Ticks

Einheiten

Künstler hinzufügen#

Teilen#

Interaktivität#

Projektion und Perspektive#

Zeichnen#

Aliase und veraltete Methoden#

Andere#

Beispieldaten 3D#

Beispiele unter Verwendung von mpl_toolkits.mplot3d.axes3d.Axes3D#

Beispiele unter Verwendung von `mpl_toolkits.mplot3d.axes3d.Axes3D`#