Main Content

xticklabels

Establecer o consultar etiquetas de marcas del eje x

Descripción

ejemplo

xticklabels(labels) establece las etiquetas de marcas del eje x para los ejes actuales. Especifique labels como un arreglo de cadenas o un arreglo de celdas de vectores de caracteres; por ejemplo, {'January','February','March'}. Si especifica las etiquetas, las etiquetas de marcas y los valores de marcas del eje x ya no se actualizan automáticamente en función de los cambios en los ejes.

xl = xticklabels devuelve las etiquetas de marcas del eje x para los ejes actuales.

ejemplo

xticklabels('auto') establece un modo automático, lo que permite a los ejes determinar las etiquetas de marcas del eje x. Utilice esta opción si establece las etiquetas y luego desea volver a establecer los valores predeterminados.

xticklabels('manual') establece un modo manual que congela las etiquetas de marcas del eje x en los valores actuales.

m = xticklabels('mode') devuelve el valor actual del modo de etiquetas de marcas del eje x, que puede ser 'auto' o 'manual'. De forma predeterminada, el modo es el automático, salvo que especifique las etiquetas de marcas o establezca el modo en manual.

ejemplo

___ = xticklabels(ax,___) utiliza los ejes especificados por ax en lugar de los ejes actuales. Especifique ax como primer argumento de entrada para cualquiera de las sintaxis anteriores.

Ejemplos

contraer todo

Cree una gráfica de líneas. Muestre las marcas de graduación a lo largo del eje x en los valores 0, 5 y 10. Luego, especifique una etiqueta para cada marca de graduación.

x = linspace(0,10);
y = x.^2;
plot(x,y)
xticks([0 5 10])
xticklabels({'x = 0','x = 5','x = 10'})

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

Cree una gráfica de líneas. Especifique los límites del eje x y muestre las marcas de graduación a lo largo del eje x en incrementos de π.

x = linspace(0,6*pi);
y = sin(x);
plot(x,y)
xlim([0 6*pi])
xticks(0:pi:6*pi)

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

MATLAB® etiqueta las marcas de graduación con los valores numéricos. Cambie las etiquetas para mostrar el símbolo π especificando el texto para cada etiqueta.

xticklabels({'0','\pi','2\pi','3\pi','4\pi','5\pi','6\pi'})

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

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. Cree dos gráficas de datos aleatorios. Establezca las etiquetas y los valores de marcas del eje x para la segunda gráfica especificando ax2 como el primer argumento de entrada.

tiledlayout(2,1)
ax1 = nexttile;
plot(ax1,rand(3))

ax2 = nexttile;
plot(ax2,rand(3))
xticks(ax2,[1 2 3])
xticklabels(ax2,{'one','two','three'})

Figure contains 2 axes objects. Axes object 1 contains 3 objects of type line. Axes object 2 contains 3 objects of type line.

Cree una gráfica de puntos y especifique los valores de marcas del eje x y las etiquetas correspondientes. Luego, vuelva a establecer las etiquetas y los valores de marcas del eje x en los valores predeterminados.

stem(1:10)
xticks([1 4 6 10])
xticklabels({'A','B','C','D'})

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

xticks('auto')
xticklabels('auto')

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

Elimine las etiquetas de marcas a lo largo del eje x especificando las etiquetas de marcas como un arreglo vacío.

plot(rand(5))
xticklabels({})

Figure contains an axes object. The axes object contains 5 objects of type line.

Argumentos de entrada

contraer todo

Etiquetas de marcas, especificadas como arreglo de celdas de vectores de caracteres, arreglo de cadenas o arreglo categórico. Si no desea que se muestren las etiquetas de marcas, especifique un arreglo de celdas vacío {}. Las etiquetas de marcas admiten marcado TeX y LaTeX. Para obtener más información, consulte la propiedad TickLabelInterpreter del objeto Axes.

Ejemplo: xticklabels({'0','\pi','2\pi'})

Ejemplo: xticklabels({'January','February','March'})

Ejemplo: xticklabels({})

Nota

  • Para especificar los valores de marcas, utilice la función xticks.

  • Si no especifica etiquetas suficientes para todos los valores de marcas, MATLAB® utiliza las etiquetas seguidas por vectores de caracteres vacíos para las marcas restantes.

  • Si especifica las etiquetas de marcas como un arreglo categórico, MATLAB utiliza los valores del arreglo, no las categorías.

Ejes objetivo, especificados como objeto Axes o arreglo de objetos Axes.

Si no especifica este argumento, la función xticklabels modifica los ejes actuales.

Argumentos de salida

contraer todo

Etiquetas de marcas actuales, devueltas como arreglo de celdas de vectores de caracteres o arreglo de caracteres.

Modo de etiquetas de marcas actuales, devuelto como uno de estos valores:

  • 'auto': se determinan automáticamente las etiquetas de marcas del eje x.

  • 'manual': se utilizan las etiquetas de marcas del eje x especificadas manualmente.

Más acerca de

contraer todo

Etiquetas de marcas

Las etiquetas de marcas son las etiquetas que ve junto a cada marca de graduación. Los valores de marcas son las ubicaciones a lo largo del eje x en las que aparecen las marcas de graduación. Establezca los valores utilizando la función xticks. Establezca las etiquetas correspondientes utilizando la función xticklabels.

Tick marks appear as short vertical hashes along the x-axis. Tick labels for tick values appear as text directly below each tick mark.

Algoritmos

La función xticklabels establece y consulta varias propiedades de los ejes relacionadas con las etiquetas de marcas del eje x.

  • XTickLabel: propiedad que almacena el texto para las etiquetas de marcas del eje x.

  • XTickLabelMode: propiedad que almacena el modo de las etiquetas de marcas del eje x. Cuando establece las etiquetas de marcas del eje x usando xticklabels, esta propiedad cambia a 'manual'.

  • XTickMode: propiedad que almacena el modo de los valores de marcas del eje x. Cuando establece las etiquetas de marcas del eje x usando xticklabels, esta propiedad cambia a 'manual'.

Historial de versiones

Introducido en R2016b