La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

zlim

Establecer o consultar los límites del eje z

Sintaxis

zlim(limits)

zlim(limitmethod)

zlim(limitmode)

zl = zlim

limmethod = zlim("method")

limmode = zlim("mode")

___ = zlim(ax,___)

Descripción

Especificar los límites

zlim(limits) establece los límites del eje z para los ejes actuales. Especifique limits como vector de dos elementos de la forma [zmin zmax], donde zmax es mayor que zmin.

zlim(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 ZLimitMethod de los ejes en el valor que especifique.

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

zlim(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 ZLimitMethod 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 z en su valor actual.

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

Consultar límites

zl = zlim devuelve los límites actuales como un vector de dos elementos.

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

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

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

Ejemplos

Establecer los límites del eje z

Represente una superficie y establezca los límites del eje z de forma que oscilen entre -5 y 5.

[X,Y,Z] = peaks;
surf(X,Y,Z);
zlim([-5 5])

Utilizar límites de eje z semiautomáticos

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

[X,Y,Z] = peaks;
mesh(X,Y,Z)
zlim([0 inf])

Especificar límites estrictos para el eje z

Cree una gráfica de superficie del conjunto de datos peaks. Ajuste la visualización del cuadro de la gráfica para que pueda ver la superficie desde un lado.

surf(peaks)
view([-45 15])

Ajuste los límites del eje z para que haya menos espacio por encima y por debajo de la superficie. Cambie el método de límite a 'tight'.

zlim tight

Establecer los límites del eje z 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 uno de los ejes. Luego, establezca los límites del eje z para la gráfica inferior especificando ax2 como el primer argumento de entrada a zlim.

[X,Y,Z] = peaks;
tiledlayout(2,1)
ax1 = nexttile;
surf(X,Y,Z)

ax2 = nexttile;
surf(X,Y,Z)
zlim(ax2,[-5 5])

Mantener los límites actuales del eje z

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

En primer lugar, cree un diagrama de dispersión 3D.

theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
scatter3(X,Y,Z)

Establezca el modo de los límites del eje z 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.

zlim manual
hold on 
Znew = 5*theta;
scatter3(X,Y,Znew)
hold off

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

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

zlim auto

Devolver los límites del eje z

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

x = randn(50,1);
y = randn(50,1);
z = randn(50,1);
scatter3(x,y,z)

zl = zlim

zl = 1×2

   -2.1384    4.0000

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 [zmin zmax], donde zmax es mayor que zmin. 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 z.

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

Ejemplo: zlim([-inf 1])

Ejemplo: zlim([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 el ángulo de visualización del cuadro de la gráfica 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 ZLimMode de los ejes se establece en "manual".

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

ax — Ejes objetivo

objeto Axes | arreglo de objetos Axes

Ejes objetivo, especificados como objeto Axes o arreglo de objetos Axes.

Si no se especifica este argumento, zlim establece los límites en el eje actual.

Argumentos de salida

zl — Límites actuales

vector de dos elementos

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

Al consultar los límites, se devuelve el valor de la propiedad ZLim para el objeto Axes 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 z, se devuelve el valor de la propiedad ZLimitMethod 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 z, se devuelve el valor de la propiedad ZLimMode para el objeto Axes correspondiente.

Algoritmos

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

• ZLim: propiedad que almacena los límites del eje z.

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

• ZLimitMethod: propiedad que controla cómo se calculan los límites del eje z cuando la propiedad ZLimMode 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 | xlim | grid | zlabel | zticks | zticklabels | ztickformat

Propiedades

• Axes Properties

Temas

• Especificar los límites de los ejes