colorbar

Barra de colores que muestra la escala de colores

Sintaxis

colorbar

colorbar(location)

colorbar(___,Name,Value)

colorbar(target,___)

c = colorbar(___)

colorbar('off')

colorbar(target,'off')

Descripción

colorbar muestra una barra de colores vertical a la derecha de los ejes o gráfica actuales. Las barras de colores muestran el mapa de colores actual e indican la asignación de valores de datos en el mapa de colores.

colorbar(location) muestra la barra de colores en una ubicación específica, como 'northoutside'. No todos los tipos de gráficas permiten modificar la ubicación de la barra de colores.

colorbar(___,Name,Value) modifica la apariencia de la barra de colores utilizando uno o varios argumentos de par nombre-valor. Por ejemplo, 'Direction','reverse' invierte la escala de colores. Especifique Name,Value como último par de argumentos en cualquiera de las sintaxis anteriores. No todos los tipos de gráficas permiten modificar el aspecto de la barra de colores.

colorbar(target,___) añade una barra de colores a los ejes o a la gráfica especificados por target. Especifique los ejes o la gráfica objetivo como primer argumento en cualquiera de las sintaxis anteriores.

c = colorbar(___) devuelve el objeto ColorBar. Puede utilizar este objeto para establecer las propiedades después de crear la barra de colores. Especifique el argumento de retorno c con cualquiera de las sintaxis anteriores.

colorbar('off') borra todas las barras de colores asociadas a los ejes o a la gráfica actuales.

colorbar(target,'off') borra todas las barras de colores asociadas a los ejes o a la gráfica objetivo. También puede especificar un objeto ColorBar como objetivo.

Ejemplos

Añadir una barra de colores a una gráfica

Añada una barra de colores a una gráfica de superficie indicando la escala de colores.

surf(peaks)
colorbar

De forma predeterminada, la función colorbar añade una barra de colores vertical a la parte derecha de la gráfica.

Añadir una barra de colores horizontal a una gráfica

Añada una barra de colores horizontal debajo de una gráfica especificando su ubicación como 'southoutside'.

contourf(peaks)
colorbar('southoutside')

Invertir la dirección de la barra de colores

Invierta la dirección de los valores de una barra de colores de una gráfica estableciendo la propiedad 'Direction' de la barra de colores en 'reverse'.

surf(peaks)
colorbar('Direction','reverse')

Los valores de la barra de colores ascienden de arriba abajo en lugar de ascender de abajo arriba.

Mostrar las marcas de graduación de la barra de colores en el lado opuesto

Muestre las marcas de graduación de la barra de colores y las etiquetas de graduación en el lateral de una barra de colores orientada hacia la gráfica de superficie.

surf(peaks)
colorbar('AxisLocation','in')

Añadir barras de colores al diseño de gráfica en mosaico

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 ejes. A continuación, muestre una gráfica de superficie en cada eje con una barra de colores.

tiledlayout(2,1)

% Top plot
nexttile 
surf(peaks)
colorbar

% Bottom plot
nexttile
mesh(peaks)
colorbar

Mostrar la barra de colores compartida en un diseño de gráfica en mosaico

Cuando desee compartir una barra de colores entre dos o más gráficas, puede mostrarla en un mosaico separado del diseño.

Cree diagramas de contorno rellenos de los conjuntos de datos peaks y membrane en un diseño de gráfica en mosaico.

Z1 = peaks;
Z2 = membrane;
tiledlayout(2,1);
nexttile
contourf(Z1)
nexttile
contourf(Z2)

Añada una barra de colores y muévala al mosaico este.

cb = colorbar;
cb.Layout.Tile = 'east';

Especificar etiquetas de graduación y marcas de graduación de barras de colores

Añada una barra de colores a una gráfica y especifique las marcas de graduación y las etiquetas de graduación de la barra de colores. Especifique el mismo número de etiquetas de graduación que de marcas de graduación. Si no especifica suficientes etiquetas de graduación, la función colorbar las repetirá.

contourf(peaks)
colorbar('Ticks',[-5,-2,1,4,7],...
         'TickLabels',{'Cold','Cool','Neutral','Warm','Hot'})

Etiquetar una barra de colores

Añada una etiqueta de texto a una barra de colores.

surf(peaks)
c = colorbar;
c.Label.String = 'Elevation (ft in 1000s)';

Eliminar una barra de colores

Añada una barra de colores a la gráfica de superficie.

surf(peaks)
colorbar

Elimine la barra de colores de la gráfica de superficie.

colorbar('off')

Argumentos de entrada

location — Ubicación

'eastoutside' (predeterminado) | 'north' | 'south' | 'east' | 'west' | 'northoutside' | ...

Ubicación de la barra de colores con respecto a los ejes, especificada como uno de los valores de esta tabla.

Valor	Ubicación resultante	Orientación resultante
'north'	Encima de los ejes	Horizontal
'south'	Debajo de los ejes	Horizontal
'east'	A la derecha de los ejes	Vertical
'west'	A la izquierda de los ejes	Vertical
'northoutside'	Encima fuera de los ejes	Horizontal
'southoutside'	Abajo fuera de los ejes	Horizontal
'eastoutside'	A la derecha fuera de los ejes (predeterminado)	Vertical
'westoutside'	A la izquierda fuera de los ejes	Vertical
'layout'	Un mosaico en un diseño de gráfica en mosaico. Para mover la barra de colores a un mosaico diferente, establezca la propiedad Layout de la barra de colores.	Depende de la forma del mosaico

Si ya existe una barra de colores en la ubicación especificada, la nueva barra sustituirá a la existente. Para asegurarse de que la barra de colores no se superponga a la gráfica, especifique una ubicación con el sufijo outside.

También puede establecer la ubicación de la barra de colores mediante su propiedad Location. Por ejemplo, colorbar('Location','northoutside') es igual que colorbar('northoutside').

Ejemplo: colorbar('westoutside')

target — Objetivo

objeto Axes | objeto PolarAxes | objeto GeographicAxes | objeto de gráficas

Objeto objetivo que contiene la visualización de datos asociada, especificado como objeto Axes, objeto PolarAxes, objeto GeographicAxes o un objeto de gráficas que tiene una propiedad ColorbarVisible. Por ejemplo, un objeto HeatmapChart tiene la propiedad ColorbarVisible.

Si no se especifica el objetivo, el comando colorbar afecta a los ejes actuales (el objeto devuelto por gca).

Nota

Algunas gráficas no admiten modificar la apariencia de la barra de colores, como la ubicación, ni devolver el objeto ColorBar como un argumento de salida.

Argumentos de par nombre-valor

Ejemplo: colorbar('FontSize',12,'Direction','reverse') establece el tamaño de la fuente de la barra de colores en 12 puntos e invierte su orientación.

Las propiedades de la barra de colores que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte ColorBar Properties.

Location — Ubicación con respecto a los ejes

'eastoutside' (predeterminado) | 'north' | 'south' | 'east' | 'west' | 'northoutside' | ...

Ubicación con respecto a los ejes, especificada como uno de los valores enumerados en esta tabla.

Valor	Ubicación resultante	Orientación resultante
'north'	Encima de los ejes	Horizontal
'south'	Debajo de los ejes	Horizontal
'east'	A la derecha de los ejes	Vertical
'west'	A la izquierda de los ejes	Vertical
'northoutside'	Encima fuera de los ejes	Horizontal
'southoutside'	Abajo fuera de los ejes	Horizontal
'eastoutside'	A la derecha fuera de los ejes (predeterminado)	Vertical
'westoutside'	A la izquierda fuera de los ejes	Vertical
'manual'	Determinada por la propiedad Position	Vertical
'layout'	Un mosaico en un diseño de gráfica en mosaico. Para mover la barra de colores a un mosaico diferente, establezca la propiedad Layout de la barra de colores.	Depende de la forma del mosaico

Para mostrar la barra de colores en una ubicación que no aparezca en la tabla, utilice la propiedad Position y especifique una ubicación personalizada. Si define la propiedad Position, MATLAB^® establece la propiedad Location en 'manual'. Los ejes asociados no cambian de tamaño para acomodar la barra de colores cuando la propiedad Location se establece en 'manual'.

TickLabels — Etiquetas de marca de graduación

arreglo de celdas de vectores de caracteres | arreglo de cadenas | arreglo numérico | vector de caracteres | arreglo categórico

Etiquetas de marca de graduación, especificadas como un arreglo de celdas de vectores de caracteres, un arreglo de cadenas, un arreglo numérico, un vector de caracteres o un arreglo categórico. De forma predeterminada, la barra de colores etiqueta las marcas de graduación con valores numéricos. Si especifica etiquetas pero no las suficientes para todas las marcas de graduación, MATLAB repite las etiquetas cíclicamente.

Si especifica esta propiedad como un arreglo categórico, MATLAB utiliza los valores del arreglo, no las categorías.

Ejemplo: {'cold','warm','hot'}

TickLabelInterpreter — Intérprete de etiquetas de graduación

'tex' (predeterminado) | 'latex' | 'none'

Intérprete de etiquetas de graduación, especificado como uno de estos valores:

• 'tex': interpreta las etiquetas usando un subconjunto del marcado TeX.

• 'latex': interpreta las etiquetas usando un subconjunto del marcado LaTeX. Cuando especifique las etiquetas de graduación, utilice signos de dólar alrededor de cada elemento del arreglo de celdas.

• 'none': muestra caracteres literales.

Marcado TeX

De forma predeterminada, MATLAB admite un subconjunto del marcado TeX. Utilice el marcado TeX para añadir superíndices y subíndices, modificar el tipo y el color del texto e incluir caracteres especiales en las etiquetas.

Los modificadores permanecen en vigencia hasta el final del texto. Los superíndices y los subíndices son una excepción porque solo modifican el siguiente carácter o los caracteres incluidos entre llaves. Cuando se establece el intérprete en 'tex', los modificadores admitidos son los siguientes.

Modificador	Descripción	Ejemplo
^{ }	Superíndice	'text^{superscript}'
_{ }	Subíndice	'text_{subscript}'
\bf	Fuente en negrita	'\bf text'
\it	Fuente en cursiva	'\it text'
\sl	Fuente oblicua (generalmente igual que la fuente cursiva)	'\sl text'
\rm	Fuente normal	'\rm text'
\fontname{specifier}	Nombre de fuente: sustituya specifier por el nombre de una familia de fuentes. Puede usarlo en combinación con otros modificadores.	'\fontname{Courier} text'
\fontsize{specifier}	Tamaño de la fuente: sustituya specifier por un valor escalar numérico en unidades de punto.	'\fontsize{15} text'
\color{specifier}	Color de la fuente: sustituya specifier por uno de estos colores: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange o lightBlue.	'\color{magenta} text'
\color[rgb]{specifier}	Color de fuente personalizado: sustituya specifier por un triplete RGB de tres elementos.	'\color[rgb]{0,0.5,0.5} text'

En esta tabla, se muestran los caracteres especiales admitidos para el intérprete 'tex'.

Secuencia de caracteres	Símbolo	Secuencia de caracteres	Símbolo	Secuencia de caracteres	Símbolo
\alpha	α	\upsilon	υ	\sim	~
\angle	∠	\phi	ϕ	\leq	≤
\ast	*	\chi	χ	\infty	∞
\beta	β	\psi	ψ	\clubsuit	♣
\gamma	γ	\omega	ω	\diamondsuit	♦
\delta	δ	\Gamma	Γ	\heartsuit	♥
\epsilon	ϵ	\Delta	Δ	\spadesuit	♠
\zeta	ζ	\Theta	Θ	\leftrightarrow	↔
\eta	η	\Lambda	Λ	\leftarrow	←
\theta	θ	\Xi	Ξ	\Leftarrow	⇐
\vartheta	ϑ	\Pi	Π	\uparrow	↑
\iota	ι	\Sigma	Σ	\rightarrow	→
\kappa	κ	\Upsilon	ϒ	\Rightarrow	⇒
\lambda	λ	\Phi	Φ	\downarrow	↓
\mu	µ	\Psi	Ψ	\circ	º
\nu	ν	\Omega	Ω	\pm	±
\xi	ξ	\forall	∀	\geq	≥
\pi	π	\exists	∃	\propto	∝
\rho	ρ	\ni	∍	\partial	∂
\sigma	σ	\cong	≅	\bullet	•
\varsigma	ς	\approx	≈	\div	÷
\tau	τ	\Re	ℜ	\neq	≠
\equiv	≡	\oplus	⊕	\aleph	ℵ
\Im	ℑ	\cup	∪	\wp	℘
\otimes	⊗	\subseteq	⊆	\oslash	∅
\cap	∩	\in	∈	\supseteq	⊇
\supset	⊃	\lceil	⌈	\subset	⊂
\int	∫	\cdot	·	\o	ο
\rfloor	⌋	\neg	¬	\nabla	∇
\lfloor	⌊	\times	x	\ldots	...
\perp	⊥	\surd	√	\prime	´
\wedge	∧	\varpi	ϖ	\0	∅
\rceil	⌉	\rangle	〉	\mid	|
\vee	∨	\langle	〈	\copyright	©

Marcado LaTeX

Para utilizar el marcado LaTeX, establezca la propiedad TickLabelInterpreter en 'latex'. Utilice símbolos de dólar alrededor de las etiquetas, por ejemplo, use '$\int_1^{20} x^2 dx$' para el modo en línea o '$$\int_1^{20} x^2 dx$$' para el modo de visualización.

El texto mostrado utiliza el estilo de fuente de LaTeX predeterminado. Las propiedades FontName, FontWeight y FontAngle no tienen ningún efecto. Para cambiar el estilo de fuente, utilice el marcado LaTeX en el texto. El tamaño máximo del texto que puede utilizar con el intérprete de LaTeX es de 1.200 caracteres. En texto multilínea, el tamaño máximo se reduce aproximadamente 10 caracteres por línea.

Para ejemplos que utilicen TeX y LaTeX, consulte Letras griegas y caracteres especiales en el texto de la gráfica. Para obtener más información sobre el sistema LaTeX, consulte el sitio web del proyecto LaTeX en https://www.latex-project.org/.

Ticks — Ubicaciones de las marcas de graduación

vector de valores numéricos monótonamente crecientes

Ubicaciones de las marcas de graduación, especificadas como vector de valores numéricos monótonamente crecientes. Los valores no tienen que ser equidistantes. Si no desea que se muestren las marcas de graduación, establezca la propiedad en el vector vacío, [].

Ejemplo: [-1,0,1,2,3,4,5]

Tipos de datos: single | double

Direction — Dirección de la escala de colores

'normal' (predeterminado) | 'reverse'

Dirección de la escala de colores, especificada como uno de estos valores:

• 'normal': muestra el mapa de colores y las etiquetas de forma ascendente de abajo arriba, en el caso de una barra de colores vertical, y de forma ascendente de izquierda a derecha, en el caso de una horizontal.

• 'reverse': muestra el mapa de colores y las etiquetas de forma descendente de abajo arriba, en el caso de una barra de colores vertical, y de forma descendente de izquierda a derecha, en el caso de una horizontal.

FontSize — Tamaño de la fuente

valor escalar mayor que cero

Tamaño de la fuente, especificado como valor escalar mayor que cero en unidades de punto. El tamaño de fuente predeterminado depende del sistema operativo específico y de la configuración local.

Si cambia el tamaño de la fuente de los ejes, MATLAB establece automáticamente el tamaño de la fuente de la barra de colores al 90% del tamaño de fuente de los ejes. Si establece manualmente el tamaño de la fuente de la barra de colores, cambiar el tamaño de la fuente de los ejes no afectará a la fuente de la barra de colores.

Sugerencias

• Para añadir una descripción de texto a una barra de colores, acceda al objeto de texto subyacente mediante la propiedad Label de la barra de colores.

  c.Label.String = 'My Colorbar Label';
  

  Para cambiar el aspecto de la etiqueta, como el estilo de fuente o el color, establezca otras propiedades de texto. Para obtener una lista de las propiedades, consulte Text Properties. Por ejemplo, este código cambia el tamaño de fuente.

  c.Label.FontSize = 12;

• Cuando se añade una barra de colores, es posible que los ejes cambien de tamaño para adaptarse a ella.

• Si no existe ningún eje, la función colorbar crea un eje vacío y muestra una barra de colores con el mapa de colores predeterminado.

• Puede utilizar colorbar('delete') o colorbar('hide') en lugar de colorbar('off') para eliminar todas las barras de colores de los ejes actuales. Todos estos comandos son equivalentes.

Historial de versiones

Introducido antes de R2006a

R2014b: No se recomienda la entrada 'peer'

A partir de la versión R2014b, no se recomienda colorbar('peer',target) y es posible que se elimine en una versión futura. En su lugar, utilice colorbar(target).

Consulte también

Funciones

• colormap

Propiedades

• ColorBar Properties

Temas

• Creación de barras de colores
• Controlar los límites de un mapa de colores