Main Content

ylim

Establecer o consultar los límites del eje y

Descripción

Especificar los límites

ejemplo

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

ejemplo

ylim(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 YLimitMethod 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, ylim tight activa límites ajustados a los datos para el eje y.

ejemplo

ylim(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 YLimitMethod 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 y en su valor actual.

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

Consultar límites

ejemplo

yl = ylim devuelve los límites actuales como un vector de dos elementos.

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

limmode = ylim("mode") devuelve el modo de límites del eje y 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

___ = ylim(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, ylim(target,"auto").

Ejemplos

contraer todo

Represente una línea y establezca los límites del eje y de forma que oscilen entre -2 y 2.

x = linspace(0,10);
y = sin(x);
plot(x,y)
ylim([-2 2])

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 y mayores que 0. Especifique el límite mínimo del eje y en 0 y deje que MATLAB elija el límite máximo.

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

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

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

t = datetime(2014,06,1) + caldays(0:20);
y = rand(21,1);
barh(t,y)

tstart = datetime(2014,06,1);
tend = datetime(2014,06,10);
ylim([tstart tend])

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

Cree una gráfica de líneas.

x = 1:5; 
y = [-2.7 2 -1 4.2 0];
plot(x,y)

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

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

ylim tight

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

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

ax2 = nexttile;
plot(ax2,x,y)
ylim(ax2,[-10 10])

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

ylim manual
hold on
y2 = 2*sin(x);
plot(x,y2)
hold off

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

Los límites del eje y 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.

ylim 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 y.

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.

yl =  ylim
yl = 1×2

    -2     3

Argumentos de entrada

contraer todo

Límites mínimos y máximos, especificados como vector de dos elementos de la forma [ymin ymax], donde ymax es mayor que ymin. 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 y.

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: ylim([0 1])

Ejemplo: ylim([-inf 1])

Ejemplo: ylim([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.

Line plot 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.

Line plot 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.

Line plot with "padded" limit method.

Nota

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

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

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 YLimitMethod 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 YLimMode de los ejes en el valor que especifique. Sin embargo, la propiedad YLimMode cambia a "manual" cuando establece los límites del eje y explícitamente, llamando a ylim(limits) o estableciendo el valor de la propiedad YLim en los ejes.

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

  • Un objeto Axes.

  • Una visualización independiente que tiene una propiedad YLimits, como una gráfica heatmap.

  • 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 ylim 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 [ymin ymax].

Al consultar los límites, se devuelve el valor de la propiedad YLim o YLimits 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 y, se devuelve el valor de la propiedad YLimitMethod 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ímites del eje y, se devuelve el valor de la propiedad YLimMode para el objeto Axes correspondiente.

Algoritmos

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

  • YLim: propiedad que almacena los límites del eje y.

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

  • YLimitMethod: propiedad que controla cómo se calculan los límites del eje y cuando la propiedad YLimMode se establece en "auto".

Historial de versiones

Introducido antes de R2006a

expandir todo