Esta página aún no se ha traducido para esta versión. Puede ver la versión más reciente de esta página en inglés.

colorbar

Colorbar que muestra la escala de color

Descripción

ejemplo

colorbar muestra un Colorbar vertical a la derecha de los ejes o diagramas actuales. Colorbars mostrar el colores actual e indicar la asignación de los valores de datos en el colores.

colorbar(target) agrega un Colorbar a los ejes o gráfico especificados por target.

colorbar('peer',target) agrega un Colorbar a los ejes especificados por target. Esta sintaxis no se recomienda y se puede quitar en una versión futura. En su lugar, utilice colorbar(target) .

ejemplo

colorbar(___,lcn) muestra el Colorbar en la ubicación especificada por lcn, como 'northoutside'. Especifique lcn como el último argumento de cualquiera de las sintaxis anteriores. No todos los tipos de gráficos admiten la modificación de la ubicación Colorbar.

ejemplo

colorbar(___,Name,Value) modifica el aspecto Colorbar mediante uno o varios argumentos de par nombre-valor. Por ejemplo, 'Direction','reverse' invierte la escala de colores. Especifique Name,Value como el último par de argumentos de cualquiera de las sintaxis anteriores. No todos los tipos de gráficos admiten la modificación del aspecto Colorbar.

ejemplo

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

ejemplo

colorbar('off') elimina colorbars asociados con los ejes o el gráfico actuales.

colorbar(target,'off') elimina el colorbars asociado a los ejes o el gráfico especificados por target.

colorbar(c,'off') elimina el Colorbar especificado por c.

Ejemplos

contraer todo

Añada un Colorbar a un diagrama de superficie que indique la escala de color.

figure
surf(peaks)
colorbar

De forma predeterminada, la función colorbar agrega un Colorbar vertical al lado derecho del gráfico.

Agregue un Colorbar horizontal debajo de un trazado especificando la ubicación de Colorbar como 'southoutside'.

figure
contourf(peaks)
colorbar('southoutside')

Invierta la dirección de los valores en un Colorbar de un gráfico estableciendo la propiedad 'Direction' del Colorbar en 'reverse'.

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

Los valores de Colorbar ascienden de arriba a abajo en lugar de ascender de abajo hacia arriba.

Visualice las marcas de garrapatas Colorbar y las etiquetas de marca en el costado de un Colorbar frente a la trama de la superficie.

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

Cree una figura con dos subparcelas. Añada colorbars a ambas subparcelas.

figure
subplot(2,1,1) % upper subplot 
surf(peaks)
colorbar

subplot(2,1,2) % lower subplot
contourf(peaks)
colorbar

Agregue un Colorbar a un diagrama y especifique las marcas de graduación y las etiquetas de Colorbar. Especifique el mismo número de etiquetas de marca que las marcas de graduación. Si no especifica suficientes etiquetas de marca, la función colorbar repite las etiquetas.

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

Añada una etiqueta de texto a lo largo de un Colorbar.

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

Añada un Colorbar a un diagrama de superficie.

figure
surf(peaks)
colorbar

Elimine el Colorbar de la trama de superficie.

colorbar('off')

Argumentos de entrada

contraer todo

Colorbar la ubicación y la orientación con respecto a los ejes, especificados como uno de los valores de esta tabla.

ValorUbicación resultanteOrientación resultante
'north'Parte superior de los ejesHorizontal
'south'Parte inferior de los ejesHorizontal
'east'Lado derecho de los ejesVertical
'west'Lado izquierdo de los ejesVertical
'northoutside'Parte superior fuera de los ejesHorizontal
'southoutside'Parte inferior exterior de ejesHorizontal
'eastoutside'Justo fuera de los ejes (por defecto)Vertical
'westoutside'Izquierda fuera de ejesVertical

Si un Colorbar ya existe en la ubicación especificada, entonces un Colorbar actualizado reemplaza el existente. Para asegurarse de que el Colorbar no se superpone al gráfico, especifique una ubicación con el sufijo, outside.

También puede establecer la ubicación Colorbar utilizando su propiedad Location . Por ejemplo, colorbar('Location','northoutside') es igual que colorbar('northoutside').

Ejemplo: colorbar('westoutside')

Destino para el Colorbar, especificado como un objeto Axes , un objeto PolarAxes o un objeto Graphics que tiene una propiedad ColorbarVisible . Por ejemplo, puede Agregar o quitar un Colorbar de un objeto HeatmapChart .

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

Nota

Algunos gráficos no admiten la modificación del aspecto Colorbar, como la ubicación, o la devolución del objeto Colorbar como argumento de salida.

Argumentos de par nombre-valor

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

Las propiedades de Colorbar enumeradas aquí son sólo un subconjunto. Para obtener una lista completa, vea 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'Parte superior de los ejesHorizontal
'south'Parte inferior de los ejesHorizontal
'east'Lado derecho de los ejesVertical
'west'Lado izquierdo de los ejesVertical
'northoutside'Parte superior fuera de los ejesHorizontal
'southoutside'Parte inferior exterior de ejesHorizontal
'eastoutside'Justo fuera de los ejes (por defecto)Vertical
'westoutside'Izquierda fuera de ejesVertical
'manual'Determinado por la propiedad PositionVertical

Para mostrar el Colorbar en una ubicación que no aparece en la tabla, utilice la propiedad Position para especificar una ubicación personalizada. Si establece la propiedad Position , MATLAB® establece la propiedad Location en 'manual'. Los ejes asociados no se redimensionan para alojar el Colorbar cuando la propiedad Location está establecida en 'manual'.

Etiquetas de marca de graduación, especificadas como una matriz de celdas de vectores de caracteres, una matriz de cadenas, una matriz numérica, un vector de caracteres o una cadena. De forma predeterminada, el Colorbar etiqueta las marcas de la marca con valores numéricos. Si especifica etiquetas y no especifica suficientes etiquetas para todas las marcas de graduación, MATLAB cicla a través de las etiquetas.

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

Interpretación de caracteres de etiqueta de marca, especificados como uno de estos valores:

  • 'tex' : Interprete etiquetas utilizando un subconjunto de la marca Tex.

  • 'latex' : Permite interpretar etiquetas mediante un subconjunto de marcado de látex.

  • 'none' : Mostrar caracteres literales

Tex Markup

De forma predeterminada, MATLAB admite un subconjunto de marcado Tex. Use Tex Markup para agregar superíndices y subíndices, modificar el tipo de texto y el color e incluir caracteres especiales en las etiquetas.

En esta tabla se enumeran los modificadores admitidos cuando la propiedad TickLabelInterpreter se establece en 'tex', que es el valor predeterminado. La mayoría de los modificadores permanecen en vigencia hasta el final del texto. Los superíndices y subíndices sólo modifican el siguiente carácter o el texto dentro de las llaves {}.

ModificadorDescripciónEjemplo
^{ }Superíndice'text^{superscript}'
_{ }Subíndice'text_{subscript}'
\bfBold fuente'\bf text'
\itCursiva fuente'\it text'
\slFuente oblicua (raramente disponible)'\sl text'
\rmNormal fuente'\rm text'
\fontname{specifier}Establezca specifier como nombre de una familia de fuentes para cambiar el estilo de fuente. Puede usar esto en combinación con otros modificadores.'\fontname{Courier} text'
\fontsize{specifier}Establezca specifier como un valor numérico escalar para cambiar el tamaño de la fuente.'\fontsize{15} text'
\color{specifier}Establezca specifer como uno de estos colores: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, o lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Establezca specifier como trío RGB de tres elementos para cambiar el color de fuente.'\color[rgb]{0,0.5,0.5} text'

En esta tabla se muestran los caracteres especiales admitidos con la propiedad Interpreter establecida en 'tex'.

Secuencia de caracteresSímboloSecuencia de caracteresSímboloSecuencia de caracteresSímbolo

\alpha

a

\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

F

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

Ν

\Omega

Ω

\pm

±

\xi

Ξ

\forall

\geq

=

\pi

π-

\exists

\propto

\rho

Ρ

\ni

\partial

\sigma

Σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

y

\Re

\neq

\equiv

=

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

N

\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

©

Látex marcado

Para utilizar el marcado de látex, establezca la propiedad TickLabelInterpreter en 'latex'. El texto mostrado utiliza el estilo de fuente latex predeterminado. Las propiedades FontName, FontWeighty FontAngle no tienen ningún efecto. Para cambiar el estilo de fuente, utilice el marcado latex dentro del texto.

El tamaño máximo del texto que se puede utilizar con el intérprete de latex es de 1200 caracteres. Para texto multilínea, el tamaño máximo del texto se reduce en unos 10 caracteres por línea.

Para obtener más información sobre el sistema latex, consulte el sitio web del proyecto latex en http://www.latex-Project.org/.

Ubicaciones de marca de graduación, especificadas como un vector de valores numéricos monotónicamente crecientes. Los valores no necesitan ser espaciados por igual. 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 color, especificada como uno de estos valores:

  • 'normal' : Muestra los colores y las etiquetas que ascienden de abajo a arriba para una Colorbar vertical y ascienden de izquierda a derecha para un Colorbar horizontal.

  • 'reverse' : Muestra los colores y las etiquetas que descienden de abajo hacia arriba para una Colorbar vertical y descienden de izquierda a derecha para un Colorbar horizontal.

Tamaño de fuente, especificado como un 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 regional.

Si cambia el tamaño de fuente de los ejes, MATLAB establece automáticamente el tamaño de fuente del objeto colorbar en 90% del tamaño de fuente de los ejes. Si establece manualmente el tamaño de fuente de objeto colorbar , al cambiar el tamaño de fuente de los ejes no afecta al objeto colorbar .

Argumentos de salida

contraer todo

(objeto): Utilice c para establecer las propiedades de Colorbar después de crearse.

Más acerca de

contraer todo

Consideraciones sobre compatibilidad

A partir de R2014b, la función colorbar devuelve un objeto Colorbar . En versiones anteriores, devuelve un objeto Axes .

Sugerencias

  • Para agregar una descripción de texto a lo largo del Colorbar, acceda al objeto de texto subyacente mediante la propiedad Label del Colorbar.

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

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

    c.Label.FontSize = 12;

  • Agregar un Colorbar puede cambiar el tamaño de los ejes para acomodar el Colorbar.

  • Si no existe un eje, la función colorbar crea un eje en blanco y muestra un Colorbar con el colores predeterminado.

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

Introducido antes de R2006a