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
Artist
s 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
{'box', 'datalim'}
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
scalare o Nessuno
(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bool
{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
bool
sconosciuto
sconosciuto
sconosciuto
Callable[[Assi, Renderer], Bbox]
bool o 'linea'
3 tuple di float o Nessuno
bool
Patch o (Percorso, Trasforma) o Nessuno
facecolor
o fccolore
bool
str
bool
oggetto
bool
bool
sconosciuto
Nessuno o bool o float o richiamabile
[sinistra, fondo, larghezza, altezza] o
Bbox
{'persp', 'orto'}
sconosciuto
float o Nessuno
bool
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
sconosciuto
str
bool
sconosciuto
str
xlim
o xlim3d(in basso: galleggiante, in alto: galleggiante)
(in basso: galleggiante, in alto: galleggiante)
float maggiore di -0,5
sconosciuto
sconosciuto
sconosciuto
sconosciuto
str
ylim
o ylim3d(in basso: galleggiante, in alto: galleggiante)
(in basso: galleggiante, in alto: galleggiante)
float maggiore di -0,5
sconosciuto
sconosciuto
sconosciuto
sconosciuto
sconosciuto
zlim
o zlim3dsconosciuto
float maggiore di -0,5
galleggiante
sconosciuto
sconosciuto
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
- apply_aspect ( posizione = Nessuno ) [fonte] #
Regola gli assi per un rapporto di aspetto dei dati specificato.
A seconda di
get_adjustable
ciò verrà modificata la casella Assi (posizione) oi limiti della vista. Nel primo caso,get_anchor
influenzerà la posizione.- Parametri :
- posizione Nessuno o .Bbox
In caso contrario
None
, definisce la posizione degli assi all'interno della figura come una Bbox. Vedereget_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.
- autoscale ( enable = True , axis = 'both' , tight = None ) [fonte] #
Metodo pratico per il ridimensionamento automatico della vista dell'asse semplice.
Vedere
Axes.autoscale
per 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_view
per 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 comedata[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:
-Z (parte inferiore della scatola)
+Z (parte superiore del riquadro)
-Y
+Y
-X
+X
- zsort str, facoltativo
Lo schema di ordinamento dell'asse z è stato trasferito
Poly3DCollection
- ombra bool, predefinito: vero
Quando vero, questo ombreggia i lati oscuri delle barre (rispetto alla fonte di luce della trama).
- fonte di luce
LightSource
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 comedata[s]
(a meno che ciò non sollevi un'eccezione).- **kwargs
Eventuali argomenti di parole chiave aggiuntivi vengono passati a
Poly3DCollection
.
- Resi :
- collezione
Poly3DCollection
Una raccolta di poligoni tridimensionali che rappresentano le barre.
- collezione
- 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 .
- 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.contour
per 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 comedata[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.contour
per 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 comedata[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.contourf
per 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 comedata[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.contourf
per 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 comedata[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
- 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
- sottoclasse del renderer .
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
plot
per 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_xlim
oset_ylim
deve essere chiamato prima dierrorbar
. 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
Line3DCollection
istanze ciascuna contenente una riga barra di errore.- elenco capitelli
Elenco di
Line3D
istanze ciascuna contenente un oggetto capline.- elenco dei limiti
Elenco di
Line3D
istanze 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 comedata[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 )
- 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_zdata
attributo se è richiamabile, altrimenti ricorrerà al formattatore zaxis major
- 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 renderer
RendererBase
renderer che verrà utilizzato per disegnare le figure (es
fig.canvas.get_renderer()
)- bbox_extra_artists elenco di
Artist
oNone
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_locator
attributo, che è necessario per ottenere il riquadro di delimitazione corretto.call_axes_locator=False
può 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.
- sottoclasse del renderer
- Resi :
BboxBase
Riquadro di delimitazione nelle coordinate dei pixel della figura.
- 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_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_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
Line2D
s.
- 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_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 di
Text
- lista di
- get_zticklines ( minor = False ) [fonte] #
Restituisce le linee di spunta dello zaxis come un elenco di
Line2D
s.
- 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.
- margins ( * margins , x = Nessuno , y = Nessuno , z = Nessuno , tight = True ) [fonte] #
Imposta o recupera i margini di ridimensionamento automatico.
Vedere
Axes.margins
per 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 = 10
rcount = 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 luce
LightSource
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
Triangulation
oggetto, 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
Triangulation
per 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 luce
LightSource
La sorgente luminosa da usare quando shade è True.
- **kwargs
Tutti gli altri argomenti vengono passati a
Poly3DCollection
Esempi
( Codice sorgente , png )
( Codice sorgente , 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 = 1
rcount = 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 comedata[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 comedata[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 c
scatter
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 comedata[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 :
- percorsi
PathCollection
- percorsi
- 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 c
scatter
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 comedata[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 :
- percorsi
PathCollection
- percorsi
- 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
{'box', 'datalim'}
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
scalare o Nessuno
(float, float) o {'C', 'SW', 'S', 'SE', 'E', 'NE', ...}
bool
{'auto', 'equal', 'equalxy', 'equalxz', 'equalyz'}
bool
sconosciuto
sconosciuto
sconosciuto
Callable[[Assi, Renderer], Bbox]
bool o 'linea'
3 tuple di float o Nessuno
bool
Patch o (Percorso, Trasforma) o Nessuno
facecolor
o fccolore
bool
str
bool
oggetto
bool
bool
sconosciuto
Nessuno o bool o float o richiamabile
[sinistra, fondo, larghezza, altezza] o
Bbox
{'persp', 'orto'}
sconosciuto
float o Nessuno
bool
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
sconosciuto
str
bool
sconosciuto
str
(in basso: galleggiante, in alto: galleggiante)
(in basso: galleggiante, in alto: galleggiante)
float maggiore di -0,5
sconosciuto
sconosciuto
sconosciuto
sconosciuto
str
(in basso: galleggiante, in alto: galleggiante)
(in basso: galleggiante, in alto: galleggiante)
float maggiore di -0,5
sconosciuto
sconosciuto
sconosciuto
sconosciuto
sconosciuto
sconosciuto
sconosciuto
float maggiore di -0,5
galleggiante
sconosciuto
sconosciuto
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_adjustable
per 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_anchor
per ulteriori dettagli.- condividi bool, predefinito: Falso
Se
True
, applica le impostazioni a tutti gli assi condivisi.
Guarda anche
- 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 :
- 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
y
rappresenti 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_ylabel
la descrizione.
- set_zlim ( bottom = Nessuno , top = Nessuno , * , emit = True , auto = False , zmin = Nessuno , zmax = Nessuno ) [fonte] #
Imposta i limiti z 3D.
Vedere
Axes.set_ylim
per 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 di
Text
Le etichette.
- lista di
- Altri parametri :
- **
Text
proprietà 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 unFixedLocator
.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_formatter
o 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; ifTrue
, i tick minori.- **kwargs
Text
proprietà per le etichette. Questi hanno effetto solo se passi le etichette . Negli altri casi, utilizzaretick_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.
Condividi l'asse z con altri .
Ciò equivale a passare
sharex=other
durante 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 comedata[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 )
( png )
( 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 comedata[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 )
( png )
( 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 :
- Altri parametri :
- **
Text
proprietà kwargs. Altri parametri di testo vari.
Proprietà
Descrizione
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
scalare o Nessuno
bool
colore
dict con proprietà per
patches.FancyBboxPatch
sconosciuto
sconosciuto
sconosciuto
color
o ccolore
fontfamily
o famiglia{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties
o font o font_propertiesfontsize
o dimensionefloat o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch
o allungare{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyle
o stile{'normale', 'corsivo', 'obliquo'}
fontvariant
o variante{'normale', 'maiuscoletto'}
fontweight
o peso{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
str
{'sinistra', 'centro', 'destra'}
bool
oggetto
float (multiplo della dimensione del carattere)
str
bool
multialignment
o mamma{'sinistra', 'destra', 'centro'}
bool
Nessuno o bool o float o richiamabile
(galleggiare, galleggiare)
bool
float o {'verticale', 'orizzontale'}
{Nessuno, 'predefinito', 'ancora'}
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
oggetto
bool
str
bool o Nessuno
{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
bool
bool
galleggiante
galleggiante
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_params
per 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.tricontour
per 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 comedata[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.tricontourf
per 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 comedata[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
- update_datalim ( xys , ** kwargs ) [fonte] #
Estendi la
dataLim
Bbox 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 luce
LightSource
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]
Poly3DCollection
filled[i, j, k]
(i, j, k) not in faces
Esempi
( Codice sorgente , png )
( Codice sorgente , png )
( Codice sorgente , png )
( Codice sorgente , png )
- 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.
- tz str o
Appunti
Questa funzione è fornita solo per completezza, ma gli assi 3D non supportano le date per i tick, quindi potrebbe non funzionare come previsto.