xlabel

Etiquetar el eje x

Sintaxis

xlabel(txt)

xlabel(target,txt)

xlabel(___,Name,Value)

t = xlabel(___)

Descripción

xlabel(txt) etiqueta el eje x de los ejes actuales o de la visualización independiente. Volver a emitir el comando xlabel sustituye la etiqueta antigua por la nueva.

xlabel(target,txt) añade la etiqueta al objeto objetivo especificado.

xlabel(___,Name,Value) modifica la apariencia de la etiqueta utilizando uno o más argumentos de par nombre-valor. Por ejemplo, 'FontSize',12 establece el tamaño de la fuente en 12 puntos. Especifique los argumentos de par nombre-valor tras el resto de argumentos de entrada. No todos los tipos de gráficas admiten modificar la apariencia de las etiquetas.

t = xlabel(___) devuelve el objeto texto utilizado como etiqueta del eje x. Utilice t para realizar futuras modificaciones en la etiqueta una vez que se ha creado.

Ejemplos

Etiquetar el eje x

Muestre Population debajo del eje x.

plot((1:10).^2)
xlabel('Population')

Crear etiquetas multilínea del eje x

Cree una etiqueta multilínea mediante un arreglo de celdas de vectores de caracteres.

plot((1:10).^2)
xlabel({'Population','(in thousands)'})

Incluir letras griegas en etiquetas del eje x

Incluya letras griegas y otros caracteres especiales en la etiqueta utilizando el marcado TeX.

x = linspace(-2*pi,2*pi);
y = sin(x);
plot(x,y)
xlabel('-2\pi \leq x \leq 2\pi')

Incluir valores variables en etiquetas del eje x

Añada una etiqueta con texto y un valor variable. Utilice la función num2str para incluir un valor variable en la etiqueta.

plot((1:10).^2)  
year = 2014;
xlabel(['Population for Year ',num2str(year)])

Incluir superíndices y subíndices en etiquetas del eje

Utilice los caracteres '^' y '_' para incluir superíndices y subíndices en las etiquetas del eje. Utilice llaves {} para modificar más de un carácter.

t = linspace(0,1);
y = exp(t);
plot(t,y)
xlabel('t_{seconds}')
ylabel('e^t')

Cambiar el tamaño y el color de la fuente de la etiqueta del eje x

Utilice argumentos de par Name,Value para establecer el tamaño de la fuente, el grosor de la fuente y las propiedades del color del texto de la etiqueta del eje x.

plot((1:10).^2)
xlabel('Population','FontSize',12,'FontWeight','bold','Color','r')

Etiquetar el eje x de una gráfica específica

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. Represente los datos en cada eje y cree una etiqueta del eje x para la gráfica superior.

tiledlayout(2,1)
ax1 = nexttile;
plot((1:10).^2)
xlabel(ax1,'Population')

ax2 = nexttile;
plot((1:10).^3)

Modificar una etiqueta del eje x después de crearla

Etiquete el eje x y devuelva el objeto de texto utilizado como etiqueta.

plot((1:10).^2)
t = xlabel('Population');

Utilice t para establecer las propiedades del texto de la etiqueta después de crearla. Por ejemplo, establezca el color de la etiqueta en rojo. Utilice la notación de puntos para establecer las propiedades.

t.Color = 'red';

Argumentos de entrada

txt — Etiqueta del eje

escalar de cadena | vector de caracteres | arreglo de cadenas | arreglo de caracteres | arreglo de celdas | arreglo categórico | valor numérico

Etiqueta del eje, especificada como escalar de cadena, vector de caracteres, arreglo de cadenas, arreglo de caracteres, arreglo de celdas, arreglo categórico o valor numérico.

Ejemplo: 'my label'

Ejemplo: {'first line','second line'}

Ejemplo: 123

Para incluir variables numéricas con texto en una etiqueta, utilice la función num2str. Por ejemplo:

x = 42;
txt = ['The value is ',num2str(x)];

Para incluir caracteres especiales, como superíndices o subíndices, letras griegas o símbolos matemáticos, use el marcado TeX. Para ver una lista de marcado compatible, consulte la propiedad Interpreter.

Para crear etiquetas multilínea:

• Utilice un arreglo de cadenas, donde cada elemento contiene una línea de texto, como ["first line","second line"].

• Utilice un arreglo de celdas, donde cada celda contiene una línea de texto, como {'first line','second line'}.

• Utilice un arreglo de caracteres, donde cada fila contiene el mismo número de caracteres, como ['abc'; 'ab '].

• Utilice sprintf para crear texto con un nuevo carácter de línea, como sprintf('first line \n second line').

Las etiquetas numéricas se convierten a texto mediante sprintf('%g',value). Por ejemplo, 12345678 se muestra como 1.23457e+07.

Nota

• Si especifica la etiqueta como un arreglo categórico, MATLAB^® utiliza los valores del arreglo, no las categorías.

• Las palabras default, factory y remove son palabras reservadas que no aparecerán en una etiqueta cuando se entrecomillen como caracteres normales. Para mostrar cualquiera de estas palabras de forma individual, deben ir precedidas de una barra invertida, como '\default' o '\remove'.

target — Objetivo de la etiqueta

objeto Axes | objeto TiledChartLayout | visualización independiente | arreglo de objetos

Objetivo de la etiqueta, especificado como una de las siguientes opciones:

• Un objeto Axes.

• Un objeto TiledChartLayout.

• Una visualización independiente que tiene una propiedad XLabel. Por ejemplo, puede especificar una gráfica heatmap como el objetivo.

• Un arreglo de objetos de gráficas de la lista anterior. Los objetos deben pertenecer a la misma clase. Para determinar la clase, use la función class.

Si no se especifica el objetivo, la función xlabel añade la etiqueta al objeto de gráficas devuelto por el comando gca.

Nota

Las visualizaciones independientes no admiten modificar la apariencia de la etiqueta, como el color, ni devolver el objeto de texto como un argumento de salida.

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

Ejemplo: xlabel("My Label",Color="red",FontSize=12) crea una etiqueta del eje x con texto rojo y una fuente de 12 puntos.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: xlabel("My Label","Color","red","FontSize",12) crea una etiqueta del eje x con texto rojo y una fuente de 12 puntos.

Nota

Las propiedades de texto que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte Text Properties.

FontSize — Tamaño de la fuente

11 (predeterminado) | valor escalar mayor que 0

Tamaño de la fuente, especificado como valor escalar mayor que 0 en unidades de punto. Un punto equivale a 1/72 pulgadas. Para cambiar las unidades de la fuente, utilice la propiedad FontUnits.

Configurar las propiedades del tamaño de la fuente para los ejes asociados también afecta al tamaño de la fuente de la etiqueta. El tamaño de la fuente de la etiqueta se actualiza y es igual al tamaño de la fuente de los ejes por el factor de escala de la etiqueta. La propiedad FontSize de los ejes contiene el tamaño de la fuente de los ejes. La propiedad LabelFontSizeMultiplier de los ejes contiene el factor de escala de la etiqueta. De forma predeterminada, el tamaño de la fuente de los ejes es de 10 puntos y el factor de escala es 1.1, lo que significa que el tamaño de la fuente de la etiqueta del eje x es de 11 puntos.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

FontWeight — Grosor de los caracteres

'normal' (predeterminado) | 'bold'

Grosor de los caracteres, especificado como 'normal' o 'bold'.

MATLAB utiliza la propiedad FontWeight para seleccionar una fuente de las disponibles en el sistema. No todas las fuentes disponen de un grosor negrita. Por lo tanto, especificar un grosor de fuente negrita puede seguir teniendo como resultado un grosor de fuente normal.

FontName — Nombre de la fuente

nombre de la fuente compatible | "FixedWidth"

Nombre de la fuente, especificado como nombre de la fuente compatible o "FixedWidth". Para mostrar e imprimir texto correctamente, debe elegir una fuente compatible con el sistema. La fuente predeterminada depende del sistema operativo y de la configuración local.

Para utilizar una fuente con un grosor fijo que se vea bien en cualquier configuración local, utilice "FixedWidth". La fuente con grosor fijo se basa en la propiedad raíz FixedWidthFontName. Configurar la propiedad raíz FixedWidthFontName provoca una actualización inmediata de la visualización para utilizar la nueva fuente.

Color — Color del texto

[0.15 0.15 0.15] (predeterminado) | Triplete RGB | código de color hexadecimal | 'r' | 'g' | 'b' | ...

Color del texto, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• 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 deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB utiliza en muchos tipos de gráficas.

Triplete RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Ejemplo: 'blue'

Ejemplo: [0 0 1]

Ejemplo: '#0000FF'

Rotation — Orientación del texto

valor escalar en grados

Orientación del texto, especificada como un valor escalar en grados. Un valor de rotación de 0 grados hace el texto horizontal. Para texto vertical, establezca esta propiedad en 90 o -90. Los valores positivos rotan el texto en sentido contrario a las agujas del reloj. Los valores negativos rotan el texto en el sentido de las agujas del reloj.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Interpreter — Intérprete de texto

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

Intérprete de texto, especificado como uno de estos valores:

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

• 'latex': interpreta caracteres usando el marcado LaTeX.

• 'none': muestra caracteres literales.

Marcado TeX

De forma predeterminada, MATLAB admite un subconjunto del marcado TeX. Utilice el marcado TeX para agregar superíndices y subíndices, modificar el tipo y el color de la fuente e incluir caracteres especiales en el texto.

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 el intérprete en 'latex'. En el modo en línea, encierre el marcado entre símbolos de dólar ($). En el modo de visualización, encierre el marcado entre símbolos de dólar dobles ($$).

Modo LaTeX	Ejemplo	Resultado
En línea	'$\int_1^{20} x^2 dx$'
Visualización	'$$\int_1^{20} x^2 dx$$'

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.

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, esto 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/.

Argumentos de salida

t — Objeto de texto

objeto de texto

Objeto de texto utilizado como la etiqueta del eje x. Utilice t para acceder y modificar las propiedades de la etiqueta después de crearla.

Sugerencias

• De forma predeterminada, la propiedad Interactions contiene editInteraction, de manera que el texto puede editarse haciendo clic en el texto. Para deshabilitar esta interacción, establezca la propiedad Interactions del objeto de texto en [].

Historial de versiones

Introducido antes de R2006a

R2023a: Rotar la etiqueta del eje x sin solapar los ejes

Si modifica la propiedad Rotation de la etiqueta del eje x en una gráfica 2D, las propiedades HorizontalAlignment y VerticalAlignment de la etiqueta cambian automáticamente para prevenir el solapamiento entre la etiqueta y los ejes.

Consulte también

Funciones

• ylabel | zlabel | text | title | num2str

Propiedades

• Text Properties

Temas

• Añadir títulos y etiquetas de ejes a gráficas