mpl_toolkits.mplot3d.art3d.Poly3DCollection

class mpl_toolkits.mplot3d.art3d.Poly3DCollection(verts, *args, zsort='average', shade=False, lightsource=None, axlim_clip=False, **kwargs)

Basen: PolyCollection

Eine Sammlung von 3D-Polygonen.

Hinweis

Füllung von 3D-Polygonen

Es gibt keine einfache Definition der eingeschlossenen Fläche eines 3D-Polygons, es sei denn, das Polygon ist planar.

In der Praxis füllt Matplotlib die 2D-Projektion des Polygons. Dies ergibt nur bei planaren Polygonen ein korrektes Füllungsbild. Bei allen anderen Polygonen finden Sie Orientierungen, bei denen sich die Kanten des Polygons in der Projektion schneiden. Dies führt zu einer falschen Visualisierung der 3D-Fläche.

Wenn Sie gefüllte Flächen benötigen, wird empfohlen, diese über plot_trisurf zu erstellen, welche eine Triangulierung erstellt und somit konsistente Flächen generiert.

Parameter:

vertsListe von (N, 3) array-ähnlich

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte des Polygons i als 2D-Array-ähnlich der Form (N, 3) definiert.

zsort{'average', 'min', 'max'}, Standard: 'average'

Die Berechnungsmethode für die z-Reihenfolge. Details siehe set_zsort.

shadebool, Standard: False

Ob facecolors und edgecolors schattiert werden sollen. Wenn shade aktiviert ist, müssen facecolors und/oder edgecolors bereitgestellt werden.

Hinzugefügt in Version 3.7.

lightsourceLightSource, optional

Die Lichtquelle, die verwendet wird, wenn shade True ist.

Hinzugefügt in Version 3.7.

axlim_clipbool, Standard: False

Ob Polygone mit einer außerhalb der Ansichtsgrenzen liegenden Ecke ausgeblendet werden sollen.

*args, **kwargs

Alle anderen Parameter werden an PolyCollection weitergeleitet.

Anmerkungen

Beachten Sie, dass diese Klasse ein wenig Magie mit den Eigenschaften _facecolors und _edgecolors betreibt.

do_3d_projection()

Führt die 3D-Projektion für dieses Objekt durch.

get_edgecolor()

get_facecolor()

get_vector(segments3d)

[Veraltet]

Anmerkungen

Veraltet seit Version 3.10

set(*, agg_filter=<UNSET>, alpha=<UNSET>, animated=<UNSET>, antialiased=<UNSET>, array=<UNSET>, capstyle=<UNSET>, clim=<UNSET>, clip_box=<UNSET>, clip_on=<UNSET>, clip_path=<UNSET>, cmap=<UNSET>, color=<UNSET>, edgecolor=<UNSET>, facecolor=<UNSET>, gid=<UNSET>, hatch=<UNSET>, hatch_linewidth=<UNSET>, in_layout=<UNSET>, joinstyle=<UNSET>, label=<UNSET>, linestyle=<UNSET>, linewidth=<UNSET>, mouseover=<UNSET>, norm=<UNSET>, offset_transform=<UNSET>, offsets=<UNSET>, path_effects=<UNSET>, paths=<UNSET>, picker=<UNSET>, pickradius=<UNSET>, rasterized=<UNSET>, sizes=<UNSET>, sketch_params=<UNSET>, snap=<UNSET>, sort_zpos=<UNSET>, transform=<UNSET>, url=<UNSET>, urls=<UNSET>, verts=<UNSET>, verts_and_codes=<UNSET>, visible=<UNSET>, zorder=<UNSET>, zsort=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

Eigenschaft	Beschreibung
3d_properties	unknown
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	unknown
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
edgecolor oder ec oder edgecolors	unknown
facecolor oder facecolors oder fc	unknown
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder dashes oder linestyles oder ls	str oder Tupel oder Liste davon
linewidth oder linewidths oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	Liste von AbstractPathEffect
paths	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
sort_zpos	unknown
transform	Transform
url	str
urls	Liste von str oder None
verts	Liste von (N, 3) array-ähnlich
verts_and_codes	unknown
visible	bool
zorder	float
zsort	{'average', 'min', 'max'}

set_3d_properties(axlim_clip=False)

set_alpha(alpha)

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

Parameter:

alphaarray-ähnlich oder float oder None

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

set_edgecolor(colors)

Setzt die Kantenfarbe(n) der Sammlung.

Parameter:

cFarbe oder Liste von Farben oder 'face'

Die Kantenfarbe(n) der Sammlung. Wenn es sich um eine Sequenz handelt, durchläuft die Patches diese. Wenn 'face', entspricht sie der Flächenfarbe.

set_facecolor(colors)

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

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

Parameter:

cFarbe oder Liste von Farben

set_sort_zpos(val)

Setzt die Position für die Z-Sortierung.

set_verts(verts, closed=True)

3D-Eckpunkte setzen.

Parameter:

vertsListe von (N, 3) array-ähnlich

Die Sequenz von Polygonen [verts0, verts1, ...] wobei jedes Element verts_i die Eckpunkte des Polygons i als 2D-Array-ähnlich der Form (N, 3) definiert.

closedbool, Standard: True

Ob das Polygon durch Hinzufügen einer CLOSEPOLY-Verbindung am Ende geschlossen werden soll.

set_verts_and_codes(verts, codes)

3D-Eckpunkte mit Pfadcodes setzen.

set_zsort(zsort)

Setzt die Berechnungsmethode für die z-Reihenfolge.

Parameter:

zsort{'average', 'min', 'max'}

Die Funktion, die auf die z-Koordinaten der Eckpunkte im Koordinatensystem des Betrachters angewendet wird, um die z-Reihenfolge zu bestimmen.

Beispiele mit mpl_toolkits.mplot3d.art3d.Poly3DCollection

Benutzerdefinierte Hillshading in einem 3D-Oberflächendiagramm

Benutzerdefinierte Hillshading in einem 3D-Oberflächendiagramm

2D- und 3D-Achsen in derselben Figur

2D- und 3D-Achsen in derselben Figur

3D-Polygone generieren

3D-Polygone generieren

3D-Diagramme als Subplots

3D-Diagramme als Subplots

3D-Oberfläche (Farbskala)

3D-Oberfläche (Farbskala)

3D-Oberfläche (Karomuster)

3D-Oberfläche (Karomuster)