xlim

Establecer o consultar los límites del eje x

Sintaxis

xlim(limits)

xlim(limitmethod)

xlim(limitmode)

xl = xlim

limmethod = xlim("method")

limmode = xlim("mode")

___ = xlim(target,___)

Descripción

Especificar los límites

xlim(limits) establece los límites del eje x para los ejes o la gráfica actuales. Especifique limits como vector de dos elementos de la forma [xmin xmax], donde xmax es mayor que xmin.

xlim(limitmethod) especifica el método de límite que MATLAB^® utiliza para la selección automática del límite. Especifique el método de límite como "tickaligned", "tight" o "padded". MATLAB establece la propiedad XLimitMethod de los ejes en el valor que especifique. Las visualizaciones independientes no admiten el método de límite.

Puede especificar el argumento limitmethod sin paréntesis. Por ejemplo, xlim tight activa límites ajustados a los datos para el eje x.

xlim(limitmode) especifica la selección automática o manual del límite. limitmode puede tener uno de estos dos valores:

• "auto": permite la selección automática de los límites. MATLAB selecciona los límites basándose en el rango de datos y en el valor de la propiedad XLimitMethod de los ejes. Si representa en los ejes varias veces, los límites se actualizan para abarcar todos los datos.

• "manual": congela los límites del eje x en su valor actual.

Puede especificar el argumento limitmode sin paréntesis. Por ejemplo, xlim auto activa la selección automática de límites.

Consultar límites

xl = xlim devuelve los límites actuales como un vector de dos elementos.

limmethod = xlim("method") devuelve el método de límite del eje x actual, que puede ser 'tickaligned', 'tight' o 'padded'.

limmode = xlim("mode") devuelve el modo de los límites del eje x actual, que puede ser 'auto' o 'manual'. De forma predeterminada, el modo es el automático, salvo que especifique límites o establezca el modo en manual.

Especificar ejes o gráfica objetivo

___ = xlim(target,___) utiliza los ejes o la visualización independiente que especifica target en lugar de los ejes actuales. Especifique target como primer argumento de entrada para cualquiera de las sintaxis anteriores. Puede incluir un argumento de salida si la sintaxis original admite un argumento de salida. Utilice comillas para encerrar las entradas de modo; por ejemplo, xlim(target,"auto").

Ejemplos

Establecer los límites del eje x

Represente una línea y establezca los límites del eje x de forma que oscilen entre 0 y 5.

x = linspace(0,10);
y = sin(x);
plot(x,y)
xlim([0 5])

Utilizar límites semiautomáticos para el eje x

Cree una gráfica de superficie y muestre solo los valores de x mayores que 0. Especifique el límite mínimo del eje x en 0 y deje que MATLAB elija el límite máximo.

[X,Y,Z] = peaks;
surf(X,Y,Z)
xlim([0 inf])

Establecer los límites para el eje x con fechas

Cree una gráfica de puntos con fechas a lo largo del eje x. Establezca los límites del eje x de forma que oscilen entre el 1 de junio de 2014 y el 5 de junio de 2014.

t = datetime(2014,06,1) + caldays(0:10);
y = rand(11,1);
stem(t,y,'filled')

tstart = datetime(2014,06,1);
tend = datetime(2014,06,5);
xlim([tstart tend])

Especificar límites estrictos para el eje x

Si quiere que el eje x se ajuste automáticamente para que coincida con el rango de sus coordenadas x, utilice el método de límite 'tight'.

Cree una gráfica de líneas.

plot([1 2 3 4 5 6.3],[0 0.3 0.1 0.6 0.4 1])

Cambie el método de límite a 'tight'.

xlim tight

Añada otra gráfica a los ejes. Los límites del eje x se ajustan para abarcar el rango de los nuevos datos.

hold on
plot([1 2 3 4 5 8.3],[0.1 0.2 0.3 0.4 0.5 0.83])
hold off

Establecer los límites 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. Represente datos en cada eje. Luego, establezca los límites del eje x para la gráfica inferior especificando ax2 como el primer argumento de entrada a la función xlim.

tiledlayout(2,1)
x = linspace(0,5,1000);
y = sin(100*x)./exp(x);
ax1 = nexttile;
plot(ax1,x,y)

ax2 = nexttile;
plot(ax2,x,y)
xlim(ax2,[0 1])

Mantener los límites actuales del eje x

Utilice el modo manual para mantener los límites actuales del eje x cuando añada más gráficas a los ejes.

Primero, represente una línea.

x = linspace(0,10);
y = sin(x);
plot(x,y);

Establezca el modo de los límites del eje x en manual para que los límites no cambien. Utilice la función hold on para añadir una segunda gráfica a los ejes.

xlim manual
hold on
plot(2*x,2*y)
hold off

Los límites del eje x no se actualizan para incorporar la nueva gráfica.

Vuelva a los límites actualizados automáticamente volviendo a establecer el modo en automático.

xlim auto

Devolver los límites del eje x

Cree un diagrama de dispersión de datos aleatorios. Devuelva los valores de los límites del eje x.

x = randn(50,1);
y = randn(50,1);
scatter(x,y)

xl = xlim

xl = 1×2

    -3     4

Argumentos de entrada

limits — Límites mínimos y máximos

vector de dos elementos

Límites mínimos y máximos, especificados como vector de dos elementos de la forma [xmin xmax], donde xmax es mayor que xmin. Puede especificar los límites como valores numéricos, categóricos, de fecha/hora o de duración. Sin embargo, el tipo de valores que especifique debe coincidir con el tipo de valores a lo largo del eje x.

Puede especificar ambos límites o especificar un límite y dejar que MATLAB calcule automáticamente el otro. Para un límite mínimo o máximo calculado automáticamente, utilice -inf o inf respectivamente. MATLAB utiliza el método de límite "tight" para calcular el límite correspondiente.

Ejemplo: xlim([0 1])

Ejemplo: xlim([-inf 1])

Ejemplo: xlim([0 inf])

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

limitmethod — Método de selección de los límites

"tickaligned" (predeterminado) | "padded" | "tight"

Método de selección de los límites, especificado como uno de los valores de la tabla.

Los ejemplos de la tabla muestran la apariencia aproximada para cada método. Sus resultados podrían diferir en función de sus datos, el tamaño de los ejes y el tipo de gráfica que cree.

Valor	Descripción	Ejemplo
"tickaligned"	En general, alinea los bordes del cuadro de ejes con las marcas de graduación que están más cerca de los datos sin excluir ningún dato. El aspecto puede variar según el tipo de datos que represente y el tipo de gráfica que cree.
"tight"	Ajusta el cuadro de ejes estrictamente a los datos estableciendo los límites del eje en el rango de los datos.
"padded"	Ajusta el cuadro de ejes alrededor de los datos con un margen estrecho de relleno en cada lado. La anchura del margen es aproximadamente del 7% del rango de los datos.

Nota

• El método de límite no tiene efecto cuando la propiedad XLimMode de los ejes se establece en "manual".

• Las visualizaciones independientes como heatmap o stackedplot no admiten la especificación del método de límite.

limitmode — Modo de límite

"auto" | "manual"

Modo de límite, especificado como uno de los siguientes valores:

• "auto": permite la selección automática de los límites, que se basa en el rango total de los datos y en el valor de la propiedad XLimitMethod de los ejes. Si representa en los ejes varias veces, los límites se actualizan para abarcar todos los datos. Puede utilizar esta opción si cambia los límites y desea volver a establecer los valores predeterminados.

• "manual": congela los límites en los valores actuales. Utilice esta opción si desea mantener los límites actuales cuando añada datos nuevos a los ejes utilizando el comando hold on.

Cuando especifica este argumento, MATLAB establece la propiedad XLimMode de los ejes en el valor que especifique. Sin embargo, la propiedad XLimMode cambia a "manual" cuando establece los límites del eje x explícitamente, llamando a xlim(limits) o estableciendo el valor de la propiedad XLim en los ejes.

target — Ejes o gráfica objetivo

objeto de ejes | visualización independiente | arreglo de ejes o visualizaciones independientes

Ejes o gráfica objetivo, especificados como una de las siguientes opciones:

• Un objeto de ejes.

• Una visualización independiente que tiene una propiedad XLimits, como una gráfica heatmap o la función stackedplot.

• Un arreglo de ejes o visualizaciones independientes que pertenecen a la misma clase. Para determinar la clase, use la función class.

Si no se especifica este argumento, la función xlim establece los límites en el objeto de gráficas devuelto por el comando gca.

Argumentos de salida

xl — Límites actuales

vector de dos elementos

Límites actuales, devueltos como vector de dos elementos de la forma [xmin xmax].

Al consultar los límites, se devuelve el valor de la propiedad XLim o XLimits para el objeto Axes o de gráficas correspondiente.

limmethod — Método de límites actual

'tickaligned' | 'tight' | 'padded'

Método de límites actual, devuelto como uno de estos valores:

• 'tickaligned': en general, alinea los bordes del cuadro de ejes con las marcas de graduación que están más cerca de los datos sin excluir ningún dato. El aspecto puede variar según el tipo de datos que represente y el tipo de gráfica que cree.

• 'tight': ajusta el cuadro de ejes estrictamente a los datos estableciendo los límites del eje en el rango de los datos.

• 'padded': ajusta el cuadro de ejes alrededor de los datos con un margen estrecho de relleno en cada lado. La anchura del margen es aproximadamente del 7% del rango de los datos.

Al consultar el método de límites del eje x, se devuelve el valor de la propiedad XLimitMethod para el objeto Axes correspondiente.

limmode — Modo de los límites actual

'auto' | 'manual'

Modo de los límites actual, devuelto como uno de estos valores:

• 'auto': determina automáticamente los límites.

• 'manual': utiliza límites especificados manualmente que no se actualizan para reflejar los cambios en los datos.

Al consultar el modo de límite del eje x, se devuelve el valor de la propiedad XLimMode para el objeto Axes correspondiente.

Algoritmos

La función xlim establece y consulta varias propiedades de los ejes relacionadas con los límites del eje x.

• XLim: propiedad que almacena los límites del eje x.

• XLimMode: propiedad que almacena el modo de los límites del eje x. Cuando establece los límites del eje x, esta propiedad cambia a "manual".

• XLimitMethod: propiedad que controla cómo se calculan los límites del eje x cuando la propiedad XLimMode se establece en "auto".

Historial de versiones

Introducido antes de R2006a

R2022a: Consultar el método de límite del eje

Consulte el método actual de límite del eje utilizando el argumento de entrada "method".

R2021a: Establecer el método de límite del eje

Establezca el método que MATLAB utiliza para la selección automática del límite especificando el argumento limitmethod. El argumento puede tener el valor 'tickaligned', 'tight' o 'padded'.

Consulte también

Funciones

• ylim | zlim | grid | xlabel | xticks | xticklabels | xtickformat

Propiedades

• Axes Properties

Temas

• Especificar los límites de los ejes