Main Content

colorbar

Barra de colores que muestra la escala de colores

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.

ejemplo

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.

ejemplo

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.

ejemplo

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.

ejemplo

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

ejemplo

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

contraer todo

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

surf(peaks)
colorbar

Figure contains an axes object. The axes object contains an object of type surface.

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

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

contourf(peaks)
colorbar('southoutside')

Figure contains an axes object. The axes object contains an object of type contour.

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')

Figure contains an axes object. The axes object contains an object of type surface.

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

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')

Figure contains an axes object. The axes object contains an object of type surface.

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

Figure contains 2 axes objects. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type surface.

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)

Figure contains 2 axes objects. Axes object 1 contains an object of type contour. Axes object 2 contains an object of type contour.

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

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

Figure contains 2 axes objects. Axes object 1 contains an object of type contour. Axes object 2 contains an object of type contour.

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'})

Figure contains an axes object. The axes object contains an object of type contour.

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

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

Figure contains an axes object. The axes object contains an object of type surface.

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

surf(peaks)
colorbar

Figure contains an axes object. The axes object contains an object of type surface.

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

colorbar('off')

Figure contains an axes object. The axes object contains an object of type surface.

Argumentos de entrada

contraer todo

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

ValorUbicación resultanteOrientación resultante
'north'Encima de los ejesHorizontal
'south'Debajo de los ejesHorizontal
'east'A la derecha de los ejesVertical
'west'A la izquierda de los ejesVertical
'northoutside'Encima fuera de los ejesHorizontal
'southoutside'Abajo fuera de los ejesHorizontal
'eastoutside'A la derecha fuera de los ejes (predeterminado)Vertical
'westoutside'A la izquierda fuera de los ejesVertical
'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')

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.

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

ValorUbicación resultanteOrientación resultante
'north'Encima de los ejesHorizontal
'south'Debajo de los ejesHorizontal
'east'A la derecha de los ejesVertical
'west'A la izquierda de los ejesVertical
'northoutside'Encima fuera de los ejesHorizontal
'southoutside'Abajo fuera de los ejesHorizontal
'eastoutside'A la derecha fuera de los ejes (predeterminado)Vertical
'westoutside'A la izquierda fuera de los ejesVertical
'manual'Determinada por la propiedad PositionVertical
'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'.

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'}

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.

ModificadorDescripciónEjemplo
^{ }Superíndice'text^{superscript}'
_{ }Subíndice'text_{subscript}'
\bfFuente en negrita'\bf text'
\itFuente en cursiva'\it text'
\slFuente oblicua (generalmente igual que la fuente cursiva)'\sl text'
\rmFuente 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 caracteresSímboloSecuencia de caracteresSímboloSecuencia de caracteresSí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/.

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

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.

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

expandir todo