mpl_toolkits.mplot3d.axes3d.Axes3D #
- classe 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 , focal_length = None , ** kwargs ) [source] #
 Socles :
AxesObjet Axes 3D.
- Paramètres :
 - figure de figue
 La figure parentale.
- tuple rectiligne (gauche, bas, largeur, hauteur), par défaut : Aucun.
 La position des axes.
(left, bottom, width, height)- flotteur elev , par défaut : 30
 L'angle d'élévation en degrés fait pivoter la caméra au-dessus et au-dessous du plan xy, avec un angle positif correspondant à un emplacement au-dessus du plan.
- flottant azim , par défaut : -60
 L'angle azimutal en degrés fait tourner la caméra autour de l'axe z, avec un angle positif correspondant à une rotation vers la droite. En d'autres termes, un azimut positif fait tourner la caméra autour de l'origine de son emplacement le long de l'axe +x vers l'axe +y.
- roll float, par défaut : 0
 L'angle de roulis en degrés fait pivoter la caméra autour de l'axe de visualisation. Un angle positif fait tourner la caméra dans le sens des aiguilles d'une montre, ce qui fait tourner la scène dans le sens inverse des aiguilles d'une montre.
- sharez Axes3D, en option
 Autres axes avec lesquels partager les limites z.
- type_projet {'persp', 'ortho'}
 Le type de projection, par défaut 'persp'.
- box_aspect 3-uplet de flottants, par défaut : aucun
 Modifie les dimensions physiques de l'Axes3D, de sorte que le rapport des longueurs d'axe dans les unités d'affichage soit x:y:z. Si aucun, la valeur par défaut est 4:4:3
- computed_zorder booléen, par défaut : True
 Si True, l'ordre de tracé est calculé en fonction de la position moyenne des
Artists le long de la direction de la vue. Définissez sur False si vous souhaitez contrôler manuellement l'ordre dans lequel les artistes sont dessinés les uns sur les autres à l'aide de leur attribut zorder . Cela peut être utilisé pour un réglage fin si la commande automatique ne produit pas le résultat souhaité. Notez cependant qu'un zorder manuel ne sera correct que pour un angle de vue limité. Si la figure est tournée par l'utilisateur, elle aura l'air fausse sous certains angles.- auto_add_to_figure booléen , par défaut : False
 Avant Matplotlib 3.4, Axes3D s'ajoutait à son hôte Figure on init. Les autres classes Axes ne font pas cela.
Ce comportement est obsolète dans la version 3.4, la valeur par défaut est remplacée par False dans la version 3.6. Le mot-clé ne sera pas documenté et une valeur non-False sera une erreur dans 3.7.
- focal_length flottant, par défaut : aucun
 Pour un type de projection de 'persp', la distance focale de la caméra virtuelle. Doit être > 0. Si aucun, la valeur par défaut est 1. Pour un type de projection de 'ortho', doit être défini sur aucun ou sur l'infini (numpy.inf). Si aucun, la valeur par défaut est l'infini. La distance focale peut être calculée à partir d'un champ de vision souhaité via l'équation : focal_length = 1/tan(FOV/2)
- **kwargs
 Autres arguments de mots clés facultatifs :
Propriété
La description
{'box', 'datalim'}
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
scalaire ou Aucun
(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bourdonner
{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
bourdonner
inconnue
inconnue
inconnue
Callable[[Axes, Renderer], Bbox]
bool ou 'ligne'
3-uplet de flottants ou Aucun
bourdonner
Patch ou (chemin, transformation) ou aucun
facecolorou FCCouleur
bourdonner
chaîne
bourdonner
objet
bourdonner
bourdonner
inconnue
Aucun ou bool ou flottant ou appelable
[gauche, bas, largeur, hauteur] ou
Bbox{'persp', 'ortho'}
inconnue
flottant ou Aucun
bourdonner
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
inconnue
chaîne
bourdonner
inconnue
chaîne
xlimou xlim3d(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
chaîne
ylimou ylim3d(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
inconnue
zlimou zlim3dinconnue
flottant supérieur à -0,5
flotteur
inconnue
inconnue
inconnue
- add_collection3d ( col , zs = 0 , zdir = 'z' ) [source] #
 Ajoutez un objet de collection 3D au tracé.
Les types de collection 2D sont convertis en une version 3D en modifiant l'objet et en ajoutant des informations de coordonnées z.
Sont pris en charge :
PolyCollection
CollectionLigne
Collection de correctifs
- appliquer_aspect ( position = Aucun ) [source] #
 Ajustez les Axes pour un format de données spécifié.
En fonction de
get_adjustablecela modifiera soit la case Axes (position) soit les limites de la vue. Dans le premier cas,get_anchoraura une incidence sur la position.- Paramètres :
 - position Aucun ou .Bbox
 Sinon
None, cela définit la position des Axes dans la figure comme une Bbox. Voirget_positionpour plus de détails.
Voir également
matplotlib.axes.Axes.set_aspectPour une description de la gestion des proportions.
matplotlib.axes.Axes.set_adjustableDéfinissez comment les axes s'ajustent pour atteindre le rapport d'aspect requis.
matplotlib.axes.Axes.set_anchorRéglez la position en cas d'espace supplémentaire.
Remarques
Ceci est appelé automatiquement lorsque chaque Axe est dessiné. Vous devrez peut-être l'appeler vous-même si vous devez mettre à jour la position des axes et/ou afficher les limites avant que la figure ne soit dessinée.
- mise à l' échelle automatique ( enable = True , axis = 'both' , tight = None ) [source] #
 Méthode pratique pour la mise à l'échelle automatique d'une vue d'axe simple.
Voir
Axes.autoscalepour la documentation complète. Étant donné que cette fonction s'applique aux axes 3D, l' axe peut également être défini sur 'z' et le réglage de l' axe sur 'les deux' met à l'échelle automatiquement les trois axes.
- autoscale_view ( tight = None , scalex = True , scaley = True , scalez = True ) [source] #
 Mise à l'échelle automatique des limites de vue à l'aide des limites de données.
Voir
Axes.autoscale_viewpour la documentation complète. Étant donné que cette fonction s'applique aux axes 3D, elle prend également un argument scalez .
- bar ( gauche , hauteur , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs ) [source] #
 Ajoutez des barres 2D.
- Paramètres :
 - comme un tableau 1D à gauche
 Les coordonnées x des côtés gauches des barres.
- hauteur comme un tableau 1D
 La hauteur des barres.
- zs float ou type tableau 1D
 Coordonnée Z des barres ; si une seule valeur est spécifiée, elle sera utilisée pour toutes les barres.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Lors du traçage de données 2D, direction à utiliser en tant que z ("x", "y" ou "z").
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.bar.
- Retours :
 - mpl_toolkits.mplot3d.art3d.Patch3DCollection
 
- bar3d ( x , y , z , dx , dy , dz , color = None , zsort = 'average' , shade = True , lightsource = None , * args , data = None , ** kwargs ) [source] #
 Générer un barplot 3D.
Cette méthode crée un barplot en trois dimensions où la largeur, la profondeur, la hauteur et la couleur des barres peuvent toutes être définies de manière unique.
- Paramètres :
 - x, y, z comme un tableau
 Les coordonnées du point d'ancrage des barres.
- dx, dy, dz flottant ou semblable à un tableau
 La largeur, la profondeur et la hauteur des barres, respectivement.
- séquence de couleurs de couleurs, facultatif
 La couleur des barres peut être spécifiée globalement ou individuellement. Ce paramètre peut être :
Une seule couleur, pour colorer toutes les barres de la même couleur.
Un tableau de couleurs de longueur N barres, pour colorer chaque barre indépendamment.
Un tableau de couleurs de longueur 6, pour colorer les faces des barres de manière similaire.
Un tableau de couleurs de longueur 6 * N barres, pour colorer chaque face indépendamment.
Lors de la coloration spécifique des faces des cases, voici l'ordre de la coloration :
-Z (bas de la boîte)
+Z (haut de la boîte)
-Y
+O
-X
+X
- zsort str, facultatif
 Le schéma de tri de l'axe z transmis à
Poly3DCollection- shade bool, par défaut : True
 Lorsque c'est vrai, cela ombre les côtés sombres des barres (par rapport à la source de lumière du tracé).
- Source de lumière
LightSource La source de lumière à utiliser lorsque l' ombre est True.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- **kwargs
 Tout argument de mot-clé supplémentaire est transmis à
Poly3DCollection.
- Retours :
 - le recueil
Poly3DCollection Une collection de polygones tridimensionnels représentant les barres.
- le recueil
 
- can_pan ( ) [source] #
 Indique si cet Axe prend en charge la fonctionnalité du bouton panoramique/zoom.
Les objets Axes3d n'utilisent pas le bouton panoramique/zoom.
- can_zoom ( ) [source] #
 Indique si cet Axe prend en charge la fonctionnalité du bouton de zone de zoom.
Les objets Axes3D n'utilisent pas le bouton de la boîte de zoom.
- clabel ( * args , ** kwargs ) [source] #
 Actuellement non implémenté pour les axes 3D, et renvoie None .
- contour ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour 3D.
- Paramètres :
 - X, Y, Z comme un tableau,
 Des données d'entrée. Voir
Axes.contourpour les formes de données prises en charge.- extend3d booléen , par défaut : False
 S'il faut étendre le contour en 3D.
- foulée intérieure
 Taille de pas pour étendre le contour.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.contour.
- Retours :
 - matplotlib.contour.QuadContourSet
 
- contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour 3D.
- Paramètres :
 - X, Y, Z comme un tableau,
 Des données d'entrée. Voir
Axes.contourpour les formes de données prises en charge.- extend3d booléen , par défaut : False
 S'il faut étendre le contour en 3D.
- foulée intérieure
 Taille de pas pour étendre le contour.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.contour.
- Retours :
 - matplotlib.contour.QuadContourSet
 
- contourf ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour rempli en 3D.
- Paramètres :
 - X, Y, Z comme un tableau
 Des données d'entrée. Voir
Axes.contourfpour les formes de données prises en charge.- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.contourf.
- Retours :
 - matplotlib.contour.QuadContourSet
 
- contourf3D ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour rempli en 3D.
- Paramètres :
 - X, Y, Z comme un tableau
 Des données d'entrée. Voir
Axes.contourfpour les formes de données prises en charge.- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.contourf.
- Retours :
 - matplotlib.contour.QuadContourSet
 
- convert_zunits ( z ) [source] #
 Pour les artistes dans un axe, si l'axe z prend en charge les unités, convertissez z en utilisant le type d'unité de l'axe z
- disable_mouse_rotation ( ) [source] #
 Désactivez les boutons de la souris pour la rotation et le zoom 3D.
- draw ( moteur de rendu ) [source] #
 Dessinez l'artiste (et ses enfants) à l'aide du moteur de rendu donné.
Cela n'a aucun effet si l'artiste n'est pas visible (
Artist.get_visiblerenvoie Faux).- Paramètres :
 - sous-classe de moteur de rendu .
RendererBase 
- sous-classe de moteur de rendu .
 
Remarques
Cette méthode est remplacée dans les sous-classes Artist.
- errorbar ( x , y , z , zerr = Aucun , yerr = Aucun , xerr = Aucun , fmt = '' , barsabove = False , errorevery = 1 , ecolor = Aucun , elinewidth = Aucun , capsize = Aucun , capthick = Aucun , xlolims = Faux , xuplims= False , ylolims = False , yuplims = False , zlolims = False , zuplims = False , * , data = None , ** kwargs ) [source] #
 Tracez des lignes et/ou des marqueurs avec des barres d'erreur autour d'eux.
x / y / z définissent les emplacements des données et xerr / yerr / zerr définissent les tailles de la barre d'erreur. Par défaut, cela dessine les marqueurs/lignes de données ainsi que les barres d'erreur. Utilisez fmt='none' pour dessiner uniquement les barres d'erreur.
- Paramètres :
 - x, y, z flottant ou semblable à un tableau
 Les positions des données.
- xerr, yerr, zerr float ou type tableau, forme (N,) ou (2, N), facultatif
 La taille de la barre d'erreur :
scalaire : valeurs +/- symétriques pour tous les points de données.
shape(N,) : valeurs +/- symétriques pour chaque point de données.
shape(2, N) : valeurs - et + distinctes pour chaque barre. La première ligne contient les erreurs inférieures, la deuxième ligne contient les erreurs supérieures.
Aucun : Pas de barre d'erreur.
Notez que tous les tableaux d'erreurs doivent avoir des valeurs positives .
- chaîne fmt , par défaut : ''
 Le format des points de données / lignes de données. Voir
plotpour plus de détails.Utilisez 'aucun' (insensible à la casse) pour tracer les barres d'erreur sans aucun marqueur de données.
- couleur ecolor , par défaut : Aucun
 La couleur des lignes de la barre d'erreur. Si aucun, utilisez la couleur de la ligne reliant les marqueurs.
- elinewidth flottant, par défaut : aucun
 La largeur de ligne des lignes de la barre d'erreur. Si aucun, la largeur de ligne du style actuel est utilisée.
- chavirer le flotteur, par défaut : 
rcParams["errorbar.capsize"](par défaut :0.0) La longueur des plafonds de la barre d'erreur en points.
- capthick flottant, par défaut : aucun
 Un alias pour l'argument de mot-clé markeredgewidth (alias mew ). Ce paramètre est un nom plus sensé pour la propriété qui contrôle l'épaisseur du plafond de la barre d'erreur en points. Pour une compatibilité descendante, si mew ou markeredgewidth sont donnés, ils remplaceront capthick . Cela peut changer dans les prochaines versions.
- barsabove bool, par défaut : False
 Si True, tracera les barres d'erreur au-dessus des symboles de tracé. La valeur par défaut est ci-dessous.
- xlolims, ylolims, zlolims booléen , par défaut : False
 Ces arguments peuvent être utilisés pour indiquer qu'une valeur ne donne que des limites inférieures. Dans ce cas, un signe insertion est utilisé pour l'indiquer. lims -les arguments peuvent être des scalaires ou des sortes de tableaux de la même longueur que les erreurs. Pour utiliser des limites avec des axes inversés,
set_xlimouset_ylimdoit être appelé avanterrorbar. Notez les noms de paramètres délicats : définir par exemple ylolims sur True signifie que la valeur y est une limite inférieure de la valeur True, donc seule une flèche pointant vers le haut sera dessinée !- xuplims, yuplims, zuplims booléen , par défaut : False
 Comme ci-dessus, mais pour contrôler les limites supérieures.
- errorevery int ou (int, int), par défaut : 1
 dessine des barres d'erreur sur un sous-ensemble de données. errorevery =N dessine des barres d'erreur sur les points (x[::N], y[::N], z[::N]). errorevery =(start, N) dessine des barres d'erreur sur les points (x[start::N], y[start::N], z[start::N]). par exemple errorevery=(6, 3) ajoute des barres d'erreur aux données à (x[6], x[9], x[12], x[15], ...). Utilisé pour éviter le chevauchement des barres d'erreur lorsque deux séries partagent des valeurs d'axe x.
- Retours :
 - liste d'erreurs
 Liste des
Line3DCollectioninstances contenant chacune une ligne de barre d'erreur.- liste des titres
 Liste des
Line3Dinstances contenant chacune un objet capline.- liste des limites
 Liste des
Line3Dinstances contenant chacune un marqueur avec une limite supérieure ou inférieure.
- Autres paramètres :
 - objet de données indexable, facultatif
 S'ils sont fournis, les paramètres suivants acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception) :x , y , z , xerr , yerr , zerr
- **kwargs
 Tous les autres arguments de mots-clés pour le style des lignes de la barre d'erreur sont passés
Line3DCollection.
Exemples
( Code source , png )
- format_coord ( xd , yd ) [source] #
 Étant donné les coordonnées de la vue 2D, essayez de deviner une coordonnée 3D. Recherche l'arête la plus proche du point, puis suppose que le point est au même emplacement z que le point le plus proche sur l'arête.
- format_zdata ( z ) [source] #
 Renvoie la chaîne z formatée. Cette fonction utilisera l'
fmt_zdataattribut s'il est appelable, sinon se rabattra sur le formateur majeur zaxis
- get_proj ( ) [source] #
 Créez la matrice de projection à partir de la position de visualisation actuelle.
- get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False ) [source] #
 Renvoie la boîte englobante étroite des Axes, y compris les axes et leurs décorateurs (xlabel, titre, etc.).
Les artistes qui ont
artist.set_in_layout(False)ne sont pas inclus dans la bbox.- Paramètres :
 - sous-classe de moteur de rendu
RendererBase moteur de rendu qui sera utilisé pour dessiner les figures (c'est-à-dire
fig.canvas.get_renderer())- bbox_extra_artists liste de 
ArtistouNone Liste des artistes à inclure dans la boîte englobante étroite. Si
None(par défaut), alors tous les artistes enfants des Axes sont inclus dans la boîte englobante étroite.- call_axes_locator booléen , par défaut : Vrai
 Si call_axes_locator vaut
False, il n'appelle pas l'_axes_locatorattribut, ce qui est nécessaire pour obtenir le bon cadre de délimitation.call_axes_locator=Falsepeut être utilisé si l'appelant n'est intéressé que par la taille relative de la tightbbox par rapport à la bbox Axes.- for_layout_only par défaut : Faux
 La boîte englobante n'inclura pas l'étendue x du titre et de l'étiquette x, ni l'étendue y de l'étiquette y.
- sous-classe de moteur de rendu
 - Retours :
 BboxBaseBoîte englobante dans les coordonnées des pixels de la figure.
- get_xlim ( ) [source] #
 Renvoie les limites de la vue sur l'axe des x.
- Retours :
 - gauche, droite (flotter, flotter)
 Les limites actuelles de l'axe des x dans les coordonnées des données.
Voir également
Axes.set_xlimset_xbound,get_xboundinvert_xaxis,xaxis_inverted
Remarques
L'axe des x peut être inversé, auquel cas la valeur de gauche sera supérieure à la valeur de droite .
- get_ylim ( ) [source] #
 Renvoie les limites de la vue sur l'axe des ordonnées.
- Retours :
 - bas, haut (flotteur, flotteur)
 Les limites actuelles de l'axe y en coordonnées de données.
Voir également
Axes.set_ylimset_ybound,get_yboundinvert_yaxis,yaxis_inverted
Remarques
L'axe des ordonnées peut être inversé, auquel cas la valeur inférieure sera supérieure à la valeur supérieure .
- get_zbound ( ) [source] #
 Renvoie les limites inférieure et supérieure de l'axe z, dans l'ordre croissant.
- get_zgridlines ( ) [source] #
 Renvoie les lignes de grille des axes z sous la forme d'une liste de
Line2Ds.
- get_zmajorticklabels ( ) [source] #
 Renvoie les principales étiquettes de graduation des axes z, sous la forme d'une liste de
Text.
- get_zminorticklabels ( ) [source] #
 Renvoie les étiquettes des ticks mineurs des zaxis, sous la forme d'une liste de
Text.
- get_zticklabels ( minor = False , which = None ) [source] #
 Obtenez les étiquettes de coche des zaxis.
- Paramètres :
 - booléen mineur
 Que ce soit pour retourner les ticklabels mineurs ou majeurs.
- lequel Aucun, ('mineur', 'majeur', 'les deux')
 Remplace mineur .
Sélectionne les ticklabels à retourner
- Retours :
 - liste de
Text 
- liste de
 
- get_zticklines ( mineur = Faux ) [source] #
 Renvoie les lignes de graduation des zaxis sous la forme d'une liste de
Line2Ds.
- get_zticks ( * , mineur = False ) [source] #
 Renvoie les emplacements des graduations des axes z en coordonnées de données.
Les emplacements ne sont pas coupés aux limites de l'axe actuel et peuvent donc contenir des emplacements qui ne sont pas visibles dans la sortie.
- Paramètres :
 - booléen mineur , par défaut : False
 True pour renvoyer les directions des graduations mineures, False pour renvoyer les directions des graduations principales.
- Retours :
 - tableau numpy d'emplacements de ticks
 
- grille ( visible = True , ** kwargs ) [source] #
 Activer/désactiver la grille 3D.
Noter
Actuellement, cette fonction ne se comporte pas de la même manière que
axes.Axes.grid, mais elle est destinée à prendre en charge ce comportement.
- margins ( * margins , x = None , y = None , z = None , tight = True ) [source] #
 Définissez ou récupérez les marges de mise à l'échelle automatique.
Voir
Axes.marginspour la documentation complète. Étant donné que cette fonction s'applique aux axes 3D, elle prend également un argument z et renvoie .(xmargin, ymargin, zmargin)
- mouse_init ( rotate_btn = 1 , zoom_btn = 3 ) [source] #
 Réglez les boutons de la souris pour la rotation 3D et le zoom.
- Paramètres :
 - rotate_btn entier ou liste d'entiers, par défaut : 1
 Le ou les boutons de la souris à utiliser pour la rotation 3D des axes.
- zoom_btn entier ou liste d'entiers, par défaut : 3
 Le ou les boutons de la souris à utiliser pour zoomer les axes 3D.
- nom = '3d' #
 
- plot ( xs , ys , * args , zdir = 'z' , ** kwargs ) [source] #
 Tracez des données 2D ou 3D.
- Paramètres :
 - xs de type tableau 1D
 coordonnées x des sommets.
- ys de type tableau 1D
 coordonnées y des sommets.
- zs float ou type tableau 1D
 coordonnées z des sommets ; soit un pour tous les points, soit un pour chaque point.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Lors du traçage de données 2D, direction à utiliser en tant que z ("x", "y" ou "z").
- **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.plot.
- plot3D ( xs , ys , * args , zdir = 'z' , ** kwargs ) [source] #
 Tracez des données 2D ou 3D.
- Paramètres :
 - xs de type tableau 1D
 coordonnées x des sommets.
- ys de type tableau 1D
 coordonnées y des sommets.
- zs float ou type tableau 1D
 coordonnées z des sommets ; soit un pour tous les points, soit un pour chaque point.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Lors du traçage de données 2D, direction à utiliser en tant que z ("x", "y" ou "z").
- **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.plot.
- plot_surface ( X , Y , Z , * , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs ) [source] #
 Créez un tracé de surface.
Par défaut, il sera coloré dans les nuances d'une couleur unie, mais il prend également en charge le mappage de couleurs en fournissant l' argument cmap .
Noter
Les kwargs rcount et ccount , qui sont tous deux par défaut à 50, déterminent le nombre maximal d'échantillons utilisés dans chaque direction. Si les données d'entrée sont plus grandes, elles seront sous-échantillonnées (par découpage) à ces nombres de points.
Noter
Pour optimiser la vitesse de rendu, envisagez de définir rstride et cstride sur les diviseurs du nombre de lignes moins 1 et de colonnes moins 1 respectivement. Par exemple, étant donné 51 lignes, rstride peut être l'un des diviseurs de 50.
De même, un paramètre de rstride et cstride égal à 1 (ou rcount et ccount égaux au nombre de lignes et de colonnes) peut utiliser le chemin optimisé.
- Paramètres :
 - Tableaux 2D X, Y, Z
 Valeurs des données.
- compte, compte int
 Nombre maximal d'échantillons utilisés dans chaque direction. Si les données d'entrée sont plus grandes, elles seront sous-échantillonnées (par découpage) à ces nombres de points. La valeur par défaut est 50.
- rstride, cstride int
 Pas de sous-échantillonnage dans chaque direction. Ces arguments s'excluent mutuellement avec rcount et ccount . Si un seul parmi rstride ou cstride est défini, l'autre par défaut est 10.
Le mode 'classique' utilise une valeur par défaut de au lieu de la nouvelle valeur par défaut de .
rstride = cstride = 10rcount = ccount = 50- couleur semblable à la couleur
 Couleur des taches de surface.
- cmap Palette de couleurs
 Palette de couleurs des patchs de surface.
- facecolors comme un tableau de couleurs.
 Couleurs de chaque patch individuel.
- norme Normaliser
 Normalisation pour la palette de couleurs.
- flottant vmin, vmax
 Bornes pour la normalisation.
- shade bool, par défaut : True
 Que ce soit pour ombrer les couleurs du visage. L' ombrage est toujours désactivé lorsque cmap est spécifié.
- Source de lumière
LightSource La source de lumière à utiliser lorsque l' ombre est True.
- **kwargs
 Les autres arguments sont transmis à
Poly3DCollection.
- plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs ) [source] #
 Tracez une surface triangulée.
La triangulation (facultative) peut être spécifiée de deux manières ; Soit:
plot_trisurf(triangulation, ...)
où la triangulation est un
Triangulationobjet, ou :plot_trisurf(X, Y, ...) plot_trisurf(X, Y, triangles, ...) plot_trisurf(X, Y, triangles=triangles, ...)
auquel cas un objet Triangulation sera créé. Voir
Triangulationpour une explication de ces possibilités.Les arguments restants sont :
plot_trisurf(..., Z)
où Z est le tableau de valeurs à contourner, une par point dans la triangulation.
- Paramètres :
 - X, Y, Z comme un tableau
 Valeurs de données sous forme de tableaux 1D.
- Couleur
 Couleur des taches de surface.
- cmap
 Une palette de couleurs pour les patchs de surface.
- norme Normaliser
 Une instance de Normalize pour mapper les valeurs aux couleurs.
- vmin, vmax flottant, par défaut : aucun
 Valeur minimale et maximale à mapper.
- shade bool, par défaut : True
 Que ce soit pour ombrer les couleurs du visage. L' ombrage est toujours désactivé lorsque cmap est spécifié.
- Source de lumière
LightSource La source de lumière à utiliser lorsque l' ombre est True.
- **kwargs
 Tous les autres arguments sont transmis à
Poly3DCollection
Exemples
( Code source , png )
( Code source , png )
- plot_wireframe ( X , Y , Z , ** kwargs ) [source] #
 Tracez un filaire 3D.
Noter
Les kwargs rcount et ccount , qui sont tous deux par défaut à 50, déterminent le nombre maximal d'échantillons utilisés dans chaque direction. Si les données d'entrée sont plus grandes, elles seront sous-échantillonnées (par découpage) à ces nombres de points.
- Paramètres :
 - Tableaux 2D X, Y, Z
 Valeurs des données.
- compte, compte int
 Nombre maximal d'échantillons utilisés dans chaque direction. Si les données d'entrée sont plus grandes, elles seront sous-échantillonnées (par découpage) à ces nombres de points. La définition d'un décompte sur zéro entraîne le non-échantillonnage des données dans la direction correspondante, produisant un tracé linéaire 3D plutôt qu'un tracé filaire. La valeur par défaut est 50.
- rstride, cstride int
 Pas de sous-échantillonnage dans chaque direction. Ces arguments s'excluent mutuellement avec rcount et ccount . Si un seul parmi rstride ou cstride est défini, l'autre est défini par défaut sur 1. La définition d'une foulée sur zéro entraîne le non-échantillonnage des données dans la direction correspondante, produisant un tracé linéaire 3D plutôt qu'un tracé filaire.
Le mode 'classique' utilise une valeur par défaut de au lieu de la nouvelle valeur par défaut de .
rstride = cstride = 1rcount = ccount = 50- **kwargs
 Les autres arguments sont transmis à
Line3DCollection.
- carquois ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [source] #
 Tracez un champ 3D de flèches.
Les arguments peuvent être de type tableau ou scalaires, tant qu'ils peuvent être diffusés ensemble. Les arguments peuvent également être des tableaux masqués. Si un élément dans l'un des arguments est masqué, cet élément de carquois correspondant ne sera pas tracé.
- Paramètres :
 - X, Y, Z comme un tableau
 Les coordonnées x, y et z des emplacements des flèches (la valeur par défaut est la queue de la flèche ; voir pivot kwarg).
- U, V, W de type tableau
 Les composantes x, y et z des vecteurs flèches.
- longueur flottante, par défaut : 1
 La longueur de chaque carquois.
- arrow_length_ratio flottant, par défaut : 0,3
 Le rapport de la pointe de flèche par rapport au carquois.
- pivot {'tail', 'middle', 'tip'}, par défaut : 'tail'
 La partie de la flèche qui se trouve au point de grille ; la flèche tourne autour de ce point, d'où le nom pivot .
- normalize bool, par défaut : False
 Indique si toutes les flèches sont normalisées pour avoir la même longueur ou conservent les longueurs définies par u , v et w .
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- **kwargs
 Tous les arguments de mots clés supplémentaires sont délégués à
LineCollection
- quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [source] #
 Tracez un champ 3D de flèches.
Les arguments peuvent être de type tableau ou scalaires, tant qu'ils peuvent être diffusés ensemble. Les arguments peuvent également être des tableaux masqués. Si un élément dans l'un des arguments est masqué, cet élément de carquois correspondant ne sera pas tracé.
- Paramètres :
 - X, Y, Z comme un tableau
 Les coordonnées x, y et z des emplacements des flèches (la valeur par défaut est la queue de la flèche ; voir pivot kwarg).
- U, V, W de type tableau
 Les composantes x, y et z des vecteurs flèches.
- longueur flottante, par défaut : 1
 La longueur de chaque carquois.
- arrow_length_ratio flottant, par défaut : 0,3
 Le rapport de la pointe de flèche par rapport au carquois.
- pivot {'tail', 'middle', 'tip'}, par défaut : 'tail'
 La partie de la flèche qui se trouve au point de grille ; la flèche tourne autour de ce point, d'où le nom pivot .
- normalize bool, par défaut : False
 Indique si toutes les flèches sont normalisées pour avoir la même longueur ou conservent les longueurs définies par u , v et w .
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- **kwargs
 Tous les arguments de mots clés supplémentaires sont délégués à
LineCollection
- scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [source] #
 Créez un nuage de points.
- Paramètres :
 - xs, ys comme un tableau
 Les positions des données.
- zs flottant ou semblable à un tableau, par défaut : 0
 Les positions z. Soit un tableau de la même longueur que xs et ys , soit une seule valeur pour placer tous les points dans le même plan.
- zdir {'x', 'y', 'z', '-x', '-y', '-z'}, par défaut : 'z'
 La direction de l'axe pour le zs . Ceci est utile lors du traçage de données 2D sur des axes 3D. Les données doivent être transmises sous la forme xs , ys . Définir zdir sur 'y' trace ensuite les données sur le plan xz.
Voir aussi Tracer des données 2D sur un tracé 3D .
- s flottant ou semblable à un tableau, par défaut : 20
 La taille du marqueur en points**2. Soit un tableau de la même longueur que xs et ys , soit une valeur unique pour que tous les marqueurs aient la même taille.
- c couleur, séquence ou séquence de couleurs, facultatif
 La couleur du marqueur. Valeurs possibles:
Une chaîne de format de couleur unique.
Une séquence de couleurs de longueur n.
Une séquence de n nombres à mapper sur des couleurs à l'aide de cmap et norm .
Un tableau 2D dans lequel les lignes sont RVB ou RVBA.
Pour plus de détails, voir l' argument c
scatterde .- ombre de profondeur booléen , par défaut : Vrai
 S'il faut ombrer les marqueurs de dispersion pour donner l'apparence de la profondeur. Chaque appel à
scatter()effectuera son ombrage indépendamment.- objet de données indexable, facultatif
 S'ils sont fournis, les paramètres suivants acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception) :xs , ys , zs , s , edgecolors , c , facecolor , facecolors , couleur
- **kwargs
 Tous les autres arguments sont transmis à
scatter.
- Retours :
 - chemins
PathCollection 
- chemins
 
- scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [source] #
 Créez un nuage de points.
- Paramètres :
 - xs, ys comme un tableau
 Les positions des données.
- zs flottant ou semblable à un tableau, par défaut : 0
 Les positions z. Soit un tableau de la même longueur que xs et ys , soit une seule valeur pour placer tous les points dans le même plan.
- zdir {'x', 'y', 'z', '-x', '-y', '-z'}, par défaut : 'z'
 La direction de l'axe pour le zs . Ceci est utile lors du traçage de données 2D sur des axes 3D. Les données doivent être transmises sous la forme xs , ys . Définir zdir sur 'y' trace ensuite les données sur le plan xz.
Voir aussi Tracer des données 2D sur un tracé 3D .
- s flottant ou semblable à un tableau, par défaut : 20
 La taille du marqueur en points**2. Soit un tableau de la même longueur que xs et ys , soit une valeur unique pour que tous les marqueurs aient la même taille.
- c couleur, séquence ou séquence de couleurs, facultatif
 La couleur du marqueur. Valeurs possibles:
Une chaîne de format de couleur unique.
Une séquence de couleurs de longueur n.
Une séquence de n nombres à mapper sur des couleurs à l'aide de cmap et norm .
Un tableau 2D dans lequel les lignes sont RVB ou RVBA.
Pour plus de détails, voir l' argument c
scatterde .- ombre de profondeur booléen , par défaut : Vrai
 S'il faut ombrer les marqueurs de dispersion pour donner l'apparence de la profondeur. Chaque appel à
scatter()effectuera son ombrage indépendamment.- objet de données indexable, facultatif
 S'ils sont fournis, les paramètres suivants acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception) :xs , ys , zs , s , edgecolors , c , facecolor , facecolors , couleur
- **kwargs
 Tous les autres arguments sont transmis à
scatter.
- Retours :
 - chemins
PathCollection 
- chemins
 
- set ( * , ajustable=<UNSET> , agg_filter=<UNSET> , alpha=<UNSET> , anchor=<UNSET> , animé=<UNSET> , aspect=<UNSET> , autoscale_on=<UNSET> , autoscalex_on=<UNSET > , autoscaley_on =<UNSET> ,, axes_locator=<UNSET > , axisbelow=<UNSET> , box_aspect=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , facecolor=<UNSET> , frame_on=<UNSET>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , navigation=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , position=<UNSET> , proj_type =<UNSET> , prop_cycle=<UNSET> , rasterization_zorder=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , title=<UNSET> , transform=<UNSET> , url=< UNSET> , visible=<UNSET>, xbound=<UNSET> ,xlabel=<UNSET> , xlim=<UNSET> , xlim3d=<UNSET> , xmargin=<UNSET> , xscale=<UNSET> , xticklabels=<UNSET> , xticks=<UNSET> , ybound=<UNSET> , ylabel= <UNSET> , ylim=<UNSET> , ylim3d=<UNSET> , ymargin=<UNSET> , yscale=<UNSET> , yticklabels=<UNSET> , yticks=<UNSET> , zbound=<UNSET> , zlabel=<UNSET > , zlim=<NON ENSEMBLE> , zlim3d=<NON ENSEMBLE>, zmargin=<UNSET> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> ) [source] #
 Définissez plusieurs propriétés à la fois.
Les propriétés prises en charge sont
Propriété
La description
{'box', 'datalim'}
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
scalaire ou Aucun
(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bourdonner
{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
bourdonner
inconnue
inconnue
inconnue
Callable[[Axes, Renderer], Bbox]
bool ou 'ligne'
3-uplet de flottants ou Aucun
bourdonner
Patch ou (chemin, transformation) ou aucun
facecolorou FCCouleur
bourdonner
chaîne
bourdonner
objet
bourdonner
bourdonner
inconnue
Aucun ou bool ou flottant ou appelable
[gauche, bas, largeur, hauteur] ou
Bbox{'persp', 'ortho'}
inconnue
flottant ou Aucun
bourdonner
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
inconnue
chaîne
bourdonner
inconnue
chaîne
(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
chaîne
(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
inconnue
inconnue
inconnue
flottant supérieur à -0,5
flotteur
inconnue
inconnue
inconnue
- set_aspect ( aspect , ajustable = None , anchor = None , share = False ) [source] #
 Définissez les rapports d'aspect.
- Paramètres :
 - aspect {'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
 Valeurs possibles:
évaluer
la description
'auto'
automatique; remplissez le rectangle de position avec des données.
'égal'
adapter tous les axes pour avoir des rapports d'aspect égaux.
'égalité'
adapter les axes x et y pour avoir des rapports d'aspect égaux.
'equalxz'
adapter les axes x et z pour avoir des rapports d'aspect égaux.
'égaliser'
adapter les axes y et z pour avoir des rapports d'aspect égaux.
- réglable Aucun
 Actuellement ignoré par Axes3D
Si ce n'est pas None , cela définit quel paramètre sera ajusté pour répondre à l'aspect requis. Voir
set_adjustablepour plus de détails.- ancre Aucun ou str ou 2-uplet de float, facultatif
 Si ce n'est pas None , cela définit où les Axes seront dessinés s'il y a de l'espace supplémentaire en raison de contraintes d'aspect. La manière la plus courante de spécifier l'ancre consiste à utiliser les abréviations des directions cardinales :
évaluer
la description
'C'
centré
'SO'
coin inférieur gauche
'S'
milieu du bord inférieur
'SE'
le coin inférieur droit
etc.
Voir
set_anchorpour plus de détails.- partager bool, par défaut : False
 Si
True, appliquez les paramètres à tous les axes partagés.
Voir également
- set_autoscalez_on ( b ) [source] #
 Définissez si l'axe z est mis à l'échelle automatiquement lors du dessin ou par
Axes.autoscale_view.- Paramètres :
 - b bool
 
- set_axis_off ( ) [source] #
 Désactivez les axes x et y.
Cela affecte les lignes d'axe, les graduations, les étiquettes de graduation, la grille et les étiquettes d'axe.
- set_axis_on ( ) [source] #
 Activez les axes x et y.
Cela affecte les lignes d'axe, les graduations, les étiquettes de graduation, la grille et les étiquettes d'axe.
- set_box_aspect ( aspect , * , zoom = 1 ) [source] #
 Définissez l'aspect de la boîte Axes.
L'aspect de la boîte est le rapport de la hauteur à la largeur en unités d'affichage pour chaque face de la boîte lorsqu'elle est vue perpendiculairement à cette face. Ceci ne doit pas être confondu avec l'aspect données (qui pour Axes3D est toujours 'auto'). Les rapports par défaut sont 4:4:3 (x:y:z).
Pour simuler un aspect égal dans l'espace de données, définissez l'aspect de la boîte pour qu'il corresponde à votre plage de données dans chaque dimension.
le zoom contrôle la taille globale de l'Axes3D dans la figure.
- Paramètres :
 - aspect 3-uplet de flottants ou Aucun
 Modifie les dimensions physiques de l'Axes3D, de sorte que le rapport des longueurs d'axe dans les unités d'affichage soit x:y:z. Si aucun, la valeur par défaut est (4,4,3).
- zoom flottant, par défaut : 1
 Contrôlez la taille globale de l'Axes3D dans la figure. Doit être > 0.
- set_frame_on ( b ) [source] #
 Définissez si les panneaux des axes 3D sont dessinés.
- Paramètres :
 - b bool
 
- set_proj_type ( proj_type , focal_length = None ) [source] #
 Définissez le type de projection.
- Paramètres :
 - type_projet {'persp', 'ortho'}
 Le type de projection.
- focal_length flottant, par défaut : aucun
 Pour un type de projection de 'persp', la distance focale de la caméra virtuelle. Doit être > 0. Si aucun, la valeur par défaut est 1. La distance focale peut être calculée à partir d'un champ de vision souhaité via l'équation : focal_length = 1/tan(FOV/2)
- set_title ( label , fontdict = None , loc = 'center' , ** kwargs ) [source] #
 Définissez un titre pour les Axes.
Définissez l'un des trois titres Axes disponibles. Les titres disponibles sont positionnés au-dessus des Axes au centre, au ras du bord gauche et au ras du bord droit.
- Paramètres :
 - étiquette str
 Texte à utiliser pour le titre
- fontdict dict
 Un dictionnaire contrôlant l'apparence du texte du titre, le fontdict par défaut est :
{'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'color': rcParams['axes.titlecolor'], 'verticalalignment': 'baseline', 'horizontalalignment': loc}
- loc {'centre', 'gauche', 'droite'}, par défaut : 
rcParams["axes.titlelocation"](par défaut :'center') Quel titre mettre.
- y float, par défaut : 
rcParams["axes.titley"](par défaut :None) Emplacement des axes verticaux pour le titre (1.0 est le haut). Si Aucun (valeur par défaut) et
rcParams["axes.titley"](par défaut :None) est également Aucun, y est déterminé automatiquement pour éviter les décorateurs sur les Axes.- pad flottant, par défaut : 
rcParams["axes.titlepad"](par défaut :6.0) Le décalage du titre à partir du haut des Axes, en points.
- Retours :
 TextL'instance de texte matplotlib représentant le titre
- Autres paramètres :
 
- set_xlim3d ( gauche = Aucun , droite = Aucun , * , émission = Vrai , auto = Faux , xmin = Aucun , xmax = Aucun ) [source] #
 Définissez les limites de la vue sur l'axe des x.
- Paramètres :
 - flotteur gauche , facultatif
 Le xlim gauche en coordonnées de données. Passer Aucun laisse la limite inchangée.
Les xlims gauche et droit peuvent également être passés comme tuple ( left , right ) comme premier argument de position (ou comme argument de mot-clé left ).
- flotteur droit , en option
 Le xlim droit en coordonnées de données. Passer Aucun laisse la limite inchangée.
- émettre booléen, par défaut : Vrai
 S'il faut informer les observateurs du changement de limite.
- auto bool ou None, par défaut : False
 Indique s'il faut activer la mise à l'échelle automatique de l'axe des x. Vrai s'allume, Faux s'éteint, Aucun reste inchangé.
- xmin, xmax flottant, facultatif
 Ils sont respectivement équivalents à left et right , et c'est une erreur de passer à la fois xmin et left ou xmax et right .
- Retours :
 - gauche, droite (flotter, flotter)
 Les nouvelles limites de l'axe des x dans les coordonnées des données.
Voir également
get_xlimset_xbound,get_xboundinvert_xaxis,xaxis_inverted
Remarques
La valeur de gauche peut être supérieure à la valeur de droite , auquel cas les valeurs de l'axe des x diminueront de gauche à droite.
Exemples
>>> set_xlim(left, right) >>> set_xlim((left, right)) >>> left, right = set_xlim(left, right)
Une limite peut être laissée inchangée.
>>> set_xlim(right=right_lim)
Les limites peuvent être passées dans l'ordre inverse pour inverser la direction de l'axe x. Par exemple, supposons que x représente le nombre d'années avant le présent. Les limites de l'axe des x peuvent être définies comme suit, donc il y a 5000 ans à gauche du tracé et le présent à droite.
>>> set_xlim(5000, 0)
- set_xscale ( valeur , ** kwargs ) [source] #
 Définissez l'échelle de l'axe des x.
- Paramètres :
 - valeur {"linéaire"}
 Le type d'échelle d'axe à appliquer. Les axes 3D ne prennent actuellement en charge que les échelles linéaires ; d'autres échelles donnent des résultats absurdes.
- **kwargs
 Les arguments de mot-clé sont nominalement transmis à la classe d'échelle, mais aucun d'entre eux n'est applicable aux échelles linéaires.
- set_ylim3d ( bottom = None , top = None , * , emission = True , auto = False , ymin = None , ymax = None ) [source] #
 Définissez les limites d'affichage de l'axe y.
- Paramètres :
 - flotteur inférieur , en option
 Le bas ylim en coordonnées de données. Passer Aucun laisse la limite inchangée.
Les ylims bottom et top peuvent également être passés comme tuple ( bottom , top ) comme premier argument positionnel (ou comme argument mot-clé bottom ).
- flotteur supérieur , facultatif
 Le top ylim dans les coordonnées de données. Passer Aucun laisse la limite inchangée.
- émettre booléen, par défaut : Vrai
 S'il faut informer les observateurs du changement de limite.
- auto bool ou None, par défaut : False
 Indique s'il faut activer la mise à l'échelle automatique de l'axe Y. Vrai s'allume, Faux s'éteint, Aucun reste inchangé.
- flottant ymin, ymax , facultatif
 Ils sont respectivement équivalents à bottom et top , et c'est une erreur de passer à la fois ymin et bottom ou ymax et top .
- Retours :
 - bas, haut (flotteur, flotteur)
 Les nouvelles limites de l'axe y dans les coordonnées des données.
Voir également
get_ylimset_ybound,get_yboundinvert_yaxis,yaxis_inverted
Remarques
La valeur inférieure peut être supérieure à la valeur supérieure , auquel cas les valeurs de l'axe y diminueront de bas en haut .
Exemples
>>> set_ylim(bottom, top) >>> set_ylim((bottom, top)) >>> bottom, top = set_ylim(bottom, top)
Une limite peut être laissée inchangée.
>>> set_ylim(top=top_lim)
Les limites peuvent être passées dans l'ordre inverse pour inverser la direction de l'axe y. Par exemple, supposons que
yreprésente la profondeur de l'océan en m. Les limites de l'axe y peuvent être définies comme suit, de sorte que la profondeur de 5 000 m se trouve en bas du tracé et la surface, 0 m, en haut.>>> set_ylim(5000, 0)
- set_yscale ( valeur , ** kwargs ) [source] #
 Définissez l'échelle de l'axe y.
- Paramètres :
 - valeur {"linéaire"}
 Le type d'échelle d'axe à appliquer. Les axes 3D ne prennent actuellement en charge que les échelles linéaires ; d'autres échelles donnent des résultats absurdes.
- **kwargs
 Les arguments de mot-clé sont nominalement transmis à la classe d'échelle, mais aucun d'entre eux n'est applicable aux échelles linéaires.
- set_zbound ( inférieur = Aucun , supérieur = Aucun ) [source] #
 Définissez les limites numériques inférieure et supérieure de l'axe z.
Cette méthode respectera l'inversion des axes quel que soit l'ordre des paramètres. Cela ne modifiera pas le paramètre de mise à l'échelle automatique (
get_autoscalez_on()).
- set_zlabel ( zlabel , fontdict = None , labelpad = None , ** kwargs ) [source] #
 Définissez zétiquette. Voir doc pour
set_ylabella description.
- set_zlim ( bottom = None , top = None , * , emission = True , auto = False , zmin = None , zmax = None ) [source] #
 Définissez les limites z 3D.
Voir
Axes.set_ylimpour la documentation complète
- set_zlim3d ( bottom = None , top = None , * , emission = True , auto = False , zmin = None , zmax = None ) [source] #
 Alias pour
set_zlim.
- set_zmargin ( m ) [source] #
 Définissez le rembourrage des limites de données Z avant la mise à l'échelle automatique.
m fois l'intervalle de données sera ajouté à chaque extrémité de cet intervalle avant d'être utilisé dans l'autoscaling. Si m est négatif, cela coupera la plage de données au lieu de l'étendre.
Par exemple, si vos données sont dans la plage [0, 2], une marge de 0,1 se traduira par une plage [-0,2, 2,2] ; une marge de -0,1 se traduira par une plage de [0,2, 1,8].
- Paramètres :
 - m flotteur supérieur à -0,5
 
- set_zscale ( valeur , ** kwargs ) [source] #
 Définissez l'échelle de l'axe z.
- Paramètres :
 - valeur {"linéaire"}
 Le type d'échelle d'axe à appliquer. Les axes 3D ne prennent actuellement en charge que les échelles linéaires ; d'autres échelles donnent des résultats absurdes.
- **kwargs
 Les arguments de mot-clé sont nominalement transmis à la classe d'échelle, mais aucun d'entre eux n'est applicable aux échelles linéaires.
- set_zticklabels ( labels , * , fontdict = None , minor = False , ** kwargs ) [source] #
 Définissez les étiquettes des axes z avec la liste des étiquettes de chaîne.
Avertissement
Cette méthode ne doit être utilisée qu'après avoir fixé les positions des ticks à l'aide de
Axes3D.set_zticks. Sinon, les étiquettes peuvent se retrouver dans des positions inattendues.- Paramètres :
 - étiquettes liste de str
 Les textes des étiquettes.
- fontdict dict, facultatif
 Un dictionnaire contrôlant l'apparence des ticklabels. Le fontdict par défaut est :
{'fontsize': rcParams['axes.titlesize'], 'fontweight': rcParams['axes.titleweight'], 'verticalalignment': 'baseline', 'horizontalalignment': loc}
- booléen mineur , par défaut : False
 S'il faut définir les ticklabels mineurs plutôt que les majors.
- Retours :
 - liste de
Text Les étiquettes.
- liste de
 - Autres paramètres :
 - **propriétés kwargs 
Text. 
- **propriétés kwargs 
 
- set_zticks ( ticks , labels = None , * , minor = False , ** kwargs ) [source] #
 Définissez les emplacements des graduations des axes z et éventuellement les étiquettes.
Si nécessaire, les limites de la vue de l'axe sont étendues afin que toutes les graduations données soient visibles.
- Paramètres :
 - ticks liste des flotteurs
 Liste des emplacements de tiques. L'axe
Locatorest remplacé par unFixedLocator.Certains formateurs de ticks n'étiquetteront pas les positions de ticks arbitraires ; par exemple, les formateurs de journaux n'étiquettent que les graduations de la décennie par défaut. Dans ce cas, vous pouvez définir explicitement un formateur sur l'axe en utilisant ou fournir vous-même des étiquettes
Axis.set_major_formatterformatées .- étiquettes liste de str, facultatif
 Liste des étiquettes de tiques. S'il n'est pas défini, les étiquettes sont générées avec l'axe tick
Formatter.- booléen mineur , par défaut : False
 Si
False, définissez les graduations principales ; siTrue, les ticks mineurs.- **kwargs
 Textpropriétés des étiquettes. Celles-ci ne prennent effet que si vous passez des étiquettes . Dans les autres cas, veuillez utilisertick_params.
Remarques
L'expansion obligatoire des limites de la vue est un choix de conception intentionnel pour éviter la surprise d'une coche non visible. Si vous avez besoin d'autres limites, vous devez définir les limites explicitement après avoir défini les graduations.
Partagez l'axe z avec d' autres .
Cela équivaut à passer
sharex=otherlors de la construction des axes et ne peut pas être utilisé si l'axe z est déjà partagé avec d'autres axes.
- stem ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , orientation = 'z' , data = None ) [source ] #
 Créez un diagramme de tiges 3D.
Un diagramme à tiges dessine des lignes perpendiculaires à une ligne de base et place des marqueurs aux têtes. Par défaut, la ligne de base est définie par x et y , et les tiges sont dessinées verticalement du bas vers z .
- Paramètres :
 - x, y, z comme un tableau
 Les positions des têtes des tiges. Les tiges sont dessinées le long de la direction d' orientation à partir de la ligne de base en bas (dans la coordonnée d' orientation ) jusqu'aux têtes. Par défaut, les positions x et y sont utilisées pour la ligne de base et z pour la position de la tête, mais cela peut être modifié par orientation .
- linefmt str, par défaut : 'C0-'
 Chaîne définissant les propriétés des lignes verticales. Habituellement, ce sera une couleur ou une couleur et un style de ligne :
Personnage
Style de ligne
'-'ligne continue
'--'ligne pointillée
'-.'ligne tiret-point
':'ligne pointillée
Remarque : bien qu'il soit techniquement possible de spécifier des formats valides autres que la couleur ou la couleur et le style de ligne (par exemple 'rx' ou '-.'), cela va au-delà de l'intention de la méthode et n'aboutira probablement pas à un tracé raisonnable.
- marqueurfmt str, par défaut : 'C0o'
 Une chaîne définissant les propriétés des marqueurs au niveau des têtes de tige.
- basefmt str, par défaut : 'C3-'
 Une chaîne de format définissant les propriétés de la ligne de base.
- flotteur inférieur , par défaut : 0
 Position de la ligne de base, en coordonnées d' orientation .
- label str, par défaut : aucun
 L'étiquette à utiliser pour les tiges dans les légendes.
- orientation {'x', 'y', 'z'}, par défaut : 'z'
 La direction dans laquelle les tiges sont dessinées.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).
- Retours :
 StemContainerLe conteneur peut être traité comme un tuple ( markerline , stemlines , baseline )
Exemples
( Code source , png )
( png )
( png )
- stem3D ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , orientation = 'z' , data = None ) [source ] #
 Créez un diagramme de tiges 3D.
Un diagramme à tiges dessine des lignes perpendiculaires à une ligne de base et place des marqueurs aux têtes. Par défaut, la ligne de base est définie par x et y , et les tiges sont dessinées verticalement du bas vers z .
- Paramètres :
 - x, y, z comme un tableau
 Les positions des têtes des tiges. Les tiges sont dessinées le long de la direction d' orientation à partir de la ligne de base en bas (dans la coordonnée d' orientation ) jusqu'aux têtes. Par défaut, les positions x et y sont utilisées pour la ligne de base et z pour la position de la tête, mais cela peut être modifié par orientation .
- linefmt str, par défaut : 'C0-'
 Chaîne définissant les propriétés des lignes verticales. Habituellement, ce sera une couleur ou une couleur et un style de ligne :
Personnage
Style de ligne
'-'ligne continue
'--'ligne pointillée
'-.'ligne tiret-point
':'ligne pointillée
Remarque : bien qu'il soit techniquement possible de spécifier des formats valides autres que la couleur ou la couleur et le style de ligne (par exemple 'rx' ou '-.'), cela va au-delà de l'intention de la méthode et n'aboutira probablement pas à un tracé raisonnable.
- marqueurfmt str, par défaut : 'C0o'
 Une chaîne définissant les propriétés des marqueurs au niveau des têtes de tige.
- basefmt str, par défaut : 'C3-'
 Une chaîne de format définissant les propriétés de la ligne de base.
- flotteur inférieur , par défaut : 0
 Position de la ligne de base, en coordonnées d' orientation .
- label str, par défaut : aucun
 L'étiquette à utiliser pour les tiges dans les légendes.
- orientation {'x', 'y', 'z'}, par défaut : 'z'
 La direction dans laquelle les tiges sont dessinées.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).
- Retours :
 StemContainerLe conteneur peut être traité comme un tuple ( markerline , stemlines , baseline )
Exemples
( Code source , png )
( png )
( png )
- text ( x , y , z , s , zdir = None , ** kwargs ) [source] #
 Ajoutez du texte au tracé. kwargs sera transmis à Axes.text, à l'exception du mot-clé zdir , qui définit la direction à utiliser comme direction z.
- text2D ( x , y , s , fontdict = None , ** kwargs ) [source] #
 Ajoutez du texte aux Axes.
Ajoutez le texte s aux Axes à l'emplacement x , y en coordonnées de données.
- Paramètres :
 - x, y flottant
 La position pour placer le texte. Par défaut, il s'agit de coordonnées de données. Le système de coordonnées peut être modifié à l'aide du paramètre de transformation .
- s str
 Le texte.
- fontdict dict, par défaut : aucun
 Un dictionnaire pour remplacer les propriétés de texte par défaut. Si fontdict vaut None, les valeurs par défaut sont déterminées par
rcParams.
- Retours :
 - Autres paramètres :
 - **propriétés kwargs 
Text. Autres paramètres de texte divers.
Propriété
La description
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
scalaire ou Aucun
bourdonner
Couleur
dict avec des propriétés pour
patches.FancyBboxPatchinconnue
inconnue
inconnue
colorou cCouleur
fontfamilyou famille{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesou police ou font_propertiesfontsizeou tailleflottant ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretchou étirer{une valeur numérique dans la plage 0-1000, 'ultra-condensé', 'extra-condensé', 'condensé', 'semi-condensé', 'normal', 'semi-élargi', 'élargi', 'extra-élargi ', 'ultra-élargi'}
fontstyleou style{'normal', 'italique', 'oblique'}
fontvariantou variante{'normal', 'petites majuscules'}
fontweightou poids{une valeur numérique dans la plage 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'gras', 'lourd', 'extra gras', 'noir'}
chaîne
horizontalalignmentou ha{'gauche', 'centre', 'droite'}
bourdonner
objet
flottant (multiple de la taille de la police)
chaîne
bourdonner
multialignmentou maman{'gauche', 'droite', 'centre'}
bourdonner
Aucun ou bool ou flottant ou appelable
(flotter, flotter)
bourdonner
flottant ou {'vertical', 'horizontal'}
{Aucun, 'par défaut', 'ancre'}
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
objet
bourdonner
chaîne
booléen ou Aucun
verticalalignmentou va{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
bourdonner
bourdonner
flotteur
flotteur
flotteur
- **propriétés kwargs 
 
Exemples
Des arguments de mots-clés individuels peuvent être utilisés pour remplacer n'importe quel paramètre donné :
>>> text(x, y, s, fontsize=12)
La transformation par défaut spécifie que le texte est dans les coordonnées de données, vous pouvez également spécifier le texte dans les coordonnées d'axe ((0, 0) est en bas à gauche et (1, 1) est en haut à droite). L'exemple ci-dessous place le texte au centre des Axes :
>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center', ... verticalalignment='center', transform=ax.transAxes)
Vous pouvez placer une boîte rectangulaire autour de l'instance de texte (par exemple, pour définir une couleur d'arrière-plan) en utilisant le mot-clé bbox . bbox est un dictionnaire de
Rectanglepropriétés. Par exemple:>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))
- text3D ( x , y , z , s , zdir = None , ** kwargs ) [source] #
 Ajoutez du texte au tracé. kwargs sera transmis à Axes.text, à l'exception du mot-clé zdir , qui définit la direction à utiliser comme direction z.
- tick_params ( axe = 'les deux' , ** kwargs ) [source] #
 Méthode pratique pour modifier l'apparence des tiques et des étiquettes de tiques.
Voir
Axes.tick_paramspour la documentation complète. Étant donné que cette fonction s'applique aux axes 3D, l' axe peut également être défini sur 'z' et le réglage de l' axe sur 'les deux' met à l'échelle automatiquement les trois axes.De plus, en raison de la façon dont les objets Axes3D sont dessinés très différemment des axes 2D réguliers, certains de ces paramètres peuvent avoir une signification ambiguë. Pour plus de simplicité, l'axe 'z' acceptera les paramètres comme s'il était comme l'axe 'y'.
Noter
Axes3D ignore actuellement certains de ces paramètres.
- tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour 3D.
Noter
Cette méthode produit actuellement une sortie incorrecte en raison d'un bogue de longue date dans le rendu 3D PolyCollection.
- Paramètres :
 - X, Y, Z comme un tableau
 Des données d'entrée. Voir
Axes.tricontourpour les formes de données prises en charge.- extend3d booléen , par défaut : False
 S'il faut étendre le contour en 3D.
- foulée intérieure
 Taille de pas pour étendre le contour.
- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.tricontour.
- Retours :
 - matplotlib.tri.tricontour.TriContourSet
 
- tricontourf ( * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [source] #
 Créez un tracé de contour rempli en 3D.
Noter
Cette méthode produit actuellement une sortie incorrecte en raison d'un bogue de longue date dans le rendu 3D PolyCollection.
- Paramètres :
 - X, Y, Z comme un tableau
 Des données d'entrée. Voir
Axes.tricontourfpour les formes de données prises en charge.- zdir {'x', 'y', 'z'}, par défaut : 'z'
 Le sens d'utilisation.
- flotteur décalé , facultatif
 Si spécifié, tracez une projection des courbes de niveau à cette position dans un plan normal à zdir.
- objet de données indexable, facultatif
 S'ils sont donnés, tous les paramètres acceptent également une chaîne
s, qui est interprétée commedata[s](sauf si cela déclenche une exception).- *args, **kwargs
 Les autres arguments sont transmis à
matplotlib.axes.Axes.tricontourf.
- Retours :
 - matplotlib.tri.tricontour.TriContourSet
 
- update_datalim ( xys , ** kwargs ) [source] #
 Étendez la
dataLimBbox pour inclure les points donnés.Si aucune donnée n'est définie actuellement, la Bbox ignorera ses limites et définira la limite comme étant les limites de xydata ( xys ). Sinon, il calculera les limites de l'union de ses données actuelles et des données dans xys .
- Paramètres :
 - xys 2D semblable à un tableau
 Les points à inclure dans les limites de données Bbox. Il peut s'agir d'une liste de tuples (x, y) ou d'un tableau Nx2.
- updatex, updatey bool, par défaut : True
 S'il faut mettre à jour les limites x/y.
- view_init ( elev = None , azim = None , roll = None , vertical_axis = 'z' ) [source] #
 Définissez l'élévation et l'azimut des axes en degrés (et non en radians).
Cela peut être utilisé pour faire pivoter les axes par programmation.
Pour avoir l'air normal aux plans primaires, les angles d'élévation et d'azimut suivants peuvent être utilisés. Un angle de roulis de 0, 90, 180 ou 270 degrés fera pivoter ces vues tout en gardant les axes à angle droit.
plan de vue
ascenseur
azim
XY
90
-90
XZ
0
-90
YZ
0
0
-XY
-90
90
-XZ
0
90
-YZ
0
180
- Paramètres :
 - flotteur elev , par défaut : aucun
 L'angle d'élévation en degrés fait tourner la caméra au-dessus du plan percé par l'axe vertical, avec un angle positif correspondant à un emplacement au-dessus de ce plan. Par exemple, avec l'axe vertical par défaut de 'z', l'élévation définit l'angle de l'emplacement de la caméra au-dessus du plan xy. Si None, la valeur initiale telle que spécifiée dans le
Axes3Dconstructeur est utilisée.- flottant azim , par défaut : aucun
 L'angle d'azimut en degrés fait tourner la caméra autour de l'axe vertical, avec un angle positif correspondant à une rotation vers la droite. Par exemple, avec l'axe vertical par défaut de 'z', un azimut positif fait tourner la caméra autour de l'origine de son emplacement le long de l'axe +x vers l'axe +y. Si None, la valeur initiale telle que spécifiée dans le
Axes3Dconstructeur est utilisée.- roll float, par défaut : aucun
 L'angle de roulis en degrés fait pivoter la caméra autour de l'axe de visualisation. Un angle positif fait tourner la caméra dans le sens des aiguilles d'une montre, ce qui fait tourner la scène dans le sens inverse des aiguilles d'une montre. Si None, la valeur initiale telle que spécifiée dans le
Axes3Dconstructeur est utilisée.- axe_vertical {"z", "x", "y"}, par défaut : "z"
 Axe à aligner verticalement. azim tourne autour de cet axe.
- voxels ( [ x , y , z , ] / , filled , facecolors=None , edgecolors=None , **kwargs ) [source] #
 Tracer un ensemble de voxels remplis
Tous les voxels sont tracés sous forme de cubes 1x1x1 sur l'axe, avec placé avec son coin inférieur à l'origine. Les faces occultées ne sont pas tracées.
filled[0, 0, 0]- Paramètres :
 - rempli 3D np.tableau de bool
 Un tableau 3D de valeurs, avec des valeurs véridiques indiquant les voxels à remplir
- x, y, z 3D np.array, facultatif
 Les coordonnées des coins des voxels. Cela devrait diffuser une forme plus grande dans chaque dimension que la forme de filled . Ceux-ci peuvent être utilisés pour tracer des voxels non cubiques.
S'il n'est pas spécifié, par défaut, les nombres entiers croissants le long de chaque axe, comme ceux renvoyés par
indices(). Comme indiqué par le/dans la signature de la fonction, ces arguments ne peuvent être passés que de manière positionnelle.- facecolors, edgecolors comme un tableau, facultatif
 La couleur pour dessiner les faces et les bords des voxels. Ne peut être transmis qu'en tant qu'arguments de mot-clé. Ces paramètres peuvent être :
Une seule valeur de couleur, pour colorer tous les voxels de la même couleur. Il peut s'agir soit d'une chaîne, soit d'un tableau 1D rgb/rgba
None, la valeur par défaut, pour utiliser une seule couleur pour les faces et le style par défaut pour les bords.Un ndarray 3D de noms de couleurs, avec chaque élément la couleur du voxel correspondant. La taille doit correspondre aux voxels.
Un ndarray 4D de données rgb/rgba, avec les composants le long du dernier axe.
- shade bool, par défaut : True
 Que ce soit pour ombrer les couleurs du visage. L' ombrage est toujours désactivé lorsque cmap est spécifié.
- Source de lumière
LightSource La source de lumière à utiliser lorsque l' ombre est True.
- **kwargs
 Arguments de mots clés supplémentaires à transmettre à
Poly3DCollection.
- Retours :
 - visages dict
 Un dictionnaire indexé par coordonnées, où est a des faces dessinées pour le voxel . Si aucun visage n'a été dessiné pour un voxel donné, soit parce qu'il n'a pas été demandé de le dessiner, soit parce qu'il est complètement occulté, alors .
faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces
Exemples
( Code source , png )
( Code source , png )
( Code source , png )
( Code source , png )
- zaxis_date ( tz = Aucun ) [source] #
 Configurez les repères d'axe et les étiquettes pour traiter les données le long de l'axe z comme des dates.
- Paramètres :
 - tz str ou 
datetime.tzinfo, par défaut :rcParams["timezone"](par défaut :'UTC') Fuseau horaire utilisé pour créer des étiquettes de date.
- tz str ou 
 
Remarques
Cette fonction est simplement fournie par souci d'exhaustivité, mais les axes 3D ne prennent pas en charge les dates pour les graduations, et cela peut donc ne pas fonctionner comme prévu.