xticklabels

Establecer o consultar etiquetas de marcas del eje x

Sintaxis

xticklabels(labels)

xl = xticklabels

xticklabels('auto')

xticklabels('manual')

m = xticklabels('mode')

___ = xticklabels(ax,___)

Descripción

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.

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.

___ = 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

Especificar las etiquetas y los valores de marcas del eje x

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

Mostrar etiquetas de marcas del eje x en términos de pi

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 $$\pi$$.

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

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

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

Especificar las etiquetas de marcas del eje x para ejes específicos

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

Establecer las etiquetas de marcas del eje x en las etiquetas predeterminadas

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

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

Eliminar las etiquetas de marcas del eje x

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({})

Argumentos de entrada

labels — Etiquetas de marcas

arreglo de celdas de vectores de caracteres | arreglo de cadenas | arreglo categórico

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.

ax — Ejes objetivo

objeto Axes | arreglo de objetos Axes

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

xl — Etiquetas de marcas actuales

arreglo de celdas de vectores de caracteres | arreglo de caracteres

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

m — Modo de etiquetas de marcas actuales

'auto' | 'manual'

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

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.

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

Consulte también

Funciones

• xtickformat | xticks | xlim | xsecondarylabel | xtickangle

Propiedades

• Axes Properties

Temas

• Especificar las etiquetas y los valores de marcas del eje