La traduzione di questa pagina non è aggiornata. Fai clic qui per vedere l'ultima versione in inglese.

colormap

Visualizzare e impostare la mappa dei colori corrente

Sintassi

colormap map

colormap(map)

colormap(target,map)

cmap = colormap(___)

cmap = colormap

cmap = colormap(target)

Descrizione

Impostazione della mappa dei colori

colormap map imposta la mappa dei colori per la figura corrente sulla mappa dei colori predefinita specificata. Ad esempio, colormap hot imposta la mappa dei colori su hot.

Se si imposta la mappa dei colori per la figura, gli assi e i grafici della figura utilizzeranno la stessa mappa dei colori. La nuova mappa dei colori ha la stessa lunghezza (numero di colori) della mappa dei colori corrente. Quando si utilizza questa sintassi, non è possibile specificare una lunghezza personalizzata per la mappa dei colori. Per maggiori informazioni sulle mappe dei colori, vedere la sezione Ulteriori informazioni.

colormap(map) imposta la mappa dei colori per la figura corrente sulla mappa dei colori specificata da map.

colormap(target,map) imposta la mappa dei colori per la figura, gli assi o la visualizzazione standalone specificata da target, invece che per la figura corrente.

cmap = colormap(___) imposta la mappa dei colori e la restituisce come matrice a tre colonne di triplette RGB. Specificare cmap come argomento di output con una qualsiasi delle sintassi precedenti che utilizzano le parentesi.

Ottenimento della mappa dei colori corrente

cmap = colormap restituisce la mappa dei colori della figura corrente come matrice a tre colonne di triplette RGB.

cmap = colormap(target) restituisce la mappa dei colori per la figura, gli assi o la visualizzazione standalone specificata da target.

Esempi

Modifica della mappa dei colori per la figura

Creare un grafico a superficie e impostare la mappa dei colori su winter.

surf(peaks)
colormap winter

Ripristino della mappa dei colori all'impostazione predefinita

Per prima cosa, cambiare la mappa dei colori della figura corrente in summer.

surf(peaks)
colormap summer

Ora ripristinare la mappa dei colori al valore predefinito di sistema. Se non è stato specificato un valore predefinito diverso, la mappa dei colori predefinita è parula.

colormap default

Utilizzo di mappe dei colori diverse per ciascun asse della figura

A partire dalla release R2019b, è possibile visualizzare la disposizione a piastrelle dei grafici utilizzando le funzioni tiledlayout e nexttile. Chiamare la funzione tiledlayout per creare il layout a piastrelle di un grafico 2x1. Chiamare la funzione nexttile per creare gli oggetti assi ax1 e ax2. Specificare una mappa dei colori diversa per ciascun asse passando l'oggetto assi alla funzione colormap. Negli assi superiori, creare un grafico a superficie utilizzando la mappa dei colori spring. Negli assi inferiori, creare un grafico a superficie utilizzando la mappa dei colori winter.

tiledlayout(2,1)
ax1 = nexttile;
surf(peaks)
colormap(ax1,spring)

ax2 = nexttile; 
surf(peaks)
colormap(ax2,winter)

Specifica del numero dei colori per la mappa dei colori

Specificare il numero di colori utilizzati in una mappa dei colori fornendo un numero intero come argomento di input alla mappa dei colori incorporata. Utilizzare cinque colori della mappa dei colori parula.

mesh(peaks)
colormap(parula(5))

Creazione di mappe dei colori personalizzate

Creare una mappa dei colori personalizzata definendo una matrice a tre colonne di valori compresi tra 0,0 e 1,0. Ciascuna riga definisce una tripletta RGB a tre elementi. La prima colonna specifica le intensità del rosso. La seconda colonna specifica le intensità del verde. La terza colonna specifica le intensità del blu.

Utilizzare una mappa dei colori dei valori del blu impostando le prime due colonne su zero.

map = [0 0 0.3
    0 0 0.4
    0 0 0.5
    0 0 0.6
    0 0 0.8
    0 0 1.0];

surf(peaks)
colormap(map)

Restituzione dei valori della mappa dei colori utilizzati nel grafico

Creare un grafico a superficie della funzione peaks e specificare una mappa dei colori.

mesh(peaks)
colormap(autumn(5))

Restituisce la matrice a tre colonne dei valori che definiscono i colori utilizzati nel grafico. Ciascuna riga è un valore del colore della tripletta RGB che specifica un colore della mappa dei colori.

cmap = colormap

cmap = 5×3

    1.0000         0         0
    1.0000    0.2500         0
    1.0000    0.5000         0
    1.0000    0.7500         0
    1.0000    1.0000         0

Restituzione dei valori della mappa dei colori per assi specifici

Restituire i valori della mappa dei colori per un asse specifico passando l'oggetto assi alla funzione colormap.

Creare una disposizione a piastrelle di due grafici utilizzando le funzioni tiledlayout e nexttile, che sono le nuove funzioni disponibili dalla release R2019b. Chiamare la funzione tiledlayout per creare il layout a piastrelle di un grafico 2x1. Chiamare la funzione nexttile per creare gli oggetti assi ax1 e ax2. Quindi visualizzare due grafici a contorno riempiti con mappe dei colori diverse.

tiledlayout(2,1)
ax1 = nexttile;
contourf(peaks)
colormap(ax1,hot(8))

ax2 = nexttile;
contourf(peaks)
colormap(ax2,pink)

Restituire i valori della mappa dei colori utilizzati nel grafico superiore passando ax1 alla funzione colormap. Ciascuna riga è un valore del colore della tripletta RGB che specifica un colore della mappa dei colori.

cmap = colormap(ax1)

cmap = 8×3

    0.3333         0         0
    0.6667         0         0
    1.0000         0         0
    1.0000    0.3333         0
    1.0000    0.6667         0
    1.0000    1.0000         0
    1.0000    1.0000    0.5000
    1.0000    1.0000    1.0000

Modifica della mappa dei colori per figure con immagine

Caricare l'insieme di dati spine che restituisce l'immagine X e la relativa mappa dei colori associata map. Visualizzare X utilizzando la funzione image e impostare la mappa dei colori su map.

load spine
image(X)
colormap(map)

Argomenti di input

map — Mappa dei colori per nuovo schema di colori

nome della mappa dei colori | matrice a tre colonne di triplette RGB | 'default'

Mappa dei colori per nuovo schema di colori, specificata come nome della mappa dei colori, matrice a tre colonne di triplette RGB o 'default'. Un nome della mappa dei colori specifica una mappa dei colori predefinita con lo stesso numero di colori della mappa dei colori corrente. Una matrice a tre colonne di triplette RGB specifica una mappa dei colori personalizzata. È possibile creare la matrice autonomamente oppure richiamare una delle funzioni predefinite della mappa dei colori per creare la matrice. Ad esempio, colormap(parula(10)) imposta la mappa dei colori della figura corrente su una selezione di 10 colori dalla mappa dei colori parula.

Un valore di 'default' imposta la mappa dei colori sulla mappa dei colori predefinita per l'oggetto di destinazione.

Nome della mappa dei colori

La tabella seguente elenca le mappe dei colori predefinite.

Nome della mappa dei colori	Scala dei colori
parula
turbo
hsv
hot
cool
spring
summer
autumn
winter
gray
bone
copper
pink
sky (da R2023a)
abyss (da R2023b)
jet
lines
colorcube
prism
flag
white

Matrice a tre colonne

Per creare una mappa dei colori personalizzata, specificare map come una matrice a tre colonne di triplette RGB, dove ciascuna riga definisce un colore. Una tripletta RGB è un vettore riga a tre elementi i cui elementi specificano le intensità dei componenti rosso, verde e blu del colore. Le intensità possono essere valori double o single compresi nell'intervallo [0, 1] oppure valori uint8 compresi nell'intervallo [0, 255]. Ad esempio, questa matrice definisce una mappa dei colori contenente cinque colori.

map = [0.2 0.1 0.5
    0.1 0.5 0.8
    0.2 0.7 0.6
    0.8 0.7 0.3
    0.9 1 0];

Questa tabella elenca i valori della tripletta RGB per i colori più comuni.

Colore	Tripletta RGB double o single	Tripletta RGB uint8
giallo	[1 1 0]	[255 255 0]
magenta	[1 0 1]	[255 0 255]
ciano	[0 1 1]	[0 255 255]
rosso	[1 0 0]	[255 0 0]
verde	[0 1 0]	[0 255 0]
blu	[0 0 1]	[0 0 255]
bianco	[1 1 1]	[255 255 255]
nero	[0 0 0]	[0 0 0]

Tipi di dati: char | double | single | uint8

target — Destinazione

Oggetto Figure | Oggetto Axes | Oggetto PolarAxes | Oggetto GeographicAxes | visualizzazione indipendente

Destinazione, specificata come uno dei seguenti valori:

• Oggetto Figure. La mappa dei colori della figura influisce sui grafici di tutti gli assi all'interno della figura.

• Oggetto Axes, oggetto PolarAxes o oggetto GeographicAxes. È possibile definire una mappa dei colori unica per i diversi assi all'interno di una figura.

• Visualizzazione standalone con proprietà Colormap. Ad esempio, è possibile modificare o interrogare la mappa dei colori di un oggetto HeatmapChart.

Argomenti di output

cmap — Valori della mappa dei colori

matrice a tre colonne di triplette RGB

Valori della mappa dei colori, restituiti come matrice a tre colonne di triplette RGB. Ciascuna riga della matrice definisce una tripletta RGB che specifica un colore della mappa dei colori. I valori sono compresi nell'intervallo [0, 1].

Ulteriori informazioni

Mappa dei colori

Una mappa dei colori è una matrice di valori che definisce i colori degli oggetti grafici, come superfici, immagini e oggetti patch. MATLAB^® disegna gli oggetti mappando i valori dei dati ai colori della mappa dei colori.

Le mappe dei colori possono essere di qualsiasi lunghezza, ma devono essere larghe tre colonne. Ciascuna riga della matrice definisce un colore utilizzando una tripletta RGB. Una tripletta RGB è un vettore riga a tre elementi i cui elementi specificano le intensità dei componenti rosso, verde e blu del colore. In genere, le intensità sono valori double o single compresi nell'intervallo [0, 1]. Un valore pari a 0 indica l'assenza di colore, mentre un valore pari a 1 indica la piena intensità. Ad esempio, questo comando crea una mappa dei colori con cinque colori: nero, rosso, verde, blu e bianco.

mymap = [0 0 0
    1 0 0
    0 1 0
    0 0 1
    1 1 1];

Per modificare lo schema di colori di una visualizzazione, richiamare la funzione colormap per modificare la mappa dei colori degli assi o della figura che li contiene. Ad esempio, questi comandi creano un grafico a superficie e impostano la mappa dei colori della figura su mymap.

surf(peaks)
colormap(mymap)

Suggerimenti

• Per controllare i limiti della mappa dei colori e il modo in cui tali limiti si riferiscono all'intervallo dei dati, utilizzare la funzione clim.

  Prima di R2022a: Utilizzare caxis, che ha la stessa sintassi e gli stessi argomenti di clim.

Cronologia versioni

Introduzione prima di R2006a

R2023a: Restituzione della matrice della mappa dei colori quando si imposta la mappa dei colori predefinita

È possibile specificare facoltativamente un argomento di output per memorizzare l'array della mappa dei colori quando si imposta la mappa dei colori della figura corrente sul valore predefinito. Ad esempio:

cmap = colormap("default")

R2020b: Opzione della mappa dei colori 'default' per visualizzare la heat map nella mappa dei colori blu anziché nella mappa dei colori parula

Impostando la mappa dei colori di un grafico heat map su 'default', la mappa dei colori del grafico viene impostata sulla mappa dei colori blu predefinita per i grafici heat map. Nella release R2020a e precedenti, l'opzione 'default' cambia la mappa dei colori in parula.

Per specificare la mappa dei colori predefinita per un grafico heat map, passare il grafico alla funzione colormap.

h = heatmap(rand(10));
colormap(h,'default')

Questa modifica interesserà solo i grafici heat map.

R2018a: Impostazione della mappa dei colori della figura impostando anche la mappa dei colori degli assi

A partire dalla release R2018a, se si imposta la mappa dei colori per una figura, gli assi e i grafici della figura utilizzano la stessa mappa dei colori. In precedenza, se si impostava esplicitamente la mappa dei colori per gli assi o i grafici, non subivano variazioni quando si impostava la mappa dei colori per la figura. Se si desidera che un oggetto Axes utilizzi una mappa dei colori diversa da quella della figura, impostare la mappa dei colori per gli assi dopo aver impostato quella per la figura.

R2014b: Modifica apportata alla mappa dei colori predefinita

• A partire dalla release R2014b, la mappa dei colori predefinita è parula. Nelle release precedenti, la mappa dei colori predefinita era jet.

Vedi anche

Funzioni

• colorbar | ind2rgb | hsv2rgb | rgbplot

Strumenti

• Editor della mappa dei colori

Argomenti

• Control Colormap Limits