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 :
Axes
Objet 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
Artist
s 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
facecolor
ou 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
xlim
ou xlim3d(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
chaîne
ylim
ou ylim3d(en bas : flottant, en haut : flottant)
(en bas : flottant, en haut : flottant)
flottant supérieur à -0,5
inconnue
inconnue
inconnue
inconnue
inconnue
zlim
ou 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_adjustable
cela modifiera soit la case Axes (position) soit les limites de la vue. Dans le premier cas,get_anchor
aura 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_position
pour plus de détails.
Voir également
matplotlib.axes.Axes.set_aspect
Pour une description de la gestion des proportions.
matplotlib.axes.Axes.set_adjustable
Définissez comment les axes s'ajustent pour atteindre le rapport d'aspect requis.
matplotlib.axes.Axes.set_anchor
Ré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.autoscale
pour 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_view
pour 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.contour
pour 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.contour
pour 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.contourf
pour 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.contourf
pour 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_visible
renvoie 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
plot
pour 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_xlim
ouset_ylim
doit ê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
Line3DCollection
instances contenant chacune une ligne de barre d'erreur.- liste des titres
Liste des
Line3D
instances contenant chacune un objet capline.- liste des limites
Liste des
Line3D
instances 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_zdata
attribut 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
Artist
ouNone
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_locator
attribut, ce qui est nécessaire pour obtenir le bon cadre de délimitation.call_axes_locator=False
peut ê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 :
BboxBase
Boî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_xlim
set_xbound
,get_xbound
invert_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_ylim
set_ybound
,get_ybound
invert_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
Line2D
s.
- 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
Line2D
s.
- 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.margins
pour 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 = 10
rcount = 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
Triangulation
objet, ou :plot_trisurf(X, Y, ...) plot_trisurf(X, Y, triangles, ...) plot_trisurf(X, Y, triangles=triangles, ...)
auquel cas un objet Triangulation sera créé. Voir
Triangulation
pour 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 = 1
rcount = 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
scatter
de .- 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
scatter
de .- 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
facecolor
ou 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_adjustable
pour 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_anchor
pour 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 :
Text
L'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_xlim
set_xbound
,get_xbound
invert_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_ylim
set_ybound
,get_ybound
invert_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
y
repré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_ylabel
la 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_ylim
pour 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
Locator
est 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_formatter
formaté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
Text
proprié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=other
lors 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 :
StemContainer
Le 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 :
StemContainer
Le 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.FancyBboxPatch
inconnue
inconnue
inconnue
color
ou cCouleur
fontfamily
ou famille{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties
ou police ou font_propertiesfontsize
ou tailleflottant ou {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch
ou é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'}
fontstyle
ou style{'normal', 'italique', 'oblique'}
fontvariant
ou variante{'normal', 'petites majuscules'}
fontweight
ou 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
horizontalalignment
ou ha{'gauche', 'centre', 'droite'}
bourdonner
objet
flottant (multiple de la taille de la police)
chaîne
bourdonner
multialignment
ou 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
verticalalignment
ou 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
Rectangle
proprié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_params
pour 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.tricontour
pour 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.tricontourf
pour 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
dataLim
Bbox 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
Axes3D
constructeur 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
Axes3D
constructeur 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
Axes3D
constructeur 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]
Poly3DCollection
filled[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.