La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

colormap

Ver y establecer el mapa de colores actual

Sintaxis

colormap map

colormap(map)

colormap(target,map)

cmap = colormap(___)

cmap = colormap

cmap = colormap(target)

Descripción

Establecer el mapa de colores

colormap map establece el mapa de colores para la figura actual en el mapa de colores predefinido especificado. Por ejemplo, colormap hot establece el mapa de colores en hot.

Si establece el mapa de colores para la figura, los ejes y las gráficas de la figura usan el mismo mapa de colores. El nuevo mapa de colores tiene la misma longitud (número de colores) que el mapa de colores actual. Cuando use esta sintaxis, no puede especificar una longitud personalizada para el mapa de colores. Para obtener más información sobre los mapas de colores, consulte la sección Más acerca de.

colormap(map) establece el mapa de colores especificado por map como mapa de colores para la figura actual.

colormap(target,map) establece el mapa de colores para la figura, los ejes o la visualización independiente especificados por target, en lugar de para la figura actual.

cmap = colormap(___) establece el mapa de colores y lo devuelve como una matriz de tres columnas de tripletes RGB. Especifique cmap como argumento de salida con cualquiera de las sintaxis anteriores que utilizan paréntesis.

Obtener el mapa de colores actual

cmap = colormap devuelve el mapa de colores para la figura actual como matriz de tres columnas de tripletes RGB.

cmap = colormap(target) devuelve el mapa de colores para la figura, los ejes o la visualización independiente especificados por target.

Ejemplos

Cambiar el mapa de colores para la figura

Cree una gráfica de superficie y establezca el mapa de colores en winter.

surf(peaks)
colormap winter

Volver al mapa de colores predeterminado

Primero, cambie el mapa de colores para la figura actual a summer.

surf(peaks)
colormap summer

Ahora establezca el mapa de colores de nuevo al valor predeterminado de su sistema. Si no ha especificado un valor predeterminado diferente, el mapa de colores predeterminado es parula.

colormap default

Utilizar diferentes mapas de colores para cada eje de la figura

A partir de la versión R2019b, puede mostrar un mosaico de gráficas utilizando las funciones tiledlayout y nexttile. Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 2 por 1. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Especifique un mapa de colores diferente para cada eje pasando los objetos de eje a la función colormap. En los ejes superiores, cree una gráfica de superficie utilizando el mapa de colores spring. En los ejes inferiores, cree una gráfica de superficie utilizando el mapa de colores winter.

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

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

Especificar el número de colores para el mapa de colores

Especifique el número de colores utilizado en un mapa de colores pasando un entero como argumento de entrada al mapa de colores integrado. Utilice cinco colores del mapa de colores parula.

mesh(peaks)
colormap(parula(5))

Crear mapa de colores personalizado

Cree un mapa de colores personalizado definiendo una matriz de tres columnas de valores entre 0,0 y 1,0. Cada fila define un triplete RGB de tres elementos. La primera columna especifica las intensidades rojas. La segunda columna especifica las intensidades verdes. La tercera columna especifica las intensidades azules.

Utilice un mapa de colores de valores azules estableciendo las primeras dos columnas con ceros.

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)

Devolver los valores del mapa de colores utilizado en la gráfica

Cree una gráfica de superficie de la función peaks y especifique un mapa de colores.

mesh(peaks)
colormap(autumn(5))

Devuelva la matriz de tres columnas de valores que define los colores utilizados en la gráfica. Cada fila es un valor de colores de triplete RGB que especifica un color del mapa de colores.

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

Devolver los valores del mapa de colores para ejes específicos

Devuelva los valores del mapa de colores para un eje específico pasando el objeto de ejes a la función colormap.

Cree un mosaico de dos gráficas utilizando las funciones tiledlayout y nexttile, que son funciones nuevas a partir de la versión R2019b. Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 2 por 1. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Luego muestre dos diagramas de contorno relleno con diferentes mapas de colores.

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

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

Devuelva los valores del mapa de colores utilizados en la gráfica superior pasando ax1 a la función colormap. Cada fila es un valor de colores de triplete RGB que especifica un color del mapa de colores.

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

Cambiar el mapa de colores para una figura con imagen

Cargue el conjunto de datos spine que devuelve la imagen X y su mapa de colores map asociado. Muestre X utilizando la función image y establezca el mapa de colores en map.

load spine
image(X)
colormap(map)

Argumentos de entrada

map — Mapa de colores para un nuevo esquema de colores

nombre del mapa de colores | matriz de tres columnas de tripletes RGB | 'default'

Mapa de colores para el nuevo esquema de colores, especificado como un nombre del mapa de colores, una matriz de tres columnas de tripletes RGB o 'default'. Un nombre del mapa de colores especifica un mapa de colores predefinido con el mismo número de colores que el mapa de colores actual. Una matriz de tres columnas de tripletes RGB especifica un mapa de colores personalizado. Puede crear la matriz usted mismo o puede llamar a una de las funciones de mapa de colores predeterminado para crear la matriz. Por ejemplo, colormap(parula(10)) establece el mapa de colores de la figura actual como una selección de 10 colores del mapa de colores parula.

Un valor de 'default' establece el mapa de colores predeterminado como el mapa de colores para el objeto objetivo.

Nombre del mapa de colores

En la siguiente tabla se enumeran los mapas de colores predefinidos.

Nombre del mapa de colores	Escala de colores
parula
turbo
hsv
hot
cool
spring
summer
autumn
winter
gray
bone
copper
pink
sky (desde R2023a)
abyss (desde R2023b)
jet
lines
colorcube
prism
flag
white

Matriz de tres columnas

Para crear un mapa de colores personalizado, especifique map como una matriz de tres columnas de tripletes RGB donde cada fila define un color. Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades pueden ser valores double o single en el rango [0, 1] o pueden ser valores uint8 en el rango [0, 255]. Por ejemplo, esta matriz define un mapa de colores que contiene cinco colores.

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];

En esta tabla se enumeran los valores de triplete RGB para colores comunes.

Color	Triplete RGB double o single	Triplete RGB uint8
amarillo	[1 1 0]	[255 255 0]
magenta	[1 0 1]	[255 0 255]
cian	[0 1 1]	[0 255 255]
rojo	[1 0 0]	[255 0 0]
verde	[0 1 0]	[0 255 0]
azul	[0 0 1]	[0 0 255]
blanco	[1 1 1]	[255 255 255]
negro	[0 0 0]	[0 0 0]

Tipos de datos: char | double | single | uint8

target — Objetivo

objeto Figure | objeto Axes | objeto PolarAxes | objeto GeographicAxes | visualización independiente

Objetivo, especificado como uno de estos valores:

• Objeto Figure. El mapa de colores de la figura afecta a gráficas para todos los ejes dentro de la figura.

• Objeto Axes, objeto PolarAxes u objeto GeographicAxes. Puede definir un mapa de colores único para los diferentes ejes dentro de una figura.

• Una visualización independiente que tiene una propiedad Colormap. Por ejemplo, puede cambiar o consultar el mapa de colores para un objeto HeatmapChart.

Argumentos de salida

cmap — Valores de mapas de colores

matriz de tres columnas de tripletes RGB

Valores de mapas de colores, devueltos como matriz de tres columnas de tripletes RGB. Cada fila de la matriz define un triplete RGB que especifica un color del mapa de colores. Los valores están en el rango [0, 1].

Más acerca de

Mapa de colores

Un mapa de colores es una matriz de valores que define los colores de objetos de gráficas, como superficie, imagen y objetos de parche. MATLAB^® dibuja los objetos aplicando los valores de los datos a los colores del mapa de colores.

Los mapas de colores pueden tener cualquier longitud, pero deben tener tres columnas de ancho. Cada fila de la matriz define un color utilizando un triplete RGB. Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Habitualmente, las intensidades son valores double o single en el rango [0, 1]. Un valor de 0 indica que no hay color y un valor de 1 indica intensidad completa. Por ejemplo, este comando crea un mapa de colores con cinco colores: negro, rojo, verde, azul y blanco.

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

Para cambiar el esquema de colores de una visualización, llame a la función colormap para cambiar el mapa de colores de los ejes o la figura que lo contienen. Por ejemplo, estos comandos crean una gráfica de superficie y establecen el mapa de colores de la figura en mymap.

surf(peaks)
colormap(mymap)

Sugerencias

• Para controlar los límites del mapa de colores y la relación de esos límites con el rango de sus datos, use la función clim.

  Antes de R2022a: Utilice caxis, que tiene la misma sintaxis y argumentos que clim.

Historial de versiones

Introducido antes de R2006a

R2023a: Devolver la matriz del mapa de colores al establecer el mapa de colores predeterminado

De forma opcional, puede especificar un argumento de salida para almacenar el arreglo del mapa de colores cuando establezca el mapa de colores de la figura actual en el valor predeterminado. Por ejemplo:

cmap = colormap("default")

R2020b: La opción de mapa de colores 'default' para un mapa de calor muestra el mapa de colores azul en lugar de parula

Al establecer el mapa de colores de una gráfica de mapa de calor en 'default', se establece el mapa de colores de la gráfica al mapa de colores azul predeterminado para las gráficas de mapa de calor. En la versión R2020a y versiones anteriores, la opción 'default' cambia el mapa de colores a parula.

Para especificar el mapa de colores predeterminado para una gráfica de mapa de calor, pase la gráfica a la función colormap.

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

Solo las gráficas de mapa de calor se ven afectadas por este cambio.

R2018a: Establecer el mapa de colores de la figura también establece el mapa de colores de los ejes

A partir de la versión R2018a, si establece el mapa de colores para una figura, los ejes y las gráficas de la figura usan el mismo mapa de colores. Anteriormente, los ejes o gráficas para los que estableciera el mapa de colores explícitamente no se veían afectados cuando establecía el mapa de colores de la figura. Si quiere que un objeto Axes utilice un mapa de colores diferentes al de la figura, establezca el mapa de colores de los ejes después de establecer el mapa de colores de la figura.

R2014b: Mapa de colores predeterminado cambiado

• A partir de la versión R2014b, el mapa de colores predeterminado es parula. En versiones anteriores, el mapa de colores predeterminado era jet.

Consulte también

Funciones

• colorbar | ind2rgb | hsv2rgb | rgbplot

Herramientas

• Editor del mapa de colores

Temas

• Controlar los límites de un mapa de colores