`matplotlib.cm`#

Mappe dei colori integrate, utilità per la gestione delle mappe dei colori e ScalarMappablemixin.

Guarda anche

Riferimento mappa colori per un elenco di mappe colori incorporate.

Creazione di mappe di colori in Matplotlib per esempi su come creare mappe di colori.

Scegliere le mappe dei colori in Matplotlib una discussione approfondita sulla scelta delle mappe dei colori.

Colormap Normalization per maggiori dettagli sulla normalizzazione dei dati.

classe matplotlib.cm. ColormapRegistry ( cmaps ) [fonte] #

Basi:Mapping

Contenitore per mappe di colori note a Matplotlib per nome.

Sperimentale

Mentre prevediamo che l'API sia definitiva, la contrassegniamo formalmente come sperimentale per 3.5 perché vogliamo mantenere l'opzione per adattare ancora l'API per 3.6 in caso di necessità.

L'istanza del registro universale è matplotlib.colormaps. Non dovrebbe essere necessario che gli utenti istanzino ColormapRegistryse stessi.

L'accesso in lettura utilizza un'interfaccia simile a un dict che mappa i nomi in Colormaps:

import matplotlib as mpl
cmap = mpl.colormaps['viridis']

I messaggi restituiti Colormapsono copie, in modo che la loro modifica non cambi la definizione globale della mappa dei colori.

Ulteriori colormap possono essere aggiunte tramite ColormapRegistry.register:

mpl.colormaps.register(my_colormap)

register ( cmap , * , name = None , force = False ) [fonte] #

Registra una nuova mappa dei colori.

Il nome della mappa colori può quindi essere utilizzato come argomento stringa per qualsiasi cmap parametro in Matplotlib. È disponibile anche in formato pyplot.get_cmap.

Il registro della mappa dei colori memorizza una copia della mappa dei colori data, in modo che le future modifiche all'istanza della mappa dei colori originale non influenzino la mappa dei colori registrata. Pensa a questo come al registro che scatta un'istantanea della mappa dei colori al momento della registrazione.

Parametri :

cmap matplotlib.colors.Colormap: La mappa dei colori da registrare.
nome str, facoltativo: Il nome della mappa colori. Se non dato, cmap.nameviene utilizzato.
forza bool, predefinito: falso: Se False, viene generato un ValueError se si tenta di sovrascrivere un nome già registrato. True supporta la sovrascrittura delle mappe dei colori registrate diverse dalle mappe dei colori integrate.

annullare la registrazione ( nome ) [fonte] #

Rimuove una mappa di colori dal registro.

Non è possibile rimuovere le mappe dei colori integrate.

Se la mappa di colori denominata non è registrata, restituisce senza errori, solleva se si tenta di annullare la registrazione di una mappa di colori predefinita.

Avvertimento

I nomi delle mappe dei colori sono attualmente uno spazio dei nomi condiviso che può essere utilizzato da più pacchetti. Utilizzare unregistersolo se si sa di aver già registrato quel nome. In particolare, non annullare la registrazione nel caso in cui si pulisca il nome prima di registrare una nuova mappa di colori.

Parametri :

nome str: Il nome della mappa colori da rimuovere.

Rialzi :

ValoreErrore: Se provi a rimuovere un file colormap predefinito predefinito.

classe matplotlib.cm. ScalarMappable ( norm = None , cmap = None ) [fonte] #

Basi:object

Una classe mixin per mappare i dati scalari in RGBA.

ScalarMappable applica la normalizzazione dei dati prima di restituire i colori RGBA dalla mappa di colori specificata.

Parametri :

norm Normalize(o sua sottoclasse) o str o None: L'oggetto di normalizzazione che ridimensiona i dati, in genere nell'intervallo . Se a , una sottoclasse viene generata dinamicamente in base alla scala con il nome corrispondente. Se None , norm assume per impostazione predefinita un oggetto colors.Normalize che inizializza il suo ridimensionamento in base ai primi dati elaborati.[0, 1]strNormalize
cmap str oColormap: La mappa dei colori utilizzata per mappare i valori dei dati normalizzati ai colori RGBA.

scalabilità automatica ( ) [fonte] #: Ridimensiona automaticamente i limiti scalari nell'istanza di norma usando l'array corrente

autoscale_None ( ) [fonte] #: Ridimensiona automaticamente i limiti scalari nell'istanza di norma usando l'array corrente, modificando solo i limiti None

proprietà callbacksSM [fonte] #

modificato ( ) [fonte] #: Chiamalo ogni volta che il mappabile viene modificato per notificare a tutti gli ascoltatori di callbackSM il segnale "modificato".

barra dei colori #: L'ultima barra dei colori associata a questo ScalarMappable. Potrebbe essere Nessuno.

get_alpha ( ) [fonte] #

Resi :

galleggiante: Restituisce sempre 1.

get_array ( ) [fonte] #

Restituisce l'array di valori mappati ai colori.

La classe base ScalarMappablenon fa alcuna ipotesi sulla dimensionalità e sulla forma dell'array.

get_clim ( ) [fonte] #: Restituisce i valori (min, max) mappati ai limiti della mappa colori.

get_cmap ( ) [fonte] #: Restituisci l' Colormapistanza.

norma di proprietà #

set_array ( A ) [fonte] #

Imposta l'array di valori da A .

Parametri :

Un tipo di matrice o None

I valori mappati ai colori.

La classe base ScalarMappablenon fa alcuna ipotesi sulla dimensionalità e sulla forma dell'array di valori A .

set_clim ( vmin = Nessuno , vmax = Nessuno ) [fonte] #

Imposta i limiti della norma per il ridimensionamento dell'immagine.

Parametri :

vmin, vmax float

I limiti.

I limiti possono anche essere passati come una tupla ( vmin , vmax ) come singolo argomento posizionale.

set_cmap ( cmap ) [fonte] #

Imposta la mappa dei colori per i dati di luminanza.

Parametri :

cmap Colormapo str o Nessuno

set_norm ( norma ) [fonte] #

Impostare l'istanza di normalizzazione.

Parametri :

norm Normalizeo str o None

Appunti

Se sono presenti barre dei colori che utilizzano il mappabile per questa norma, l'impostazione della norma del mappabile ripristinerà la norma, il localizzatore e i formattatori sulla barra dei colori ai valori predefiniti.

to_rgba ( x , alpha = None , bytes = False , norm = True ) [fonte] #

Restituisce un array rgba normalizzato corrispondente a x .

Nel caso normale, x è una sequenza 1D o 2D di scalari e verrà restituito il corrispondente ndarray di valori rgba, in base alla norma e alla mappa dei colori impostati per questo ScalarMappable.

C'è un caso speciale, per la gestione di immagini che sono già rgb o rgba, come quelle che potrebbero essere state lette da un file immagine. Se x è un ndarray con 3 dimensioni e l'ultima dimensione è 3 o 4, verrà trattato come un array rgb o rgba e non verrà eseguita alcuna mappatura. L'array può essere uint8 o può essere in virgola mobile con valori nell'intervallo 0-1; in caso contrario verrà sollevato un ValueError. Se si tratta di un array mascherato, la maschera verrà ignorata. Se l'ultima dimensione è 3, alpha kwarg (predefinito a 1) verrà utilizzato per riempire la trasparenza. Se l'ultima dimensione è 4, l' alpha kwarg viene ignorato; non sostituisce l'alfa preesistente. Verrà sollevato un ValueError se la terza dimensione è diversa da 3 o 4.

In entrambi i casi, se bytes è False (predefinito), l'array rgba sarà float nell'intervallo 0-1; se è True , l'array rgba restituito sarà uint8 nell'intervallo da 0 a 255.

Se norm è False, non viene eseguita alcuna normalizzazione dei dati di input e si presume che sia compreso nell'intervallo (0-1).

matplotlib.cm. get_cmap ( nome = Nessuno , lut = Nessuno ) [fonte] #

[ Deprecato ] Ottieni un'istanza della mappa di colori, impostando per impostazione predefinita i valori rc se il nome è None.

Parametri :

name matplotlib.colors.Colormapo str o Nessuno, predefinito: Nessuno: Se Colormapun'istanza, verrà restituita. In caso contrario, il nome di una mappa di colori nota a Matplotlib, che verrà ricampionata da lut . Il valore predefinito, Nessuno, significa rcParams["image.cmap"](predefinito: 'viridis').
lut int o Nessuno, predefinito: Nessuno: Se name non è già un'istanza Colormap e lut non è None, la colormap verrà ricampionata per avere voci lut nella tabella di ricerca.

Resi :

Mappa dei colori

Appunti

Deprecato dalla versione 3.6: utilizzare matplotlib.colormaps[name]invece.

matplotlib.cm. register_cmap ( name = None , cmap = None , * , override_builtin = False ) [fonte] #

[ Deprecato ] Aggiunge una mappa di colori al set riconosciuto da get_cmap().

Registra una nuova mappa colori a cui accedere per nome

LinearSegmentedColormap('swirly', data, lut)
register_cmap(cmap=swirly_cmap)

Parametri :

nome str, facoltativo

Il nome che può essere utilizzato in get_cmap()o rcParams["image.cmap"](predefinito: 'viridis')

Se assente, il nome sarà l' name attributo del cmap .

cmap matplotlib.colors.Colormap

Nonostante sia il secondo argomento e abbia un valore predefinito, questo è un argomento obbligatorio.

override_builtin bool

Consenti alle mappe di colori incorporate di essere sovrascritte da una mappa di colori fornita dall'utente.

Si prega di non utilizzarlo a meno che non si sia sicuri di averne bisogno.

Appunti

Deprecato dalla versione 3.6: utilizzare matplotlib.colormaps.register(name)invece.

matplotlib.cm. unregister_cmap ( nome ) [fonte] #

[ Deprecato ] Rimuove una mappa di colori riconosciuta da get_cmap().

Non puoi rimuovere le mappe dei colori integrate.

Se la mappa di colori denominata non è registrata, restituisce senza errori, solleva se si tenta di annullare la registrazione di una mappa di colori predefinita.

Avvertimento

I nomi delle mappe dei colori sono attualmente uno spazio dei nomi condiviso che può essere utilizzato da più pacchetti. Utilizzare unregister_cmapsolo se si sa di aver già registrato quel nome. In particolare, non annullare la registrazione nel caso in cui si pulisca il nome prima di registrare una nuova mappa di colori.

Parametri :

nome str: Il nome della mappa colori di cui annullare la registrazione

Resi :

Mappa colori o Nessuno: Se la mappa dei colori è stata registrata, restituirla in caso contrarioNone

Rialzi :

ValoreErrore: Se si tenta di annullare la registrazione di un file predefinito colormap.

Appunti

Deprecato dalla versione 3.6: utilizzare matplotlib.colormaps.unregister(name)invece.

matplotlib.cm#

`matplotlib.cm`#