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 ) [fonte] #

Basi:Axes

Oggetto Assi 3D.

Parametri :
fico Figura

La figura del genitore.

tupla rect (sinistra, fondo, larghezza, altezza), default: Nessuno.

La posizione degli assi.(left, bottom, width, height)

elev float, predefinito: 30

L'angolo di elevazione in gradi ruota la fotocamera sopra e sotto il piano xy, con un angolo positivo corrispondente a una posizione sopra il piano.

azim float, predefinito: -60

L'angolo azimutale in gradi ruota la fotocamera attorno all'asse z, con un angolo positivo corrispondente a una rotazione verso destra. In altre parole, un azimut positivo ruota la telecamera attorno all'origine dalla sua posizione lungo l'asse +x verso l'asse +y.

roll float, predefinito: 0

L'angolo di rollio in gradi ruota la telecamera attorno all'asse di visualizzazione. Un angolo positivo fa ruotare la telecamera in senso orario, facendo ruotare la scena in senso antiorario.

sharez Axes3D, facoltativo

Altri assi con cui condividere i limiti z.

proj_type {'persp', 'ortho'}

Il tipo di proiezione, predefinito 'persp'.

box_aspect 3 tuple di float, default: Nessuno

Modifica le dimensioni fisiche di Axes3D, in modo tale che il rapporto delle lunghezze degli assi nelle unità di visualizzazione sia x:y:z. Se Nessuno, il valore predefinito è 4:4:3

computed_zorder bool, predefinito: vero

Se True, l'ordine di visualizzazione viene calcolato in base alla posizione media delle Artists lungo la direzione della vista. Impostare su False se si desidera controllare manualmente l'ordine in cui gli artisti vengono disegnati uno sopra l'altro utilizzando il loro attributo zorder . Questo può essere utilizzato per la messa a punto se l'ordine automatico non produce il risultato desiderato. Si noti tuttavia che uno zorder manuale sarà corretto solo per un angolo di visualizzazione limitato. Se la figura viene ruotata dall'utente, sembrerà sbagliata da certe angolazioni.

auto_add_to_figure bool, predefinito: falso

Prima di Matplotlib 3.4, Axes3D si aggiungeva alla propria figura host su init. Altre classi Axes non lo fanno.

Questo comportamento è deprecato in 3.4, il valore predefinito è cambiato in False in 3.6. La parola chiave sarà non documentata e un valore diverso da False sarà un errore in 3.7.

focal_length float, predefinito: nessuno

Per un tipo di proiezione di 'persp', la lunghezza focale della telecamera virtuale. Deve essere > 0. Se None, il valore predefinito è 1. Per un tipo di proiezione di 'orto', deve essere impostato su Nessuno o infinito (numpy.inf). Se Nessuno, il valore predefinito è infinito. La lunghezza focale può essere calcolata da un campo visivo desiderato tramite l'equazione: focal_length = 1/tan(FOV/2)

**kwargs

Altri argomenti di parole chiave opzionali:

Proprietà

Descrizione

adjustable

{'box', 'datalim'}

agg_filter

una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine

alpha

scalare o Nessuno

anchor

(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

bool

aspect

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

autoscale_on

bool

autoscalex_on

sconosciuto

autoscaley_on

sconosciuto

autoscalez_on

sconosciuto

axes_locator

Callable[[Assi, Renderer], Bbox]

axisbelow

bool o 'linea'

box_aspect

3 tuple di float o Nessuno

clip_box

Bbox

clip_on

bool

clip_path

Patch o (Percorso, Trasforma) o Nessuno

facecoloro fc

colore

figure

Figure

frame_on

bool

gid

str

in_layout

bool

label

oggetto

mouseover

bool

navigate

bool

navigate_mode

sconosciuto

path_effects

AbstractPathEffect

picker

Nessuno o bool o float o richiamabile

position

[sinistra, fondo, larghezza, altezza] oBbox

proj_type

{'persp', 'orto'}

prop_cycle

sconosciuto

rasterization_zorder

float o Nessuno

rasterized

bool

sketch_params

(scala: float, lunghezza: float, casualità: float)

snap

bool o Nessuno

title

sconosciuto

transform

Transform

url

str

visible

bool

xbound

sconosciuto

xlabel

str

xlimo xlim3d

(in basso: galleggiante, in alto: galleggiante)

xlim3d

(in basso: galleggiante, in alto: galleggiante)

xmargin

float maggiore di -0,5

xscale

sconosciuto

xticklabels

sconosciuto

xticks

sconosciuto

ybound

sconosciuto

ylabel

str

ylimo ylim3d

(in basso: galleggiante, in alto: galleggiante)

ylim3d

(in basso: galleggiante, in alto: galleggiante)

ymargin

float maggiore di -0,5

yscale

sconosciuto

yticklabels

sconosciuto

yticks

sconosciuto

zbound

sconosciuto

zlabel

sconosciuto

zlimo zlim3d

sconosciuto

zmargin

float maggiore di -0,5

zorder

galleggiante

zscale

sconosciuto

zticklabels

sconosciuto

zticks

sconosciuto

add_collection3d ( col , zs = 0 , zdir = 'z' ) [fonte] #

Aggiungi un oggetto raccolta 3D al grafico.

I tipi di raccolta 2D vengono convertiti in una versione 3D modificando l'oggetto e aggiungendo informazioni sulle coordinate z.

Supportati sono:

  • Collezione Poly

  • LineCollection

  • PatchCollection

add_contour_set ( cset , extend3d = False , stride = 5 , zdir = 'z' , offset = None ) [fonte] #
add_contourf_set ( cset , zdir = 'z' , offset = None ) [fonte] #
apply_aspect ( posizione = Nessuno ) [fonte] #

Regola gli assi per un rapporto di aspetto dei dati specificato.

A seconda di get_adjustableciò verrà modificata la casella Assi (posizione) oi limiti della vista. Nel primo caso, get_anchorinfluenzerà la posizione.

Parametri :
posizione Nessuno o .Bbox

In caso contrario None, definisce la posizione degli assi all'interno della figura come una Bbox. Vedere get_position per ulteriori dettagli.

Guarda anche

matplotlib.axes.Axes.set_aspect

Per una descrizione della gestione delle proporzioni.

matplotlib.axes.Axes.set_adjustable

Imposta la modalità di regolazione degli assi per ottenere le proporzioni richieste.

matplotlib.axes.Axes.set_anchor

Impostare la posizione in caso di spazio extra.

Appunti

Questo viene chiamato automaticamente quando viene disegnato ogni Axes. Potrebbe essere necessario chiamarlo manualmente se è necessario aggiornare la posizione degli assi e/o visualizzare i limiti prima che venga disegnata la figura.

auto_scale_xyz ( X , Y , Z = Nessuno , had_data = Nessuno ) [fonte] #
autoscale ( enable = True , axis = 'both' , tight = None ) [fonte] #

Metodo pratico per il ridimensionamento automatico della vista dell'asse semplice.

Vedere Axes.autoscaleper la documentazione completa. Poiché questa funzione si applica agli assi 3D, l' asse può anche essere impostato su "z" e l'impostazione dell'asse su "entrambi" ridimensiona automaticamente tutti e tre gli assi.

autoscale_view ( tight = None , scalex = True , scaley = True , scalez = True ) [fonte] #

Ridimensiona automaticamente i limiti di visualizzazione utilizzando i limiti di dati.

Vedere Axes.autoscale_viewper la documentazione completa. Poiché questa funzione si applica agli assi 3D, accetta anche un argomento scalez .

bar ( sinistra , altezza , zs = 0 , zdir = 'z' , * args , data = None , ** kwargs ) [fonte] #

Aggiungi barre 2D.

Parametri :
a sinistra simile a un array 1D

Le coordinate x dei lati sinistri delle barre.

height 1D simile a un array

L'altezza delle barre.

zs float o simile a un array 1D

Coordinata Z delle barre; se viene specificato un solo valore, verrà utilizzato per tutte le barre.

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

Quando si tracciano dati 2D, la direzione da utilizzare come z ('x', 'y' o 'z').

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

**kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.bar.

Resi :
mpl_toolkits.mplot3d.art3d.Patch3DCollection
bar3d ( x , y , z , dx , dy , dz , color = None , zsort = 'average' , shade = True , lightsource = None , * args , data = None , ** kwargs ) [fonte] #

Genera un grafico a barre 3D.

Questo metodo crea un grafico a barre tridimensionale in cui la larghezza, la profondità, l'altezza e il colore delle barre possono essere tutti impostati in modo univoco.

Parametri :
x, y, z simile a un array

Le coordinate del punto di ancoraggio delle barre.

dx, dy, dz float o simile a un array

La larghezza, la profondità e l'altezza delle barre, rispettivamente.

sequenza di colori dei colori, opzionale

Il colore delle barre può essere specificato globalmente o individualmente. Questo parametro può essere:

  • Un unico colore, per colorare tutte le barre dello stesso colore.

  • Una matrice di colori di lunghezza N barre, per colorare ciascuna barra in modo indipendente.

  • Una matrice di colori di lunghezza 6, per colorare in modo simile le facce delle barre.

  • Una matrice di colori di lunghezza 6 * N barre, per colorare ogni faccia in modo indipendente.

Quando si colorano specificamente le facce delle scatole, questo è l'ordine della colorazione:

  1. -Z (parte inferiore della scatola)

  2. +Z (parte superiore del riquadro)

  3. -Y

  4. +Y

  5. -X

  6. +X

zsort str, facoltativo

Lo schema di ordinamento dell'asse z è stato trasferitoPoly3DCollection

ombra bool, predefinito: vero

Quando vero, questo ombreggia i lati oscuri delle barre (rispetto alla fonte di luce della trama).

fonte di luceLightSource

La sorgente luminosa da usare quando shade è True.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

**kwargs

Eventuali argomenti di parole chiave aggiuntivi vengono passati a Poly3DCollection.

Resi :
collezionePoly3DCollection

Una raccolta di poligoni tridimensionali che rappresentano le barre.

can_pan ( ) [fonte] #

Indica se questo Axes supporta la funzionalità del pulsante pan/zoom.

Gli oggetti Axes3d non usano il pulsante pan/zoom.

can_zoom ( ) [fonte] #

Indica se questo Axes supporta la funzionalità del pulsante della casella di zoom.

Gli oggetti Axes3D non utilizzano il pulsante della casella di zoom.

clabel ( * args , ** kwargs ) [fonte] #

Attualmente non implementato per gli assi 3D e restituisce None .

cancella ( ) [fonte] #

Cancella gli assi.

contour ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno 3D.

Parametri :
X, Y, Z simile a un array,

Dati in ingresso. Vedere Axes.contourper le forme di dati supportate.

extend3d bool, predefinito: falso

Se estendere il contorno in 3D.

passo int

Dimensione del passo per l'estensione del contorno.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.contour.

Resi :
matplotlib.contour.QuadContourSet
contour3D ( X , Y , Z , * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno 3D.

Parametri :
X, Y, Z simile a un array,

Dati in ingresso. Vedere Axes.contourper le forme di dati supportate.

extend3d bool, predefinito: falso

Se estendere il contorno in 3D.

passo int

Dimensione del passo per l'estensione del contorno.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.contour.

Resi :
matplotlib.contour.QuadContourSet
contourf ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno riempito 3D.

Parametri :
X, Y, Z simile a un array

Dati in ingresso. Vedere Axes.contourfper le forme di dati supportate.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.contourf.

Resi :
matplotlib.contour.QuadContourSet
contourf3D ( X , Y , Z , * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno riempito 3D.

Parametri :
X, Y, Z simile a un array

Dati in ingresso. Vedere Axes.contourfper le forme di dati supportate.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.contourf.

Resi :
matplotlib.contour.QuadContourSet
convert_zunits ( z ) [fonte] #

Per gli artisti in un Axes, se lo zaxis supporta le unità, converti z utilizzando il tipo di unità zaxis

disable_mouse_rotation ( ) [fonte] #

Disabilita i pulsanti del mouse per la rotazione e lo zoom 3D.

proprietà dist [fonte] #
draw ( renderer ) [fonte] #

Disegna l'artista (e i suoi figli) usando il renderer dato.

Questo non ha effetto se l'artista non è visibile ( Artist.get_visible restituisce False).

Parametri :
sottoclasse del renderer .RendererBase

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

errorbar ( x , y , z , zerr = None , yerr = None , xerr = None , fmt = '' , barsabove = False , errorevery = 1 , ecolor = None , elinewidth = None , capsize = None , capthick = None , xlolims = Falso , xuplims= Falso , ylolims = Falso , yuplims = Falso , zlolims = Falso , zuplims = Falso , * , data = Nessuno , ** kwargs ) [fonte] #

Linee di trama e/o marcatori con barre di errore intorno a loro.

x / y / z definiscono le posizioni dei dati e xerr / yerr / zerr definiscono le dimensioni della barra di errore. Per impostazione predefinita, questo disegna i marcatori/le linee dei dati e le barre di errore. Usa fmt='none' per disegnare solo barre di errore.

Parametri :
x, y, z float o simile a un array

Le posizioni dei dati.

xerr, yerr, zerr float o simile ad un array, forma (N,) o (2, N), facoltativo

Le dimensioni della barra di errore:

  • scalare: valori simmetrici +/- per tutti i punti dati.

  • shape(N,): valori simmetrici +/- per ogni punto dati.

  • shape(2, N): valori separati - e + per ogni barra. La prima riga contiene gli errori inferiori, la seconda riga contiene gli errori superiori.

  • Nessuno : nessuna barra di errore.

Si noti che tutti gli array di errore devono avere valori positivi .

fmt str, predefinito: ''

Il formato per i punti dati/linee dati. Vedere plotper i dettagli.

Usa 'none' (senza distinzione tra maiuscole e minuscole) per tracciare barre di errore senza indicatori di dati.

colore ecolor , predefinito: Nessuno

Il colore delle linee della barra degli errori. Se Nessuno, usa il colore della linea che collega i marcatori.

elinewidth float, default: Nessuno

La larghezza di riga delle righe della barra degli errori. Se None, viene utilizzata la larghezza di riga dello stile corrente.

capovolgi float, predefinito: rcParams["errorbar.capsize"](predefinito: 0.0)

La lunghezza della barra di errore si chiude in punti.

capthick float, predefinito: Nessuno

Un alias per l'argomento della parola chiave markeredgewidth (aka mew ). Questa impostazione è un nome più sensato per la proprietà che controlla lo spessore in punti del limite della barra di errore. Per compatibilità con le versioni precedenti, se vengono specificati mew o markeredgewidth , sovrascriveranno capthick . Questo potrebbe cambiare nelle versioni future.

barsabove bool, default: False

Se Vero, traccerà le barre di errore sopra i simboli del grafico. L'impostazione predefinita è sotto.

xlolims, ylolims, zlolims bool, predefinito: falso

Questi argomenti possono essere utilizzati per indicare che un valore fornisce solo limiti inferiori. In tal caso viene utilizzato un simbolo di accento circonflesso per indicare ciò. lims -arguments possono essere scalari o simili ad array della stessa lunghezza degli errori. Per utilizzare limiti con assi invertiti, set_xlimo set_ylimdeve essere chiamato prima di errorbar. Nota i nomi complicati dei parametri: impostare ad esempio ylolims su True significa che il valore y è un limite inferiore del valore True, quindi verrà disegnata solo una freccia rivolta verso l'alto!

xuplims, yuplims, zuplims bool, default: False

Come sopra, ma per controllare i limiti superiori.

errorevery int o (int, int), default: 1

disegna barre di errore su un sottoinsieme dei dati. errorevery =N disegna barre di errore sui punti (x[::N], y[::N], z[::N]). errorevery =(inizio, N) disegna barre di errore sui punti (x[inizio::N], y[inizio::N], z[inizio::N]). ad esempio errorevery=(6, 3) aggiunge barre di errore ai dati in (x[6], x[9], x[12], x[15], ...). Utilizzato per evitare la sovrapposizione delle barre di errore quando due serie condividono i valori dell'asse x.

Resi :
elenco delle righe

Elenco di Line3DCollectionistanze ciascuna contenente una riga barra di errore.

elenco capitelli

Elenco di Line3Distanze ciascuna contenente un oggetto capline.

elenco dei limiti

Elenco di Line3Distanze ciascuna contenente un indicatore con un limite superiore o inferiore.

Altri parametri :
oggetto indicizzabile dei dati , facoltativo

Se forniti, i seguenti parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione):

x , y , z , xerr , yerr , zerr

**kwargs

Vengono passati tutti gli altri argomenti di parole chiave per definire lo stile delle righe della barra degli errori Line3DCollection.

Esempi

( Codice sorgente , png )

../../_images/errorbar3d.png
format_coord ( xd , yd ) [fonte] #

Date le coordinate della vista 2D, prova a indovinare una coordinata 3D. Cerca il bordo più vicino al punto e quindi presuppone che il punto si trovi nella stessa posizione z del punto più vicino sul bordo.

format_zdata ( z ) [fonte] #

Restituisce la stringa z formattata. Questa funzione utilizzerà l' fmt_zdataattributo se è richiamabile, altrimenti ricorrerà al formattatore zaxis major

get_autoscalez_on ( ) [fonte] #

Restituisce se lo zaxis viene ridimensionato automaticamente.

get_axis_position ( ) [fonte] #
get_frame_on ( ) [fonte] #

Ottieni se i pannelli degli assi 3D sono disegnati.

get_proj ( ) [fonte] #

Crea la matrice di proiezione dalla posizione di visualizzazione corrente.

get_tightbbox ( renderer = None , call_axes_locator = True , bbox_extra_artists = None , * , for_layout_only = False ) [fonte] #

Restituisci il riquadro di delimitazione stretto degli assi, inclusi gli assi e i loro decoratori (xlabel, titolo, ecc.).

Gli artisti che hanno artist.set_in_layout(False)non sono inclusi nella bbox.

Parametri :
sottoclasse del rendererRendererBase

renderer che verrà utilizzato per disegnare le figure (es fig.canvas.get_renderer())

bbox_extra_artists elenco di ArtistoNone

Elenco degli artisti da includere nella scatola di delimitazione stretta. Se None(predefinito), tutti i figli artisti degli assi sono inclusi nel riquadro di delimitazione stretto.

call_axes_locator booleano, predefinito: vero

Se call_axes_locator è False, non chiama l' _axes_locatorattributo, che è necessario per ottenere il riquadro di delimitazione corretto. call_axes_locator=Falsepuò essere utilizzato se il chiamante è interessato solo alla dimensione relativa della tightbbox rispetto alla bbox Axes.

for_layout_only predefinito: falso

Il riquadro di delimitazione non includerà l'estensione x del titolo e l'etichetta x o l'estensione y dell'etichetta y.

Resi :
BboxBase

Riquadro di delimitazione nelle coordinate dei pixel della figura.

get_w_lims ( ) [fonte] #

Ottieni i limiti del mondo 3D.

get_xlim ( ) [fonte] #

Restituisce i limiti della vista dell'asse x.

Resi :
sinistra, destra (float, float)

I limiti correnti dell'asse x nelle coordinate dei dati.

Guarda anche

Axes.set_xlim
set_xbound,get_xbound
invert_xaxis,xaxis_inverted

Appunti

L'asse x può essere invertito, nel qual caso il valore a sinistra sarà maggiore del valore a destra .

get_xlim3d ( ) [fonte] #

Alias ​​per get_xlim.

get_ylim ( ) [fonte] #

Restituisce i limiti della vista dell'asse y.

Resi :
in basso, in alto (float, float)

I limiti correnti dell'asse y nelle coordinate dei dati.

Guarda anche

Axes.set_ylim
set_ybound,get_ybound
invert_yaxis,yaxis_inverted

Appunti

L'asse y può essere invertito, nel qual caso il valore inferiore sarà maggiore del valore superiore .

get_ylim3d ( ) [fonte] #

Alias ​​per get_ylim.

get_zaxis ( ) [fonte] #

Restituisce l' istanza ZAxis( ).Axis

get_zbound ( ) [fonte] #

Restituisce i limiti inferiore e superiore dell'asse z, in ordine crescente.

get_zgridlines ( ) [fonte] #

Restituisce le linee della griglia dello zaxis come un elenco di Line2Ds.

get_zlabel ( ) [fonte] #

Ottieni la stringa di testo z-label.

get_zlim ( ) [fonte] #

Ottieni i limiti z 3D.

get_zlim3d ( ) [fonte] #

Alias ​​per get_zlim.

get_zmajorticklabels ( ) [fonte] #

Restituisce le principali etichette di spunta dello zaxis, come un elenco di file Text.

get_zminorticklabels ( ) [fonte] #

Restituisce le etichette di spunta minori dello zaxis, come un elenco di file Text.

get_zscale ( ) [fonte] #

Restituisce la scala dello zaxis (come str).

get_zticklabels ( minor = False , which = None ) [fonte] #

Prendi le etichette di spunta dello zaxis.

Parametri :
bool minore

Indica se restituire il ticklabel minore o maggiore.

quale Nessuno, ('minore', 'maggiore', 'entrambi')

Sostituisce minor .

Seleziona quali ticklabel restituire

Resi :
lista diText
get_zticklines ( minor = False ) [fonte] #

Restituisce le linee di spunta dello zaxis come un elenco di Line2Ds.

get_zticks ( * , minor = False ) [fonte] #

Restituisce le posizioni delle zecche dello zaxis nelle coordinate dei dati.

Le posizioni non vengono ritagliate rispetto ai limiti dell'asse corrente e quindi possono contenere posizioni non visibili nell'output.

Parametri :
minor bool, default: False

True per restituire le direzioni dei tick minori, False per restituire le direzioni dei tick principali.

Resi :
array numpy di posizioni di tick
griglia ( visibile = True , ** kwargs ) [fonte] #

Imposta/disattiva la griglia 3D.

Nota

Attualmente, questa funzione non si comporta come axes.Axes.grid, ma alla fine è destinata a supportare tale comportamento.

invert_zaxis ( ) [fonte] #

Invertire l'asse z.

margins ( * margins , x = Nessuno , y = Nessuno , z = Nessuno , tight = True ) [fonte] #

Imposta o recupera i margini di ridimensionamento automatico.

Vedere Axes.marginsper la documentazione completa. Poiché questa funzione si applica a 3D Axes, accetta anche un argomento z e restituisce .(xmargin, ymargin, zmargin)

mouse_init ( rotata_btn = 1 , zoom_btn = 3 ) [fonte] #

Impostare i pulsanti del mouse per la rotazione e lo zoom 3D.

Parametri :
rotate_btn int o lista di int, default: 1

Il pulsante oi pulsanti del mouse da utilizzare per la rotazione 3D degli assi.

zoom_btn int o lista di int, default: 3

Il pulsante oi pulsanti del mouse da utilizzare per ingrandire gli assi 3D.

nome = '3d' #
trama ( xs , ys , * args , zdir = 'z' , ** kwargs ) [fonte] #

Traccia dati 2D o 3D.

Parametri :
xs simile a un array 1D

coordinate x dei vertici.

ys simile a un array 1D

y coordinate dei vertici.

zs float o simile a un array 1D

coordinate z dei vertici; o uno per tutti i punti o uno per ogni punto.

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

Quando si tracciano dati 2D, la direzione da utilizzare come z ('x', 'y' o 'z').

**kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.plot.

plot3D ( xs , ys , * args , zdir = 'z' , ** kwargs ) [fonte] #

Traccia dati 2D o 3D.

Parametri :
xs simile a un array 1D

coordinate x dei vertici.

ys simile a un array 1D

y coordinate dei vertici.

zs float o simile a un array 1D

coordinate z dei vertici; o uno per tutti i punti o uno per ogni punto.

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

Quando si tracciano dati 2D, la direzione da utilizzare come z ('x', 'y' o 'z').

**kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.plot.

plot_surface ( X , Y , Z , * , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs ) [fonte] #

Crea un grafico di superficie.

Per impostazione predefinita sarà colorata in sfumature di un colore a tinta unita, ma supporta anche la mappatura dei colori fornendo l' argomento cmap .

Nota

I valori rcount e ccount kwargs, che per impostazione predefinita sono entrambi 50, determinano il numero massimo di campioni utilizzati in ciascuna direzione. Se i dati di input sono più grandi, verranno sottoposti a downsampling (tagliando) a questi numeri di punti.

Nota

Per massimizzare la velocità di rendering, considera di impostare rstride e cstride rispettivamente sui divisori del numero di righe meno 1 e di colonne meno 1. Ad esempio, date 51 righe, rstride può essere uno qualsiasi dei divisori di 50.

Allo stesso modo, un'impostazione di rstride e cstride uguale a 1 (o rcount e ccount uguale al numero di righe e colonne) può utilizzare il percorso ottimizzato.

Parametri :
Matrici X, Y, Z 2D

Valori dei dati.

rcount, ccount int

Numero massimo di campioni utilizzati in ciascuna direzione. Se i dati di input sono più grandi, verranno sottoposti a downsampling (tagliando) a questi numeri di punti. Il valore predefinito è 50.

stride, cstride int

Downsampling falcata in ogni direzione. Questi argomenti si escludono a vicenda con rcount e ccount . Se è impostato solo uno tra rstride o cstride , l'altro valore predefinito è 10.

La modalità "classica" utilizza un'impostazione predefinita di anziché la nuova impostazione predefinita di .rstride = cstride = 10rcount = ccount = 50

colore simile al colore

Colore delle macchie superficiali.

cmap Mappa dei colori

Colormap delle macchie di superficie.

facecolors simile a una matrice di colori.

Colori di ogni singola patch.

norma Normalizzare

Normalizzazione per la mappa dei colori.

vmin, vmax float

Limiti per la normalizzazione.

ombra bool, predefinito: vero

Se sfumare i facecolors. L' ombreggiatura è sempre disabilitata quando è specificato cmap .

fonte di luceLightSource

La sorgente luminosa da usare quando shade è True.

**kwargs

Altri argomenti vengono inoltrati a Poly3DCollection.

plot_trisurf ( * args , color = None , norm = None , vmin = None , vmax = None , lightsource = None , ** kwargs ) [fonte] #

Traccia una superficie triangolata.

La triangolazione (facoltativa) può essere specificata in due modi; o:

plot_trisurf(triangulation, ...)

dove la triangolazione è un Triangulationoggetto, oppure:

plot_trisurf(X, Y, ...)
plot_trisurf(X, Y, triangles, ...)
plot_trisurf(X, Y, triangles=triangles, ...)

in tal caso verrà creato un oggetto Triangolazione. Vedere Triangulationper una spiegazione di queste possibilità.

Le restanti argomentazioni sono:

plot_trisurf(..., Z)

dove Z è l'array di valori da contornare, uno per punto nella triangolazione.

Parametri :
X, Y, Z simile a un array

Valori di dati come matrici 1D.

colore

Colore delle macchie superficiali.

cmap

Una mappa dei colori per i patch di superficie.

norma Normalizzare

Un'istanza di Normalize per mappare i valori ai colori.

vmin, vmax float, predefinito: nessuno

Valore minimo e massimo da mappare.

ombra bool, predefinito: vero

Se sfumare i facecolors. L' ombreggiatura è sempre disabilitata quando è specificato cmap .

fonte di luceLightSource

La sorgente luminosa da usare quando shade è True.

**kwargs

Tutti gli altri argomenti vengono passati a Poly3DCollection

Esempi

( Codice sorgente , png )

../../_images/trisurf3d.png

( Codice sorgente , png )

../../_images/trisurf3d_2.png
plot_wireframe ( X , Y , Z , ** kwargs ) [fonte] #

Traccia un wireframe 3D.

Nota

I valori rcount e ccount kwargs, che per impostazione predefinita sono entrambi 50, determinano il numero massimo di campioni utilizzati in ciascuna direzione. Se i dati di input sono più grandi, verranno sottoposti a downsampling (tagliando) a questi numeri di punti.

Parametri :
Matrici X, Y, Z 2D

Valori dei dati.

rcount, ccount int

Numero massimo di campioni utilizzati in ciascuna direzione. Se i dati di input sono più grandi, verranno sottoposti a downsampling (tagliando) a questi numeri di punti. L'impostazione di un conteggio su zero fa sì che i dati non vengano campionati nella direzione corrispondente, producendo un grafico a linee 3D anziché un grafico wireframe. Il valore predefinito è 50.

stride, cstride int

Downsampling falcata in ogni direzione. Questi argomenti si escludono a vicenda con rcount e ccount . Se è impostato solo uno tra rstride o cstride , l'altro valore predefinito è 1. L'impostazione di uno stride su zero fa sì che i dati non vengano campionati nella direzione corrispondente, producendo un grafico a linee 3D anziché un grafico wireframe.

La modalità "classica" utilizza un'impostazione predefinita di anziché la nuova impostazione predefinita di .rstride = cstride = 1rcount = ccount = 50

**kwargs

Altri argomenti vengono inoltrati a Line3DCollection.

faretra ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [fonte] #

Traccia un campo di frecce 3D.

Gli argomenti possono essere di tipo array o scalari, purché possano essere trasmessi insieme. Gli argomenti possono anche essere array mascherati. Se un elemento in uno qualsiasi degli argomenti è mascherato, l'elemento quiver corrispondente non verrà tracciato.

Parametri :
X, Y, Z simile a un array

Le coordinate x, yez delle posizioni delle frecce (l'impostazione predefinita è la coda della freccia; vedi pivot kwarg).

U, V, W simile a un array

Le componenti x, y e z dei vettori freccia.

float di lunghezza , predefinito: 1

La lunghezza di ogni faretra.

arrow_length_ratio float, predefinito: 0.3

Il rapporto tra la punta della freccia e la faretra.

pivot {'tail', 'middle', 'tip'}, default: 'tail'

La parte della freccia che si trova nel punto della griglia; la freccia ruota attorno a questo punto, da qui il nome pivot .

normalize bool, default: False

Se tutte le frecce sono normalizzate per avere la stessa lunghezza o mantenere le lunghezze definite da u , v e w .

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

**kwargs

Eventuali argomenti di parole chiave aggiuntivi vengono delegati a LineCollection

quiver3D ( X , Y , Z , U , V , W , / , length = 1 , arrow_length_ratio = .3 , pivot = 'tail' , normalize = False , ** kwargs ) [fonte] #

Traccia un campo di frecce 3D.

Gli argomenti possono essere di tipo array o scalari, purché possano essere trasmessi insieme. Gli argomenti possono anche essere array mascherati. Se un elemento in uno qualsiasi degli argomenti è mascherato, l'elemento quiver corrispondente non verrà tracciato.

Parametri :
X, Y, Z simile a un array

Le coordinate x, yez delle posizioni delle frecce (l'impostazione predefinita è la coda della freccia; vedi pivot kwarg).

U, V, W simile a un array

Le componenti x, y e z dei vettori freccia.

float di lunghezza , predefinito: 1

La lunghezza di ogni faretra.

arrow_length_ratio float, predefinito: 0.3

Il rapporto tra la punta della freccia e la faretra.

pivot {'tail', 'middle', 'tip'}, default: 'tail'

La parte della freccia che si trova nel punto della griglia; la freccia ruota attorno a questo punto, da qui il nome pivot .

normalize bool, default: False

Se tutte le frecce sono normalizzate per avere la stessa lunghezza o mantenere le lunghezze definite da u , v e w .

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

**kwargs

Eventuali argomenti di parole chiave aggiuntivi vengono delegati a LineCollection

scatter ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [fonte] #

Crea un grafico a dispersione.

Parametri :
xs, ys simile a un array

Le posizioni dei dati.

zs float o simile ad un array, default: 0

Le posizioni z. Un array della stessa lunghezza di xs e ys o un singolo valore per posizionare tutti i punti sullo stesso piano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, predefinito: 'z'

La direzione dell'asse per zs . Ciò è utile quando si tracciano dati 2D su un asse 3D. I dati devono essere passati come xs , ys . Impostando zdir su 'y' si tracciano i dati sul piano xz.

Vedere anche Tracciare dati 2D su tracciato 3D .

s float o simile a un array, predefinito: 20

La dimensione dell'indicatore in punti**2. O un array della stessa lunghezza di xs e ys o un singolo valore per rendere tutti i marcatori della stessa dimensione.

c colore, sequenza o sequenza di colori, facoltativo

Il colore dell'indicatore. Possibili valori:

  • Una stringa di formato a colore singolo.

  • Una sequenza di colori di lunghezza n.

  • Una sequenza di n numeri da mappare ai colori usando cmap e norm .

  • Una matrice 2D in cui le righe sono RGB o RGBA.

Per maggiori dettagli vedere l' argomento cscatter di .

depthshade bool, predefinito: vero

Se ombreggiare gli indicatori di dispersione per dare l'impressione di profondità. Ogni chiamata a scatter()eseguirà il suo depthshading in modo indipendente.

oggetto indicizzabile dei dati , facoltativo

Se forniti, i seguenti parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione):

xs , ys , zs , s , edgecolors , c , facecolor , facecolors , colore

**kwargs

Tutti gli altri argomenti vengono passati a scatter.

Resi :
percorsiPathCollection
scatter3D ( xs , ys , zs = 0 , zdir = 'z' , s = 20 , c = None , depthshade = True , * args , data = None , ** kwargs ) [fonte] #

Crea un grafico a dispersione.

Parametri :
xs, ys simile a un array

Le posizioni dei dati.

zs float o simile ad un array, default: 0

Le posizioni z. Un array della stessa lunghezza di xs e ys o un singolo valore per posizionare tutti i punti sullo stesso piano.

zdir {'x', 'y', 'z', '-x', '-y', '-z'}, predefinito: 'z'

La direzione dell'asse per zs . Ciò è utile quando si tracciano dati 2D su un asse 3D. I dati devono essere passati come xs , ys . Impostando zdir su 'y' si tracciano i dati sul piano xz.

Vedere anche Tracciare dati 2D su tracciato 3D .

s float o simile a un array, predefinito: 20

La dimensione dell'indicatore in punti**2. O un array della stessa lunghezza di xs e ys o un singolo valore per rendere tutti i marcatori della stessa dimensione.

c colore, sequenza o sequenza di colori, facoltativo

Il colore dell'indicatore. Possibili valori:

  • Una stringa di formato a colore singolo.

  • Una sequenza di colori di lunghezza n.

  • Una sequenza di n numeri da mappare ai colori usando cmap e norm .

  • Una matrice 2D in cui le righe sono RGB o RGBA.

Per maggiori dettagli vedere l' argomento cscatter di .

depthshade bool, predefinito: vero

Se ombreggiare gli indicatori di dispersione per dare l'impressione di profondità. Ogni chiamata a scatter()eseguirà il suo depthshading in modo indipendente.

oggetto indicizzabile dei dati , facoltativo

Se forniti, i seguenti parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione):

xs , ys , zs , s , edgecolors , c , facecolor , facecolors , colore

**kwargs

Tutti gli altri argomenti vengono passati a scatter.

Resi :
percorsiPathCollection
set ( * , Adjustable=<DISINS.> , agg_filter=<DISINS.> , alpha=<DISINS.> , anchor=<DISINS .> , animation=<DISINS. > , aspect=<DISINS.> , autoscale_on=<DISINS.> , autoscalex_on=<DIS. > , autoscaley_on=<UNSET> , autoscalez_on=<UNSET> , axis_locator=<UNSET> , axisbelow=<UNSET> , box_aspect=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , colorefaccia=<UNSET> , frame_on=<UNSET>, gid=<UNSET> , in_layout=<UNSET> , label=<UNSET> , mouseover=<UNSET> , navigate=<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=< DISINSERITO> , visibile=<DISINSERITO>, 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=<UNSET> , zlim3d=<UNSET>, zmargin=<UNSET> ,zorder=<UNSET> , zscale=<UNSET> , zticklabels=<UNSET> , zticks=<UNSET> ) [fonte] #

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà

Descrizione

adjustable

{'box', 'datalim'}

agg_filter

una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine

alpha

scalare o Nessuno

anchor

(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}

animated

bool

aspect

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

autoscale_on

bool

autoscalex_on

sconosciuto

autoscaley_on

sconosciuto

autoscalez_on

sconosciuto

axes_locator

Callable[[Assi, Renderer], Bbox]

axisbelow

bool o 'linea'

box_aspect

3 tuple di float o Nessuno

clip_box

Bbox

clip_on

bool

clip_path

Patch o (Percorso, Trasforma) o Nessuno

facecoloro fc

colore

figure

Figure

frame_on

bool

gid

str

in_layout

bool

label

oggetto

mouseover

bool

navigate

bool

navigate_mode

sconosciuto

path_effects

AbstractPathEffect

picker

Nessuno o bool o float o richiamabile

position

[sinistra, fondo, larghezza, altezza] oBbox

proj_type

{'persp', 'orto'}

prop_cycle

sconosciuto

rasterization_zorder

float o Nessuno

rasterized

bool

sketch_params

(scala: float, lunghezza: float, casualità: float)

snap

bool o Nessuno

title

sconosciuto

transform

Transform

url

str

visible

bool

xbound

sconosciuto

xlabel

str

xlim

(in basso: galleggiante, in alto: galleggiante)

xlim3d

(in basso: galleggiante, in alto: galleggiante)

xmargin

float maggiore di -0,5

xscale

sconosciuto

xticklabels

sconosciuto

xticks

sconosciuto

ybound

sconosciuto

ylabel

str

ylim

(in basso: galleggiante, in alto: galleggiante)

ylim3d

(in basso: galleggiante, in alto: galleggiante)

ymargin

float maggiore di -0,5

yscale

sconosciuto

yticklabels

sconosciuto

yticks

sconosciuto

zbound

sconosciuto

zlabel

sconosciuto

zlim

sconosciuto

zlim3d

sconosciuto

zmargin

float maggiore di -0,5

zorder

galleggiante

zscale

sconosciuto

zticklabels

sconosciuto

zticks

sconosciuto

set_aspect ( aspetto , regolabile = Nessuno , ancoraggio = Nessuno , condivisione = Falso ) [fonte] #

Imposta le proporzioni.

Parametri :
aspetto {'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}

Possibili valori:

valore

descrizione

'auto'

automatico; riempire il rettangolo di posizione con i dati.

'pari'

adattare tutti gli assi in modo che abbiano proporzioni uguali.

'equalxy'

adattare gli assi x e y in modo che abbiano proporzioni uguali.

'ugualexz'

adattare gli assi xez per avere proporzioni uguali.

'equalizzare'

adattare gli assi y e z per avere proporzioni uguali.

regolabile Nessuno

Attualmente ignorato da Axes3D

Se non è None , definisce quale parametro verrà regolato per soddisfare l'aspetto richiesto. Vedere set_adjustableper ulteriori dettagli.

anchor None o str o 2 tuple di float, facoltativo

Se non è None , questo definisce dove verranno disegnati gli assi se c'è spazio extra a causa di vincoli di aspetto. Il modo più comune per specificare l'ancora sono le abbreviazioni delle direzioni cardinali:

valore

descrizione

'C'

centrato

'SW'

angolo in basso a sinistra

'S'

mezzo del bordo inferiore

'SE'

angolo in basso a destra

eccetera.

Vedere set_anchorper ulteriori dettagli.

condividi bool, predefinito: Falso

Se True, applica le impostazioni a tutti gli assi condivisi.

set_autoscalez_on ( b ) [fonte] #

Imposta se l'asse z viene ridimensionato automaticamente durante il disegno o tramite Axes.autoscale_view.

Parametri :
b bool
set_axis_off ( ) [fonte] #

Disattiva gli assi x e y.

Ciò influisce sulle linee dell'asse, sui segni di spunta, sulle etichette di spunta, sulla griglia e sulle etichette degli assi.

set_axis_on ( ) [fonte] #

Attiva l'asse x e y.

Ciò influisce sulle linee dell'asse, sui segni di spunta, sulle etichette di spunta, sulla griglia e sulle etichette degli assi.

set_box_aspect ( aspetto , * , zoom = 1 ) [fonte] #

Imposta l'aspetto della casella degli assi.

L'aspetto della scatola è il rapporto tra altezza e larghezza in unità di visualizzazione per ciascuna faccia della scatola se vista perpendicolarmente a quella faccia. Questo non deve essere confuso con l'aspetto dei dati (che per Axes3D è sempre 'auto'). I rapporti predefiniti sono 4:4:3 (x:y:z).

Per simulare lo stesso aspetto nello spazio dati, imposta l'aspetto della casella in modo che corrisponda al tuo intervallo di dati in ogni dimensione.

zoom controlla la dimensione complessiva di Axes3D nella figura.

Parametri :
aspetto 3 tuple di float o None

Modifica le dimensioni fisiche di Axes3D, in modo tale che il rapporto delle lunghezze degli assi nelle unità di visualizzazione sia x:y:z. Se Nessuno, il valore predefinito è (4,4,3).

zoom mobile, predefinito: 1

Controlla la dimensione complessiva di Axes3D nella figura. Deve essere > 0.

set_frame_on ( b ) [fonte] #

Imposta se i pannelli degli assi 3D vengono disegnati.

Parametri :
b bool
set_proj_type ( proj_type , focal_length = None ) [fonte] #

Imposta il tipo di proiezione.

Parametri :
proj_type {'persp', 'ortho'}

Il tipo di proiezione.

focal_length float, predefinito: nessuno

Per un tipo di proiezione di 'persp', la lunghezza focale della telecamera virtuale. Deve essere > 0. Se None, il valore predefinito è 1. La lunghezza focale può essere calcolata da un campo visivo desiderato tramite l'equazione: focal_length = 1/tan(FOV/2)

set_title ( label , fontdict = None , loc = 'center' , ** kwargs ) [fonte] #

Imposta un titolo per gli assi.

Imposta uno dei tre titoli Axes disponibili. I titoli disponibili sono posizionati sopra gli Assi al centro, a filo con il bordo sinistro ea filo con il bordo destro.

Parametri :
etichetta str

Testo da utilizzare per il titolo

fontdict dict

Un dizionario che controlla l'aspetto del testo del titolo, il fontdict predefinito è:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'color': rcParams['axes.titlecolor'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
loc {'center', 'left', 'right'}, predefinito: rcParams["axes.titlelocation"](predefinito: 'center')

Quale titolo impostare.

y float, predefinito: rcParams["axes.titley"](predefinito: None)

Posizione degli assi verticali per il titolo (1.0 è il massimo). Se None (predefinito) e rcParams["axes.titley"](default: None) è anche None, y viene determinato automaticamente per evitare i decoratori sugli assi.

pad float, predefinito: rcParams["axes.titlepad"](predefinito: 6.0)

L'offset del titolo dalla parte superiore degli assi, in punti.

Resi :
Text

L'istanza di testo matplotlib che rappresenta il titolo

Altri parametri :
** proprietà kwargsText

Altri argomenti di parole chiave sono proprietà di testo, vedere Textper un elenco di proprietà di testo valide.

set_top_view ( ) [fonte] #
set_xlim3d ( left = None , right = None , * , emit = True , auto = False , xmin = None , xmax = None ) [fonte] #

Imposta i limiti di visualizzazione dell'asse x.

Parametri :
float sinistro , facoltativo

La xlim sinistra nelle coordinate dei dati. Il superamento di Nessuno lascia il limite invariato.

Gli xlim sinistro e destro possono anche essere passati come tupla ( left , right ) come primo argomento posizionale (o come argomento della parola chiave left ).

float destro , facoltativo

Il giusto xlim nelle coordinate dei dati. Il superamento di Nessuno lascia il limite invariato.

emit bool, default: True

Se notificare agli osservatori la modifica dei limiti.

auto bool o Nessuno, predefinito: False

Se attivare il ridimensionamento automatico dell'asse x. Vero si attiva, Falso si disattiva, Nessuno lascia invariato.

xmin, xmax float, opzionale

Sono equivalenti rispettivamente a left e right ed è un errore passare sia xmin che left o xmax e right .

Resi :
sinistra, destra (float, float)

I nuovi limiti dell'asse x nelle coordinate dei dati.

Guarda anche

get_xlim
set_xbound,get_xbound
invert_xaxis,xaxis_inverted

Appunti

Il valore a sinistra può essere maggiore del valore a destra , nel qual caso i valori dell'asse x diminuiranno da sinistra a destra.

Esempi

>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

Un limite può essere lasciato invariato.

>>> set_xlim(right=right_lim)

I limiti possono essere superati in ordine inverso per invertire la direzione dell'asse x. Ad esempio, supponiamo che x rappresenti il ​​numero di anni prima del presente. I limiti dell'asse x potrebbero essere impostati come segue, quindi 5000 anni fa è a sinistra della trama e il presente è a destra.

>>> set_xlim(5000, 0)
set_xscale ( valore , ** kwargs ) [fonte] #

Imposta la scala dell'asse x.

Parametri :
valore {"lineare"}

Il tipo di scala dell'asse da applicare. Gli assi 3D attualmente supportano solo scale lineari; altre scale danno risultati senza senso.

**kwargs

Gli argomenti delle parole chiave vengono nominalmente inoltrati alla classe della scala, ma nessuno di essi è applicabile per le scale lineari.

set_ylim3d ( bottom = Nessuno , top = Nessuno , * , emit = True , auto = False , ymin = Nessuno , ymax = Nessuno ) [fonte] #

Imposta i limiti di visualizzazione dell'asse y.

Parametri :
galleggiante inferiore , opzionale

Il fondo ylim nelle coordinate dei dati. Il superamento di Nessuno lascia il limite invariato.

Gli ylim bottom e top possono anche essere passati come tupla ( bottom , top ) come primo argomento posizionale (o come argomento della parola chiave bottom ).

galleggiante superiore , opzionale

Il top ylim nelle coordinate dei dati. Il superamento di Nessuno lascia il limite invariato.

emit bool, default: True

Se notificare agli osservatori la modifica dei limiti.

auto bool o Nessuno, predefinito: False

Se attivare il ridimensionamento automatico dell'asse y. Vero si attiva, Falso si disattiva, Nessuno lascia invariato.

ymin, ymax float, facoltativo

Sono equivalenti rispettivamente a bottom e top ed è un errore passare sia ymin che bottom o ymax e top .

Resi :
in basso, in alto (float, float)

I nuovi limiti dell'asse y nelle coordinate dei dati.

Guarda anche

get_ylim
set_ybound,get_ybound
invert_yaxis,yaxis_inverted

Appunti

Il valore inferiore può essere maggiore del valore superiore , nel qual caso i valori dell'asse y diminuiranno dal basso verso l' alto .

Esempi

>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)

Un limite può essere lasciato invariato.

>>> set_ylim(top=top_lim)

I limiti possono essere superati in ordine inverso per invertire la direzione dell'asse y. Ad esempio, supponiamo yrappresenti la profondità dell'oceano in m. I limiti dell'asse y possono essere impostati come segue, quindi 5000 m di profondità sono nella parte inferiore del grafico e la superficie, 0 m, è nella parte superiore.

>>> set_ylim(5000, 0)
set_yscale ( valore , ** kwargs ) [fonte] #

Imposta la scala dell'asse y.

Parametri :
valore {"lineare"}

Il tipo di scala dell'asse da applicare. Gli assi 3D attualmente supportano solo scale lineari; altre scale danno risultati senza senso.

**kwargs

Gli argomenti delle parole chiave vengono nominalmente inoltrati alla classe della scala, ma nessuno di essi è applicabile per le scale lineari.

set_zbound ( inferiore = Nessuno , superiore = Nessuno ) [fonte] #

Impostare i limiti numerici inferiore e superiore dell'asse z.

Questo metodo rispetterà l'inversione degli assi indipendentemente dall'ordine dei parametri. Non cambierà l'impostazione di ridimensionamento automatico ( get_autoscalez_on()).

set_zlabel ( zlabel , fontdict = Nessuno , labelpad = Nessuno , ** kwargs ) [fonte] #

Imposta etichetta z. Vedere il documento per set_ylabella descrizione.

set_zlim ( bottom = Nessuno , top = Nessuno , * , emit = True , auto = False , zmin = Nessuno , zmax = Nessuno ) [fonte] #

Imposta i limiti z 3D.

Vedere Axes.set_ylimper la documentazione completa

set_zlim3d ( bottom = Nessuno , top = Nessuno , * , emit = True , auto = False , zmin = Nessuno , zmax = Nessuno ) [fonte] #

Alias ​​per set_zlim.

set_zmargin ( m ) [fonte] #

Imposta il riempimento dei limiti di dati Z prima della scalabilità automatica.

m volte l'intervallo di dati verrà aggiunto a ciascuna estremità di tale intervallo prima che venga utilizzato nel ridimensionamento automatico. Se m è negativo, questo taglierà l'intervallo di dati invece di espanderlo.

Ad esempio, se i tuoi dati sono nell'intervallo [0, 2], un margine di 0,1 risulterà in un intervallo [-0,2, 2,2]; un margine di -0,1 risulterà in un intervallo di [0,2, 1,8].

Parametri :
m float maggiore di -0,5
set_zscale ( valore , ** kwargs ) [fonte] #

Imposta la scala dell'asse z.

Parametri :
valore {"lineare"}

Il tipo di scala dell'asse da applicare. Gli assi 3D attualmente supportano solo scale lineari; altre scale danno risultati senza senso.

**kwargs

Gli argomenti delle parole chiave vengono nominalmente inoltrati alla classe della scala, ma nessuno di essi è applicabile per le scale lineari.

set_zticklabels ( etichette , * , fontdict = None , minor = False , ** kwargs ) [fonte] #

Imposta le etichette dello zaxis con l'elenco delle etichette delle stringhe.

Avvertimento

Questo metodo dovrebbe essere utilizzato solo dopo aver fissato le posizioni del tick utilizzando Axes3D.set_zticks. In caso contrario, le etichette potrebbero finire in posizioni impreviste.

Parametri :
etichette elenco di str

I testi delle etichette.

fontdict dict, facoltativo

Un dizionario che controlla l'aspetto delle ticklabel. Il fontdict predefinito è:

{'fontsize': rcParams['axes.titlesize'],
 'fontweight': rcParams['axes.titleweight'],
 'verticalalignment': 'baseline',
 'horizontalalignment': loc}
minor bool, default: False

Se impostare le ticklabel minori piuttosto che quelle maggiori.

Resi :
lista diText

Le etichette.

Altri parametri :
** Textproprietà kwargs.
set_zticks ( tick , etichette = None , * , minor = False , ** kwargs ) [fonte] #

Impostare le posizioni delle zecche dello zaxis e, facoltativamente, le etichette.

Se necessario, i limiti di visualizzazione dell'asse vengono espansi in modo che tutti i segni di graduazione siano visibili.

Parametri :
spunta l' elenco dei float

Elenco delle posizioni delle zecche. L'asse Locatorè sostituito da un FixedLocator.

Alcuni formattatori di tick non etichettano posizioni di tick arbitrarie; ad esempio, i formattatori di registro etichettano solo i segni di spunta del decennio per impostazione predefinita. In tal caso, puoi impostare esplicitamente un formattatore sull'asse utilizzando Axis.set_major_formattero fornire tu stesso etichette formattate .

etichette elenco di str, facoltativo

Elenco delle etichette di spunta. Se non impostato, le etichette vengono generate con il segno di spunta dell'asse Formatter.

minor bool, default: False

If False, imposta i tick principali; if True, i tick minori.

**kwargs

Textproprietà per le etichette. Questi hanno effetto solo se passi le etichette . Negli altri casi, utilizzare tick_params.

Appunti

L'espansione obbligatoria dei limiti di visualizzazione è una scelta progettuale intenzionale per evitare la sorpresa di un segno di spunta non visibile. Se hai bisogno di altri limiti, dovresti impostare i limiti in modo esplicito dopo aver impostato i tick.

sharez ( altro ) [fonte] #

Condividi l'asse z con altri .

Ciò equivale a passare sharex=otherdurante la costruzione degli assi e non può essere utilizzato se l'asse z è già condiviso con un altro asse.

radice ( x , y , z , * , linefmt = 'C0-' , markerfmt = 'C0o' , basefmt = 'C3-' , bottom = 0 , label = None , orientamento = 'z' , data = None ) [fonte ] #

Crea un grafico a stelo 3D.

Un grafico a stelo disegna linee perpendicolari a una linea di base e posiziona i marcatori sulle teste. Per impostazione predefinita, la linea di base è definita da x e y e i gambi sono disegnati verticalmente dal basso alla z .

Parametri :
x, y, z simile a un array

Le posizioni delle teste degli steli. Gli steli sono disegnati lungo la direzione di orientamento dalla linea di base in basso (nella coordinata di orientamento ) alle teste. Per impostazione predefinita, le posizioni x e y vengono utilizzate per la linea di base e z per la posizione della testa, ma questa può essere modificata dall'orientamento .

linefmt str, predefinito: 'C0-'

Una stringa che definisce le proprietà delle linee verticali. Di solito, questo sarà un colore o un colore e uno stile di linea:

Carattere

Stile linea

'-'

linea continua

'--'

linea tratteggiata

'-.'

linea tratteggiata

':'

linea tratteggiata

Nota: sebbene sia tecnicamente possibile specificare formati validi diversi da colore o colore e stile di linea (ad esempio 'rx' o '-.'), ciò va oltre l'intenzione del metodo e molto probabilmente non risulterà in una trama ragionevole.

markerfmt str, predefinito: 'C0o'

Una stringa che definisce le proprietà dei marcatori sulle teste dei gambi.

basefmt str, predefinito: 'C3-'

Una stringa di formato che definisce le proprietà della linea di base.

float inferiore , predefinito: 0

La posizione della linea di base, in coordinate di orientamento .

label str, predefinito: Nessuno

L'etichetta da utilizzare per le radici nelle legende.

orientamento {'x', 'y', 'z'}, predefinito: 'z'

La direzione lungo la quale vengono disegnati i gambi.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

Resi :
StemContainer

Il contenitore può essere trattato come una tupla ( markerline , stemlines , baseline )

Esempi

( Codice sorgente , 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 , orientamento = 'z' , data = None ) [fonte ] #

Crea un grafico a stelo 3D.

Un grafico a stelo disegna linee perpendicolari a una linea di base e posiziona i marcatori sulle teste. Per impostazione predefinita, la linea di base è definita da x e y e i gambi sono disegnati verticalmente dal basso alla z .

Parametri :
x, y, z simile a un array

Le posizioni delle teste degli steli. Gli steli sono disegnati lungo la direzione di orientamento dalla linea di base in basso (nella coordinata di orientamento ) alle teste. Per impostazione predefinita, le posizioni x e y vengono utilizzate per la linea di base e z per la posizione della testa, ma questa può essere modificata dall'orientamento .

linefmt str, predefinito: 'C0-'

Una stringa che definisce le proprietà delle linee verticali. Di solito, questo sarà un colore o un colore e uno stile di linea:

Carattere

Stile linea

'-'

linea continua

'--'

linea tratteggiata

'-.'

linea tratteggiata

':'

linea tratteggiata

Nota: sebbene sia tecnicamente possibile specificare formati validi diversi da colore o colore e stile di linea (ad esempio 'rx' o '-.'), ciò va oltre l'intenzione del metodo e molto probabilmente non risulterà in una trama ragionevole.

markerfmt str, predefinito: 'C0o'

Una stringa che definisce le proprietà dei marcatori sulle teste dei gambi.

basefmt str, predefinito: 'C3-'

Una stringa di formato che definisce le proprietà della linea di base.

float inferiore , predefinito: 0

La posizione della linea di base, in coordinate di orientamento .

label str, predefinito: Nessuno

L'etichetta da utilizzare per le radici nelle legende.

orientamento {'x', 'y', 'z'}, predefinito: 'z'

La direzione lungo la quale vengono disegnati i gambi.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

Resi :
StemContainer

Il contenitore può essere trattato come una tupla ( markerline , stemlines , baseline )

Esempi

( Codice sorgente , 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 = Nessuno , ** kwargs ) [fonte] #

Aggiungi testo alla trama. kwargs verrà passato ad Axes.text, ad eccezione della parola chiave zdir , che imposta la direzione da utilizzare come direzione z.

text2D ( x , y , s , fontdict = None , ** kwargs ) [fonte] #

Aggiungi testo agli assi.

Aggiungi il testo s agli assi nella posizione x , y nelle coordinate dei dati.

Parametri :
x, y fluttuano

La posizione in cui posizionare il testo. Per impostazione predefinita, questo è nelle coordinate dei dati. Il sistema di coordinate può essere modificato utilizzando il parametro di trasformazione .

str _

Il testo.

fontdict dict, predefinito: Nessuno

Un dizionario per sovrascrivere le proprietà di testo predefinite. Se fontdict è None, i valori predefiniti sono determinati da rcParams.

Resi :
Text

L' Textistanza creata.

Altri parametri :
** Textproprietà kwargs.

Altri parametri di testo vari.

Proprietà

Descrizione

agg_filter

una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine

alpha

scalare o Nessuno

animated

bool

backgroundcolor

colore

bbox

dict con proprietà perpatches.FancyBboxPatch

clip_box

sconosciuto

clip_on

sconosciuto

clip_path

sconosciuto

coloro c

colore

figure

Figure

fontfamilyo famiglia

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

fontpropertieso font o font_properties

font_manager.FontPropertieso stropathlib.Path

fontsizeo dimensione

float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

fontstretcho allungare

{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}

fontstyleo stile

{'normale', 'corsivo', 'obliquo'}

fontvarianto variante

{'normale', 'maiuscoletto'}

fontweighto peso

{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}

gid

str

horizontalalignmento ah

{'sinistra', 'centro', 'destra'}

in_layout

bool

label

oggetto

linespacing

float (multiplo della dimensione del carattere)

math_fontfamily

str

mouseover

bool

multialignmento mamma

{'sinistra', 'destra', 'centro'}

parse_math

bool

path_effects

AbstractPathEffect

picker

Nessuno o bool o float o richiamabile

position

(galleggiare, galleggiare)

rasterized

bool

rotation

float o {'verticale', 'orizzontale'}

rotation_mode

{Nessuno, 'predefinito', 'ancora'}

sketch_params

(scala: float, lunghezza: float, casualità: float)

snap

bool o Nessuno

text

oggetto

transform

Transform

transform_rotates_text

bool

url

str

usetex

bool o Nessuno

verticalalignmento Va

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

visible

bool

wrap

bool

x

galleggiante

y

galleggiante

zorder

galleggiante

Esempi

I singoli argomenti di parole chiave possono essere utilizzati per sovrascrivere qualsiasi parametro dato:

>>> text(x, y, s, fontsize=12)

La trasformazione predefinita specifica che il testo è nelle coordinate dei dati, in alternativa, è possibile specificare il testo nelle coordinate dell'asse ((0, 0) è in basso a sinistra e (1, 1) è in alto a destra). L'esempio seguente posiziona il testo al centro degli assi:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Puoi inserire un riquadro rettangolare attorno all'istanza di testo (ad esempio, per impostare un colore di sfondo) utilizzando la parola chiave bbox . bbox è un dizionario di Rectangle proprietà. Per esempio:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))
text3D ( x , y , z , s , zdir = Nessuno , ** kwargs ) [fonte] #

Aggiungi testo alla trama. kwargs verrà passato ad Axes.text, ad eccezione della parola chiave zdir , che imposta la direzione da utilizzare come direzione z.

tick_params ( axis = 'both' , ** kwargs ) [fonte] #

Metodo pratico per modificare l'aspetto delle zecche e delle etichette delle zecche.

Vedere Axes.tick_paramsper la documentazione completa. Poiché questa funzione si applica agli assi 3D, l' asse può anche essere impostato su "z" e l'impostazione dell'asse su "entrambi" ridimensiona automaticamente tutti e tre gli assi.

Inoltre, a causa del modo in cui gli oggetti Axes3D vengono disegnati in modo molto diverso dai normali assi 2D, alcune di queste impostazioni potrebbero avere un significato ambiguo. Per semplicità, l'asse "z" accetterà le impostazioni come se fosse come l'asse "y".

Nota

Axes3D attualmente ignora alcune di queste impostazioni.

tricontour ( * args , extend3d = False , stride = 5 , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno 3D.

Nota

Questo metodo attualmente produce un output non corretto a causa di un bug di vecchia data nel rendering 3D PolyCollection.

Parametri :
X, Y, Z simile a un array

Dati in ingresso. Vedere Axes.tricontourper le forme di dati supportate.

extend3d bool, predefinito: falso

Se estendere il contorno in 3D.

passo int

Dimensione del passo per l'estensione del contorno.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.tricontour.

Resi :
matplotlib.tri.tricontour.TriContourSet
tricontourf ( * args , zdir = 'z' , offset = None , data = None , ** kwargs ) [fonte] #

Crea un grafico di contorno riempito 3D.

Nota

Questo metodo attualmente produce un output non corretto a causa di un bug di vecchia data nel rendering 3D PolyCollection.

Parametri :
X, Y, Z simile a un array

Dati in ingresso. Vedere Axes.tricontourfper le forme di dati supportate.

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

La direzione da usare.

offset float, facoltativo

Se specificato, tracciare una proiezione delle curve di livello in questa posizione in un piano normale a zdir.

oggetto indicizzabile dei dati , facoltativo

Se fornito, tutti i parametri accettano anche una stringa s, che viene interpretata come data[s](a meno che ciò non sollevi un'eccezione).

*args, **kwargs

Altri argomenti vengono inoltrati a matplotlib.axes.Axes.tricontourf.

Resi :
matplotlib.tri.tricontour.TriContourSet
tunit_cube ( vals = Nessuno , M = Nessuno ) [fonte] #
tunit_edges ( vals = Nessuno , M = Nessuno ) [fonte] #
unit_cube ( vals = None ) [fonte] #
update_datalim ( xys , ** kwargs ) [fonte] #

Estendi la dataLimBbox per includere i punti dati.

Se nessun dato è attualmente impostato, la Bbox ignorerà i suoi limiti e imposterà il limite in modo che sia il limite di xydata ( xys ). In caso contrario, calcolerà i limiti dell'unione dei suoi dati correnti e dei dati in xys .

Parametri :
xys simile a un array 2D

I punti da includere nei limiti di dati Bbox. Questo può essere un elenco di tuple (x, y) o un array Nx2.

updatex, updatey bool, predefinito: vero

Se aggiornare i limiti x/y.

view_init ( elev = None , azim = None , roll = None , vertical_axis = 'z' ) [fonte] #

Impostare l'elevazione e l'azimut degli assi in gradi (non in radianti).

Questo può essere utilizzato per ruotare gli assi a livello di codice.

Per sembrare normale ai piani primari, è possibile utilizzare i seguenti angoli di elevazione e azimut. Un angolo di rollio di 0, 90, 180 o 270 gradi ruoterà queste viste mantenendo gli assi ad angolo retto.

vista piana

elevazione

azim

XY

90

-90

XZ

0

-90

YZ

0

0

-XY

-90

90

-XZ

0

90

-YZ

0

180

Parametri :
elev float, predefinito: Nessuno

L'angolo di elevazione in gradi ruota la telecamera sopra il piano attraversato dall'asse verticale, con un angolo positivo corrispondente a una posizione al di sopra di tale piano. Ad esempio, con l'asse verticale predefinito 'z', l'elevazione definisce l'angolo della posizione della telecamera sopra il piano xy. Se None, viene utilizzato il valore iniziale specificato nel Axes3D costruttore.

azim float, predefinito: Nessuno

L'angolo azimutale in gradi ruota la telecamera attorno all'asse verticale, con un angolo positivo corrispondente a una rotazione verso destra. Ad esempio, con l'asse verticale predefinito "z", un azimut positivo ruota la telecamera attorno all'origine dalla sua posizione lungo l'asse +x verso l'asse +y. Se None, viene utilizzato il valore iniziale specificato nel Axes3D costruttore.

roll float, predefinito: Nessuno

L'angolo di rollio in gradi ruota la telecamera attorno all'asse di visualizzazione. Un angolo positivo fa ruotare la telecamera in senso orario, facendo ruotare la scena in senso antiorario. Se None, viene utilizzato il valore iniziale specificato nel Axes3D costruttore.

asse_verticale {"z", "x", "y"}, predefinito: "z"

L'asse da allineare verticalmente. azim ruota attorno a questo asse.

voxel ( [ x , y , z , ] / , filled , facecolors=None , edgecolors=None , **kwargs ) [fonte] #

Traccia una serie di voxel pieni

Tutti i voxel sono tracciati come cubi 1x1x1 sull'asse, posizionati con l'angolo inferiore all'origine. Le facce occluse non vengono stampate.filled[0, 0, 0]

Parametri :
riempito 3D np.array di bool

Una matrice 3D di valori, con valori veritieri che indicano quali voxel riempire

x, y, z 3D np.array, facoltativo

Le coordinate degli angoli dei voxel. Questo dovrebbe trasmettere a una forma più grande in ogni dimensione rispetto alla forma di filled . Questi possono essere usati per tracciare voxel non cubici.

Se non specificato, per impostazione predefinita aumenta i numeri interi lungo ciascun asse, come quelli restituiti da indices(). Come indicato dalla /firma della funzione, questi argomenti possono essere passati solo in posizione.

facecolors, edgecolors tipo array, facoltativo

Il colore per disegnare le facce e i bordi dei voxel. Possono essere passati solo come argomenti di parole chiave. Questi parametri possono essere:

  • Un singolo valore di colore, per colorare tutti i voxel dello stesso colore. Può trattarsi di una stringa o di un array 1D rgb/rgba

  • None, l'impostazione predefinita, per utilizzare un unico colore per le facce e lo stile predefinito per i bordi.

  • Un ndarray 3D di nomi di colori, con ogni elemento il colore per il voxel corrispondente. La dimensione deve corrispondere ai voxel.

  • Un ndarray 4D di dati rgb/rgba, con i componenti lungo l'ultimo asse.

ombra bool, predefinito: vero

Se sfumare i facecolors. L' ombreggiatura è sempre disabilitata quando è specificato cmap .

fonte di luceLightSource

La sorgente luminosa da usare quando shade è True.

**kwargs

Ulteriori argomenti di parole chiave da passare a Poly3DCollection.

Resi :
facce dict

Un dizionario indicizzato per coordinate, dove è una delle facce disegnate per il voxel . Se non sono state disegnate facce per un dato voxel, perché non è stato richiesto di disegnarlo o perché è completamente occluso, allora .faces[i, j, k]Poly3DCollectionfilled[i, j, k](i, j, k) not in faces

Esempi

( Codice sorgente , png )

../../_images/voxels.png

( Codice sorgente , png )

../../_images/voxels_rgb.png

( Codice sorgente , png )

../../_images/voxels_torus.png

( Codice sorgente , png )

../../_images/voxels_numpy_logo.png
proprietà w_xaxis [fonte] #
proprietà w_yaxis [fonte] #
proprietà w_zaxis [fonte] #
zaxis_date ( tz = Nessuno ) [fonte] #

Impostare i tick e le etichette dell'asse per trattare i dati lungo l'asse z come date.

Parametri :
tz str o datetime.tzinfo, predefinito: rcParams["timezone"](predefinito: 'UTC')

Il fuso orario utilizzato per creare le etichette della data.

Appunti

Questa funzione è fornita solo per completezza, ma gli assi 3D non supportano le date per i tick, quindi potrebbe non funzionare come previsto.

zaxis_invertito ( ) [fonte] #

Restituisce True se l'asse z è invertito.