mpl_toolkits.mplot3d.art3d.Path3DCollection

class mpl_toolkits.mplot3d.art3d.Path3DCollection(*args, zs=0, zdir='z', depthshade=True, axlim_clip=False, **kwargs)

Bases: PathCollection

Eine Sammlung von 3D-Pfaden.

Erstellt eine Sammlung von flachen 3D-Pfaden mit ihrem Normalenvektor in zdir-Richtung und positioniert auf zs entlang der zdir-Achse. 'zs' kann ein Skalar oder eine Array-ähnliche Struktur mit der gleichen Länge wie die Anzahl der Pfade in der Sammlung sein.

Die Konstruktorargumente sind dieselben wie für PathCollection. Zusätzlich sind die Schlüsselwörter zs=0 und zdir='z' verfügbar.

Außerdem ist das Schlüsselwortargument depthshade verfügbar, um anzugeben, ob die Patches beschattet werden sollen, um den Anschein von Tiefe zu erwecken (Standard ist True). Dies ist typischerweise bei Scatter-Plots gewünscht.

do_3d_projection()

draw(renderer)

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

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

Parameter:

rendererRendererBase Unterklasse.

Anmerkungen

Diese Methode wird in den Künstler-Unterklassen überschrieben.

get_depthshade()

get_edgecolor()

get_facecolor()

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>, depthshade=<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>, visible=<UNSET>, zorder=<UNSET>)

Setzt mehrere Eigenschaften auf einmal.

Unterstützte Eigenschaften sind

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

set_3d_properties(zs, zdir, axlim_clip=False)

Setzt die z-Positionen und die Richtung der Pfade.

Parameter:

zsGleitkommazahl oder Array von Gleitkommazahlen

Der oder die Orte, an denen die Pfade in der Sammlung entlang der zdir-Achse platziert werden.

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

Die Ebene, zu der die Pfade orthogonal gezeichnet werden. Alle Pfade müssen die gleiche Richtung haben. siehe get_dir_vector für eine Beschreibung der Werte.

axlim_clipbool, Standard: False

Gibt an, ob Pfade mit einer Ecke außerhalb der Achsensichtgrenzen ausgeblendet werden sollen.

set_depthshade(depthshade)

Legt fest, ob die Tiefenschattierung für Sammlungsmitglieder durchgeführt werden soll.

Parameter:

depthshadebool

Gibt an, ob die Patches beschattet werden sollen, um den Anschein von Tiefe zu erwecken.

set_linewidth(lw)

Legt die Linienstärke(n) für die Sammlung fest. lw kann ein Skalar oder eine Sequenz sein; wenn es eine Sequenz ist, werden die Patches durch die Sequenz zyklisch durchlaufen.

Parameter:

lwfloat oder Liste von Floats

set_sizes(sizes, dpi=72.0)

Legt die Größen jedes Mitglieds der Sammlung fest.

Parameter:

sizesnumpy.ndarray oder None

Die für jedes Element der Sammlung festzulegende Größe. Der Wert ist die 'Fläche' des Elements.

dpifloat, standard: 72

Die DPI der Leinwand.

set_sort_zpos(val)

Setzt die Position für die Z-Sortierung.