Main Content

xlim

Establecer o consultar los límites del eje x

Descripción

Especificar los límites

ejemplo

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.

ejemplo

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.

ejemplo

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

ejemplo

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

ejemplo

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

contraer todo

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])

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

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])

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

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])

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

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])

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

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

xlim tight

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

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

Figure contains an axes object. The axes object contains 2 objects 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. 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])

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

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);

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

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

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

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

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

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)

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

xl = xlim
xl = 1×2

    -3     4

Argumentos de entrada

contraer todo

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

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.

ValorDescripciónEjemplo
"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.

Plotted sine wave with 'tickaligned' limit method.

"tight"

Ajusta el cuadro de ejes estrictamente a los datos estableciendo los límites del eje en el rango de los datos.

Plotted sine wave with 'tight' limit method.

"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.

Plotted sine wave with 'padded' limit method.

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.

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.

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

contraer todo

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.

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.

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

expandir todo