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 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

adjustable

{'box', 'datalim'}

agg_filter

une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image

alpha

scalaire ou Aucun

anchor

(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

bourdonner

aspect

{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

autoscale_on

bourdonner

autoscalex_on

inconnue

autoscaley_on

inconnue

autoscalez_on

inconnue

axes_locator

Callable[[Axes, Renderer], Bbox]

axisbelow

bool ou 'ligne'

box_aspect

3-uplet de flottants ou Aucun

clip_box

Bbox

clip_on

bourdonner

clip_path

Patch ou (chemin, transformation) ou aucun

facecolorou FC

Couleur

figure

Figure

frame_on

bourdonner

gid

chaîne

in_layout

bourdonner

label

objet

mouseover

bourdonner

navigate

bourdonner

navigate_mode

inconnue

path_effects

AbstractPathEffect

picker

Aucun ou bool ou flottant ou appelable

position

[gauche, bas, largeur, hauteur] ouBbox

proj_type

{'persp', 'ortho'}

prop_cycle

inconnue

rasterization_zorder

flottant ou Aucun

rasterized

bourdonner

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

title

inconnue

transform

Transform

url

chaîne

visible

bourdonner

xbound

inconnue

xlabel

chaîne

xlimou xlim3d

(en bas : flottant, en haut : flottant)

xlim3d

(en bas : flottant, en haut : flottant)

xmargin

flottant supérieur à -0,5

xscale

inconnue

xticklabels

inconnue

xticks

inconnue

ybound

inconnue

ylabel

chaîne

ylimou ylim3d

(en bas : flottant, en haut : flottant)

ylim3d

(en bas : flottant, en haut : flottant)

ymargin

flottant supérieur à -0,5

yscale

inconnue

yticklabels

inconnue

yticks

inconnue

zbound

inconnue

zlabel

inconnue

zlimou zlim3d

inconnue

zmargin

flottant supérieur à -0,5

zorder

flotteur

zscale

inconnue

zticklabels

inconnue

zticks

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

add_contour_set ( cset , extend3d = False , stride = 5 , zdir = 'z' , offset = None ) [source] #
add_contourf_set ( cset , zdir = 'z' , offset = None ) [source] #
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. Voir get_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.

auto_scale_xyz ( X , Y , Z = Aucun , had_data = Aucun ) [source] #
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 comme data[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 :

  1. -Z (bas de la boîte)

  2. +Z (haut de la boîte)

  3. -Y

  4. +O

  5. -X

  6. +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èreLightSource

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 comme data[s](sauf si cela déclenche une exception).

**kwargs

Tout argument de mot-clé supplémentaire est transmis à Poly3DCollection.

Retours :
le recueilPoly3DCollection

Une collection de polygones tridimensionnels représentant les barres.

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 .

effacer ( ) [source] #

Dégagez les haches.

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 comme data[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 comme data[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 comme data[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 comme data[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.

propriété dist [source] #
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

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_xlimou set_ylimdoit être appelé avant errorbar. 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 comme data[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 )

../../_images/errorbar3d.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_autoscalez_on ( ) [source] #

Indique si l'axe z est mis à l'échelle automatiquement.

get_axis_position ( ) [source] #
get_frame_on ( ) [source] #

Déterminez si les panneaux des axes 3D sont dessinés.

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 renduRendererBase

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.

Retours :
BboxBase

Boîte englobante dans les coordonnées des pixels de la figure.

get_w_lims ( ) [source] #

Obtenez les limites du monde 3D.

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_xlim3d ( ) [source] #

Alias ​​pour get_xlim.

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_ylim3d ( ) [source] #

Alias ​​pour get_ylim.

get_zaxis ( ) [source] #

Renvoie l' instance ZAxis( ).Axis

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_zlabel ( ) [source] #

Obtenez la chaîne de texte z-label.

get_zlim ( ) [source] #

Obtenez des limites z 3D.

get_zlim3d ( ) [source] #

Alias ​​pour get_zlim.

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_zscale ( ) [source] #

Renvoie l'échelle des zaxis (sous forme de str).

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 deText
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.

invert_zaxis ( ) [source] #

Inversez l'axe z.

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èreLightSource

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)

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èreLightSource

La source de lumière à utiliser lorsque l' ombre est True.

**kwargs

Tous les autres arguments sont transmis à Poly3DCollection

Exemples

( Code source , png )

../../_images/trisurf3d.png

( Code source , png )

../../_images/trisurf3d_2.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 comme data[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 comme data[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 cscatter 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 comme data[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 :
cheminsPathCollection
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 cscatter 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 comme data[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 :
cheminsPathCollection
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

adjustable

{'box', 'datalim'}

agg_filter

une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image

alpha

scalaire ou Aucun

anchor

(flottant, flottant) ou {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

bourdonner

aspect

{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

autoscale_on

bourdonner

autoscalex_on

inconnue

autoscaley_on

inconnue

autoscalez_on

inconnue

axes_locator

Callable[[Axes, Renderer], Bbox]

axisbelow

bool ou 'ligne'

box_aspect

3-uplet de flottants ou Aucun

clip_box

Bbox

clip_on

bourdonner

clip_path

Patch ou (chemin, transformation) ou aucun

facecolorou FC

Couleur

figure

Figure

frame_on

bourdonner

gid

chaîne

in_layout

bourdonner

label

objet

mouseover

bourdonner

navigate

bourdonner

navigate_mode

inconnue

path_effects

AbstractPathEffect

picker

Aucun ou bool ou flottant ou appelable

position

[gauche, bas, largeur, hauteur] ouBbox

proj_type

{'persp', 'ortho'}

prop_cycle

inconnue

rasterization_zorder

flottant ou Aucun

rasterized

bourdonner

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

title

inconnue

transform

Transform

url

chaîne

visible

bourdonner

xbound

inconnue

xlabel

chaîne

xlim

(en bas : flottant, en haut : flottant)

xlim3d

(en bas : flottant, en haut : flottant)

xmargin

flottant supérieur à -0,5

xscale

inconnue

xticklabels

inconnue

xticks

inconnue

ybound

inconnue

ylabel

chaîne

ylim

(en bas : flottant, en haut : flottant)

ylim3d

(en bas : flottant, en haut : flottant)

ymargin

flottant supérieur à -0,5

yscale

inconnue

yticklabels

inconnue

yticks

inconnue

zbound

inconnue

zlabel

inconnue

zlim

inconnue

zlim3d

inconnue

zmargin

flottant supérieur à -0,5

zorder

flotteur

zscale

inconnue

zticklabels

inconnue

zticks

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.

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 :
** propriétés kwargsText

Les autres arguments de mot-clé sont des propriétés de texte, voir Textpour une liste des propriétés de texte valides.

set_top_view ( ) [source] #
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 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 deText

Les étiquettes.

Autres paramètres :
**propriétés kwargs Text.
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 un FixedLocator.

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 étiquettesAxis.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 ; si True, 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 utiliser tick_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.

sharez ( autre ) [source] #

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 comme data[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 )

../../_images/stem3d_demo_00_00.png

( png )

../../_images/stem3d_demo_01_00.png

( png )

../../_images/stem3d_demo_02_00.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 comme data[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 )

../../_images/stem3d_demo_00_00.png

( png )

../../_images/stem3d_demo_01_00.png

( png )

../../_images/stem3d_demo_02_00.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 :
Text

L' Textinstance créée.

Autres paramètres :
**propriétés kwargs Text.

Autres paramètres de texte divers.

Propriété

La description

agg_filter

une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image

alpha

scalaire ou Aucun

animated

bourdonner

backgroundcolor

Couleur

bbox

dict avec des propriétés pourpatches.FancyBboxPatch

clip_box

inconnue

clip_on

inconnue

clip_path

inconnue

colorou c

Couleur

figure

Figure

fontfamilyou famille

{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

fontpropertiesou police ou font_properties

font_manager.FontPropertiesou stroupathlib.Path

fontsizeou taille

flottant 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'}

gid

chaîne

horizontalalignmentou ha

{'gauche', 'centre', 'droite'}

in_layout

bourdonner

label

objet

linespacing

flottant (multiple de la taille de la police)

math_fontfamily

chaîne

mouseover

bourdonner

multialignmentou maman

{'gauche', 'droite', 'centre'}

parse_math

bourdonner

path_effects

AbstractPathEffect

picker

Aucun ou bool ou flottant ou appelable

position

(flotter, flotter)

rasterized

bourdonner

rotation

flottant ou {'vertical', 'horizontal'}

rotation_mode

{Aucun, 'par défaut', 'ancre'}

sketch_params

(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)

snap

booléen ou Aucun

text

objet

transform

Transform

transform_rotates_text

bourdonner

url

chaîne

usetex

booléen ou Aucun

verticalalignmentou va

{'bottom', 'baseline', 'center', 'center_baseline', 'top'}

visible

bourdonner

wrap

bourdonner

x

flotteur

y

flotteur

zorder

flotteur

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_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 comme data[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 comme data[s](sauf si cela déclenche une exception).

*args, **kwargs

Les autres arguments sont transmis à matplotlib.axes.Axes.tricontourf.

Retours :
matplotlib.tri.tricontour.TriContourSet
tunit_cube ( vals = Aucun , M = Aucun ) [source] #
tunit_edges ( vals = Aucun , M = Aucun ) [source] #
unit_cube ( vals = Aucun ) [source] #
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 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èreLightSource

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 )

../../_images/voxels.png

( Code source , png )

../../_images/voxels_rgb.png

( Code source , png )

../../_images/voxels_torus.png

( Code source , png )

../../_images/voxels_numpy_logo.png
propriété w_xaxis [source] #
propriété w_yaxis [source] #
propriété w_zaxis [source] #
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.

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.

zaxis_inverted ( ) [source] #

Renvoie True si l'axe z est inversé.