mpl_toolkits.mplot3d.art3d.Poly3DCollection

classe mpl_toolkits.mplot3d.art3d. Poly3DCollection ( verts , * args , zsort = 'average' , ** kwargs )

Socles :PolyCollection

Une collection de polygones 3D.

Noter

Remplissage de polygones 3D

Il n'y a pas de définition simple de la surface fermée d'un polygone 3D à moins que le polygone ne soit plan.

En pratique, Matplotlib remplit la projection 2D du polygone. Cela donne une apparence de remplissage correcte uniquement pour les polygones plans. Pour tous les autres polygones, vous trouverez des orientations dans lesquelles les bords du polygone se croisent dans la projection. Cela conduira à une visualisation incorrecte de la zone 3D.

Si vous avez besoin de zones remplies, il est recommandé de les créer via plot_trisurf, ce qui crée une triangulation et génère ainsi des surfaces cohérentes.

Paramètres :

verts liste de (N, 3) de type tableau

Chaque élément décrit un polygone comme une séquence de N_ipoints .(x, y, z)

zsort {'moyenne', 'min', 'max'}, par défaut : 'moyenne'

La méthode de calcul pour l'ordre z. Voir set_zsortpour plus de détails.

*args, **kwargs

Tous les autres paramètres sont transmis à PolyCollection.

Remarques

Notez que cette classe fait un peu de magie avec les propriétés _facecolors et _edgecolors.

faire_3d_projection ( )

Effectuez la projection 3D pour cet objet.

get_edgecolor ( )

get_facecolor ( )

get_vector ( segments3d )

Optimiser les points pour la projection.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animé=<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> , 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=<NON DÉFINI> ,urls=<NON ENSEMBLE> , verts=<NON ENSEMBLE>, verts_and_codes=<UNSET> , visible=<UNSET> , zorder=<UNSET> , zsort=<UNSET> )

Définissez plusieurs propriétés à la fois.

Les propriétés prises en charge sont

Propriété	La description
agg_filter	une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
alpha	inconnue
animated	bourdonner
antialiasedou aa ou antialiasés	bool ou liste de bools
array	semblable à un tableau ou Aucun
capstyle	CapStyleou {'bout', 'en saillie', 'rond'}
clim	(vmin : flottant, vmax : flottant)
clip_box	Bbox
clip_on	bourdonner
clip_path	Patch ou (chemin, transformation) ou aucun
cmap	Colormapou str ou Aucun
color	couleur ou liste de tuples rgba
edgecolorou ec ou edgecolors	inconnue
facecolorou facecolors ou fc	inconnue
figure	Figure
gid	chaîne
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bourdonner
joinstyle	JoinStyleou {'onglet', 'rond', 'biseau'}
label	objet
linestyleou tirets ou styles de ligne ou ls	str ou tuple ou une liste de ceux-ci
linewidthou largeurs de ligne ou lw	flottant ou liste de flottants
mouseover	bourdonner
norm	Normalizeou str ou Aucun
offset_transformou transOffset	inconnue
offsets	(N, 2) ou (2,) en forme de tableau
path_effects	AbstractPathEffect
paths	liste de type tableau
picker	Aucun ou bool ou flottant ou appelable
pickradius	inconnue
rasterized	bourdonner
sizes	ndarray ou Aucun
sketch_params	(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
snap	booléen ou Aucun
sort_zpos	inconnue
transform	Transform
url	chaîne
urls	liste de str ou None
verts	inconnue
verts_and_codes	inconnue
visible	bourdonner
zorder	flotteur
zsort	{'moyenne', 'min', 'max'}

set_3d_properties ( )

set_alpha ( alpha )

Définissez la valeur alpha utilisée pour la fusion - non prise en charge sur tous les backends.

Paramètres :

comme un tableau alpha ou scalaire ou Aucun

Toutes les valeurs doivent être comprises dans la plage 0-1, inclus. Les valeurs masquées et les nans ne sont pas pris en charge.

set_edgecolor ( couleurs )

Définissez la ou les couleurs de bord de la collection.

Paramètres :

c couleur ou liste de couleurs ou 'visage'

La ou les couleurs de bord de la collection. S'il s'agit d'une séquence, les patchs la parcourent. Si 'visage', correspond à la couleur du visage.

set_facecolor ( couleurs )

Définissez la ou les couleurs de face de la collection. c peut être une couleur (tous les patchs ont la même couleur), ou une séquence de couleurs ; s'il s'agit d'une séquence, les patchs parcourront la séquence.

Si c est 'none', le patch ne sera pas rempli.

Paramètres :

c couleur ou liste de couleurs

set_sort_zpos ( val )

Définissez la position à utiliser pour le tri z.

set_verts ( verts , fermé = True )

Définissez les sommets 3D.

set_verts_and_codes ( verts , codes )

Définissez des sommets 3D avec des codes de chemin.

set_zsort ( zsort )

Définissez la méthode de calcul pour l'ordre z.

Paramètres :

zsort {'moyenne', 'min', 'max'}

La fonction appliquée sur les coordonnées z des sommets dans le système de coordonnées de l'observateur, pour déterminer l'ordre z.

Exemples utilisant mpl_toolkits.mplot3d.art3d.Poly3DCollection

Ombrage personnalisé dans un tracé de surface 3D

Ombrage personnalisé dans un tracé de surface 3D

Axes 2D et 3D dans la même figure

*Axes* 2D et 3D dans la même *figure*

Générer des polygones à remplir sous un graphique linéaire 3D

Générer des polygones à remplir sous un graphique linéaire 3D

Tracés 3D en tant que sous-parcelles

Tracés 3D en tant que sous-parcelles

Surface 3D (carte de couleurs)

Surface 3D (carte de couleurs)

Surface 3D (damier)

Surface 3D (damier)