ylim

Establecer o consultar los límites del eje y

Sintaxis

ylim(limits)

ylim(limitmethod)

ylim(limitmode)

yl = ylim

limmethod = ylim("method")

limmode = ylim("mode")

___ = ylim(target,___)

Descripción

Especificar los límites

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.

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.

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

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

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

Establecer los límites del eje y

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

Utilizar límites semiautomáticos para el eje y

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

Establecer los límites para el eje y con fechas

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

Especificar límites estrictos para el eje y

Cree una gráfica de líneas.

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

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

ylim tight

Establecer los límites del eje y 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 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])

Mantener los límites actuales del eje y

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)

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

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

Devolver los límites del eje y

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)

yl =  ylim

yl = 1×2

    -2     3

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 [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

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 YLimMode de los ejes se establece en "manual".

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

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

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

yl — Límites actuales

vector de dos elementos

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.

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 y, se devuelve el valor de la propiedad YLimitMethod 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í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

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

• xlim | zlim | grid | ylabel | yticks | yticklabels | ytickformat

Propiedades

• Axes Properties

Temas

• Especificar los límites de los ejes