matplotlib.pyplot.colorbar #
- matplotlib.pyplot. colorbar ( mappabile = Nessuno , cax = Nessuno , ax = Nessuno , ** kwargs ) [fonte] #
Aggiungi una barra dei colori a un grafico.
- Parametri :
- mappabile
Il
matplotlib.cm.ScalarMappable(cioè,AxesImage,ContourSet, ecc.) descritto da questa barra dei colori. Questo argomento è obbligatorio per ilFigure.colorbarmetodo ma facoltativo per lapyplot.colorbarfunzione, che imposta l'impostazione predefinita sull'immagine corrente.Si noti che è possibile creare
ScalarMappable"al volo" per generare barre colore non associate a un artista disegnato in precedenza, ad es.fig.colorbar(cm.ScalarMappable(norm=norm, cmap=cmap), ax=ax)
- cax
Axes, facoltativo Assi in cui verrà disegnata la barra dei colori.
- ax
Axes, elenco di assi, facoltativo Uno o più assi padre da cui verrà rubato lo spazio per un nuovo asse della barra dei colori, se cax è None. Questo non ha effetto se è impostato cax .
- use_gridspec bool, facoltativo
Se cax è
None, viene creata una nuova cax come istanza di Axes. Se ax è un'istanza di Subplot e use_gridspec èTrue, cax viene creato come istanza di Subplot utilizzando ilgridspecmodulo.
- Resi :
- barra dei colori
Colorbar
- barra dei colori
- Altri parametri :
- Posizione nessuna o {'Left', 'Right', 'Top', 'Bottom'}
La posizione, relativa agli assi dei genitori, in cui vengono creati gli assi colorbar. Determina inoltre l' orientamento del colorbar (i colorbar a sinistra e a destra sono verticali, i colorbar nella parte superiore e inferiore sono orizzontali). Se nessuno, la posizione verrà dall'orientamento se è impostata (colorbar verticali a destra, orizzontali nella parte inferiore) o predefinito a "a destra" se l' orientamento non è inserito.
- Orientamento nessuno o {'verticale', 'orizzontale'}
L'orientamento del colorbar. È preferibile impostare la posizione del colorbar, poiché ciò determina anche l' orientamento ; il passaggio di valori incompatibili per la posizione e l' orientamento solleva un'eccezione.
- frazione float, default: 0.15
Frazione di assi originali da utilizzare per colorbar.
- restringi float, predefinito: 1.0
Frazione con la quale moltiplicare le dimensioni del colorbar.
- aspetto float, predefinito: 20
Rapporto tra dimensioni lunghe e brevi.
- Pad Float, impostazione predefinita: 0,05 se verticale, 0,15 se orizzontale
Frazione di assi originali tra colorbar e nuovi assi dell'immagine.
- Ancora (galleggiante, galleggiante), opzionale
Il punto di ancoraggio degli assi della barra dei colori. Il valore predefinito è (0.0, 0.5) se verticale; (0.5, 1.0) se orizzontale.
- panchor (float, float) o False , facoltativo
Il punto di ancoraggio degli assi padre della barra dei colori. Se falso , l'ancora degli assi dei genitori sarà invariato. Il valore predefinito è (1.0, 0.5) se verticale; (0.5, 0.0) se orizzontale.
- estendere {'neither', 'entrambi', 'min', 'max'}
Effettuare la fine appuntita per i valori fuori portata (a meno che "nessuno dei due"). Questi sono impostati per un determinato Colormap usando i metodi CoLormap Set_under e Set_over.
- extendfrac { Nessuno , 'auto', lunghezza, lunghezze}
Se impostato su None , entrambe le estensioni della barra dei colori triangolare minima e massima avranno una lunghezza pari al 5% della lunghezza della barra dei colori interna (questa è l'impostazione predefinita).
Se impostato su 'auto', rende le estensioni della barra dei colori triangolari della stessa lunghezza dei riquadri interni (quando la spaziatura è impostata su 'uniforme') o della stessa lunghezza dei rispettivi riquadri interni adiacenti (quando la spaziatura è impostata su 'proporzionale').
Se uno scalare, indica la lunghezza delle estensioni del colorbar triangolare minima e massima come una frazione della lunghezza del colorbar interno. Si può anche fornire una sequenza di frazioni a due elementi, che indicano rispettivamente le lunghezze delle estensioni minima e massima della barra dei colori come frazione della lunghezza della barra dei colori interna.
- extendrect bool
Se False le estensioni minima e massima della barra dei colori saranno triangolari (impostazione predefinita). Se True le estensioni saranno rettangolari.
- spaziatura {'uniforme', 'proporzionale'}
Per barre di colore discrete (
BoundaryNormo contorni), 'uniforme' assegna a ciascun colore lo stesso spazio; 'proportional' rende lo spazio proporzionale all'intervallo di dati.- ticks Nessuno o lista di ticks o Locator
Se None, i tick vengono determinati automaticamente dall'input.
- format None o str o Formatter
Se Nessuno,
ScalarFormatterviene utilizzato. Le stringhe di formato, ad esempio,"%4.2e"o"{x:.2e}", sono supportate.FormatterAl suo posto può essere data un'alternativa .- bordi chiusi bool
Se disegnare linee ai limiti di colore.
- etichetta str
L'etichetta sull'asse lungo della barra dei colori.
- confini, valori Nessuno o una sequenza
Se non impostato, la mappa dei colori verrà visualizzata su una scala 0-1. Se le sequenze, i valori devono avere una lunghezza 1 inferiore ai limiti . Per ogni regione delimitata da voci adiacenti in boundary , verrà utilizzato il colore mappato al valore corrispondente in values. Normalmente utile solo per i colori indicizzati (es.
norm=NoNorm()) o altre circostanze insolite.
Appunti
Se mappabile è un
ContourSet, la sua estensione kwarg viene inclusa automaticamente.Lo shrink kwarg fornisce un modo semplice per ridimensionare la barra dei colori rispetto agli assi. Si noti che se viene specificato cax , determina la dimensione della barra dei colori e i kwargs di restringimento e aspetto vengono ignorati.
Per un controllo più preciso, è possibile specificare manualmente le posizioni degli oggetti degli assi in cui vengono disegnati il mappabile e la barra dei colori. In questo caso, non utilizzare nessuna delle proprietà degli assi kwargs.
È noto che alcuni visualizzatori di grafica vettoriale (svg e pdf) visualizzano gli spazi bianchi tra i segmenti della barra dei colori. Ciò è dovuto a bug nei visualizzatori, non a Matplotlib. Per ovviare a questo problema, la barra dei colori può essere renderizzata con segmenti sovrapposti:
cbar = colorbar() cbar.solids.set_edgecolor("face") draw()
Tuttavia ciò ha conseguenze negative in altre circostanze, ad esempio con immagini semitrasparenti (alfa < 1) ed estensioni della barra dei colori; pertanto, questa soluzione alternativa non viene utilizzata per impostazione predefinita (vedere il problema n. 1188).
