axis

Establecer límites del eje y relaciones de aspecto

Sintaxis

axis(limits)

axis style

axis mode

axis ydirection

axis visibility

lim = axis

lim = axis(ax)

Descripción

Definir los límites y la relación de aspecto

axis(limits) especifica los límites de los ejes actuales. Especifique los límites como vector de cuatro, seis u ocho elementos.

axis style utiliza un estilo predefinido para establecer los límites y el escalado. Por ejemplo, especifique el estilo como equal para utilizar longitudes de unidades de datos iguales a lo largo de cada eje.

axis mode determina si MATLAB^® selecciona de forma automática los límites o no. Especifique el modo como manual, auto o una de las opciones semiautomáticas, tales como 'auto x'.

axis ydirection, donde ydirection es ij, sitúa el origen en la esquina superior izquierda de los ejes. Los valores y aumentan de arriba abajo. El valor predeterminado para ydirection es xy, que sitúa el origen en la esquina inferior izquierda. Los valores y aumentan de abajo arriba.

axis visibility, donde visibility es off, desactiva la visualización del fondo de los ejes. Las gráficas de los ejes se siguen visualizando. El valor predeterminado para visibility es on, que muestra el fondo de los ejes.

Obtener límites

lim = axis devuelve los límites del eje x y del eje y para los ejes actuales. Para los ejes 3D, también devuelve los límites del eje z. Para los ejes polares, devuelve los límites del eje theta y del eje r.

lim = axis(ax) devuelve los límites de los ejes especificados por ax en lugar de los ejes actuales.

Ejemplos

Establecer límites del eje

Represente la función seno.

x = linspace(0,2*pi);
y = sin(x);
plot(x,y,'-o')

Cambie los límites del eje de forma que el eje x oscile entre $$0$$ y $$2\pi$$ y de forma que el eje y oscile entre -1,5 y 1,5.

axis([0 2*pi -1.5 1.5])

Añadir relleno alrededor de una gráfica de escalones

Cree una gráfica de escalones y utilice el comando axis padded para añadir un margen de relleno entre la gráfica y el cuadro de la gráfica.

x = 0:12;
y = sin(x);
stairs(x,y)
axis padded

Utilizar límites de eje semiautomáticos

Cree una gráfica. Establezca los límites para el eje x y establezca el límite mínimo del eje y. Utilice un valor calculado de forma automática para el límite máximo del eje x.

x = linspace(-10,10,200);
y = sin(4*x)./exp(.1*x);
plot(x,y)
axis([-10 10 0 inf])

Establecer límites del eje para múltiples ejes

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. Después, establezca los límites del eje para ambos ejes en los mismos valores.

tiledlayout(2,1)
x1 = linspace(0,10,100);
y1 = sin(x1);
ax1 = nexttile;
plot(ax1,x1,y1)

x2 = linspace(0,5,100);
y2 = sin(x2);
ax2 = nexttile;
plot(ax2,x2,y2)

axis([ax1 ax2],[0 10 -1 1])

Mostrar una gráfica sin fondo de ejes

Represente una superficie sin mostrar las líneas de los ejes ni el fondo.

surf(peaks)
axis off

Utilizar límites estrictos del eje y valores de retorno

Represente una superficie. Establezca los límites del eje de forma que sean iguales al rango de los datos, de modo que la gráfica se extienda a los bordes de los ejes.

surf(peaks)
axis tight

Devuelva los valores de los límites actuales del eje.

l = axis

l = 1×6

    1.0000   49.0000    1.0000   49.0000   -6.5466    8.0752

Cambiar la dirección del sistema de coordenadas

Cree una gráfica de damero y cambie la dirección del sistema de coordenadas.

En primer lugar, cree la gráfica utilizando el mapa de colores summer. De forma predeterminada, los valores x aumentan de izquierda a derecha y los valores y aumentan de abajo arriba.

C = eye(10);
pcolor(C)
colormap summer

Invierta el sistema de coordenadas, de manera que los valores y aumenten de arriba abajo.

axis ij

Conservar los límites actuales del eje cuando se añaden gráficas nuevas

Represente una onda sinusoidal.

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

Añada otra onda sinusoidal a los ejes utilizando hold on. Mantenga los límites actuales del eje estableciendo el modo de los límites en manual.

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

Si desea que los ejes elijan límites adecuados, vuelva a establecer el modo de los límites en automático.

axis auto

Argumentos de entrada

limits — Límites del eje

vector de cuatro elementos | vector de seis elementos | vector ocho elementos

Límites del eje, especificados como vector de cuatro, seis u ocho elementos.

Para ejes cartesianos, especifique los límites de una de las siguientes formas:

• [xmin xmax ymin ymax]: establezca los límites del eje x de forma que oscilen entre xmin y xmax. Establezca los límites del eje y de forma que oscilen entre ymin e ymax.

• [xmin xmax ymin ymax zmin zmax]: establezca también los límites del eje z de forma que oscilen entre zmin y zmax.

• [xmin xmax ymin ymax zmin zmax cmin cmax]: establezca también los límites de color. cmin es el valor de datos que se corresponde con el primer color del mapa de colores. cmax es el valor de datos que se corresponde con el último color del mapa de colores.

Las propiedades XLim, YLim, ZLim y CLim del objeto Axes guardan los valores de los límites.

Para los ejes polares, especifique los límites de esta forma:

• [thetamin thetamax rmin rmax]: establezca los límites del eje theta para que oscilen entre thetamin y thetamax. Establezca los límites del eje r de forma que oscilen entre rmin y rmax.

Las propiedades ThetaLim y RLim del objeto PolarAxes guardan los valores de los límites.

Para los límites parcialmente automáticos, utilice inf o -inf para los límites que desea que los ejes elijan de forma automática. Por ejemplo, axis([-inf 10 0 inf]) permite que los ejes elijan el límite mínimo del eje x y el límite máximo del eje y adecuados. Utiliza los valores especificados para el límite máximo del eje x y para el límite mínimo del eje y.

Nota

Si el eje x, el eje y o el eje z muestran valores categóricos, de fecha/hora o de duración, utilice en su lugar las funciones xlim, ylim y zlim para establecer los límites.

Ejemplo: axis([0 1 0 1])

Ejemplo: axis([0 1 0 1 0 1])

Ejemplo: axis([0 inf 0 inf])

mode — Selección manual, automática o semiautomática de los límites del eje

manual | auto | 'auto x' | 'auto y' | 'auto z' | 'auto xy' | 'auto xz' | 'auto yz'

Selección manual, automática o semiautomática de los límites del eje, especificada como uno de los valores de esta tabla. Todos los valores del modo automático utilizan el tickaligned style para calcular los límites del eje o del conjunto de ejes concretos que especifica.

Valor	Descripción	Propiedades del eje que se modifican
manual	Congela todos los límites del eje en sus valores actuales.	Establece XLimMode, YLimMode y ZLimMode en 'manual'. Si trabaja con ejes polares, esta opción establece ThetaLimMode y RLimMode en 'manual'.
auto	Elige de forma automática todos los límites del eje.	Establece XLimMode, YLimMode y ZLimMode en 'auto'. Si trabaja con ejes polares, esta opción establece ThetaLimMode y RLimMode en 'auto'.
'auto x'	Elige de forma automática los límites del eje x.	Establece XLimMode en 'auto'.
'auto y'	Elige de forma automática los límites del eje y.	Establece YLimMode en 'auto'.
'auto z'	Elige de forma automática los límites del eje z.	Establece ZLimMode en 'auto'.
'auto xy'	Elige de forma automática los límites del eje x y los límites del eje y.	Establece XLimMode y YLimMode en 'auto'.
'auto xz'	Elige de forma automática los límites del eje x y los límites del eje z.	Establece XLimMode y ZLimMode en 'auto'.
'auto yz'	Elige de forma automática los límites del eje y y los límites del eje z.	Establece YLimMode y ZLimMode en 'auto'.

Nota

No puede utilizar estas opciones con ejes polares.

style — Límites del eje y escalado

tight | padded | fill | equal | image | square | vis3d | normal

Límites del eje y escalado, especificados como uno de estos valores.

Valor	Descripción	Propiedades del eje que se modifican
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.	XLimMode, YLimMode y ZLimMode cambian a 'auto'. XLimitMethod, YLimitMethod y ZLimitMethod cambian a 'tickaligned'. XLim, YLim y ZLim se actualizan de forma automática para incorporar los datos nuevos que se añaden a los ejes. Para evitar que los límites cambien cuando se utiliza hold on, use axis tickaligned manual.
tight	Ajusta el cuadro de ejes estrictamente a los datos estableciendo los límites del eje como igual al rango de los datos.	XLimMode, YLimMode y ZLimMode cambian a 'auto'. Si trabaja con ejes polares, ThetaLimMode y RLimMode cambian. XLimitMethod, YLimitMethod y ZLimitMethod cambian a 'tight'. XLim, YLim y ZLim se actualizan de forma automática para incorporar los datos nuevos que se añaden a los ejes. Para evitar que los límites cambien cuando se utiliza hold on, use axis tight manual.
padded	Ajusta el cuadro de ejes alrededor de los datos con un margen estrecho de relleno en todos los lados. La anchura del margen es aproximadamente del 7% del rango de los datos.	XLimMode, YLimMode y ZLimMode cambian a 'auto'. XLimitMethod, YLimitMethod y ZLimitMethod cambian a 'padded'. XLim, YLim y ZLim se actualizan de forma automática para incorporar los datos nuevos que se añaden a los ejes. Para evitar que los límites cambien cuando se utiliza hold on, use axis padded manual.
equal	Utiliza la misma longitud para las unidades de datos a lo largo de cada eje. equal no es compatible con gráficas creadas con yyaxis.	Establece DataAspectRatio en [1 1 1] y establece DataAspectRatioMode y PlotBoxAspectRatioMode en 'manual'. Para vistas 2D, también establece XLimMode e YLimMode debidamente, de forma que el eje llene el espacio asignado en la figura principal o en otro contenedor. Para vistas 3D, XLimMode, YLimMode y ZLimMode se establecen en 'auto', y XLimitMethod YLimitMethod y ZLimitMethod se establecen en 'tight'. Este estilo desactiva el comportamiento "expandir a relleno" predeterminado.
image	Utiliza la misma longitud para las unidades de datos a lo largo de cada eje y ajusta el cuadro de ejes estrictamente alrededor de los datos. image no es compatible con gráficas creadas con yyaxis.	Establece DataAspectRatio en [1 1 1], DataAspectRatioMode en 'manual' y PlotBoxAspectRatioMode en 'auto'. También establece XLimMode, YLimMode y ZLimMode en 'auto', y XLimitMethod, YLimitMethod y ZLimitMethod en 'tight'. Este estilo desactiva el comportamiento "expandir a relleno" predeterminado.
square	Utiliza líneas del eje con longitudes iguales. Ajuste los incrementos entre unidades de datos en consecuencia.	Establece PlotBoxAspectRatio en [1 1 1] y establece la propiedad de modo asociada en manual. Este estilo desactiva el comportamiento "expandir a relleno" predeterminado.
fill	Habilita el comportamiento "expandir a relleno" (valor predeterminado). Las longitudes de cada línea del eje llenan el rectángulo de posición que se define en la propiedad Position de los ejes.	Establece DataAspectRatioMode y PlotBoxAspectRatioMode en 'auto'.
vis3d	Congela las propiedades de la relación de aspecto. vis3d no es compatible con gráficas creadas con yyaxis.	Establece DataAspectRatioMode, PlotBoxAspectRatioMode y CameraViewAngleMode en 'manual'.
normal	Restablece el comportamiento predeterminado.	Establece DataAspectRatioMode y PlotBoxAspectRatioMode en 'auto'.

Para obtener más información sobre la relación de aspecto del cuadro de la gráfica y sobre la relación de aspecto de los datos, consulte las propiedades PlotBoxAspectRatio y DataAspectRatio.

Nota

No puede utilizar estas opciones con ejes polares, excepto con los comandos axis tight y axis normal.

ydirection — Dirección del eje y

xy (predeterminado) | ij

Dirección del eje y, especificada como uno de estos valores:

• xy: dirección predeterminada. Para ejes en una vista 2D, el eje y es vertical y los valores aumentan de abajo arriba.

• ij: dirección inversa. Para ejes en una vista 2D, el eje y es vertical y los valores aumentan de arriba abajo.

Nota

No puede utilizar estas opciones con ejes polares.

visibility — Visibilidad de las líneas de los ejes y del fondo

"on" | "off" | true o 1 | false o 0 | Valor OnOffSwitchState

Visibilidad de las líneas de los ejes y del fondo, especificada como cualquiera de estos valores:

• "on" u "off": un valor de "on" muestra las líneas de los ejes y del fondo, y "off" las oculta. También puede especificar los vectores de caracteres 'on' u 'off'.

• 1 (true) o 0 (false) numérico o lógico: un valor de 1 o true muestra las líneas de los ejes y del fondo, y 0 o false las oculta. (desde R2024a)

• Un valor de matlab.lang.OnOffSwitchState: un valor de matlab.lang.OnOffSwitchState.on muestra las líneas de los ejes y del fondo, y matlab.lang.OnOffSwitchState.off las oculta. (desde R2024a)

Nota

Use paréntesis para especificar 1, 0, true, false o un valor de OnOffSwitchState. Por ejemplo, axis(0) y axis(false) ocultan los ejes.

Los paréntesis son opcionales para los valores "on" y "off". Por ejemplo, axis off oculta los ejes.

Cuando se especifica la visibilidad, se establece la propiedad Visible del objeto Axes o del objeto PolarAxes en el valor especificado.

ax — Ejes objetivo

uno o más ejes

Ejes objetivo, especificados como uno o más ejes. Puede especificar objetos Axes u objetos PolarAxes. Si no especifica los ejes, axis establece los límites para los ejes actuales (gca).

Cuando especifique los ejes, utilice comillas simples alrededor de otros argumentos de entrada que son vectores de caracteres.

Ejemplo: axis(ax,'tight')

Ejemplo: axis(ax,limits)

Ejemplo: axis(ax,'manual')

Argumentos de salida

lim — Valores de límites actuales

vector de cuatro elementos | vector de seis elementos

Valores de límites actuales, devueltos como vector de cuatro elementos o vector de seis elementos.

• Para ejes cartesianos en una vista 2D, lim tiene el formato [xmin xmax ymin ymax]. Para ejes en una vista 3D, lim tiene el formato [xmin xmax ymin ymax zmin zmax]. Las propiedades XLim, YLim y ZLim del objeto Axes guardan los valores de los límites.

• Para ejes polares, lim tiene el formato [thetamin thetamax rmin rmax]. Las propiedades ThetaLim y RLim del objeto PolarAxes guardan los valores de los límites.

Sugerencias

• Puede combinar múltiples argumentos de entrada, por ejemplo, axis image ij. Las opciones se evalúan de izquierda a derecha. Las opciones posteriores pueden sobrescribir las propiedades que han establecido las anteriores.

• Si no existen ejes, la función axis los crea.

• Utilice hold on para evitar que las funciones de representación anulen los límites predeterminados del eje.

Historial de versiones

Introducido antes de R2006a

R2024b: Consultar el modo de selección de límites, la visibilidad y la dirección del eje y ya no se admite

Esta sintaxis, que devuelve el modo de selección de límites del eje (m), la visibilidad (v) y la dirección del eje y (d) ya no se admite y devuelve un error.

[m,v,d] = axis('state')

Puede obtener la misma información consultando estas propiedades de Axes.

• Modo de selección de límites del eje: propiedades XLimMode, YLimMode y ZLimMode

• Visibilidad: propiedad Visible

• Dirección del eje x e y: propiedades XDir e YDir

Este cambio se anunció en la versión R2015a.

R2024a: Mostrar u ocultar ejes especificando un valor lógico o de OnOffSwitchState

Muestre u oculte los ejes especificando el argumento de entrada visibility como un valor lógico o como un valor de matlab.lang.OnOffSwitchState. Los valores 1 y true equivalen a "on", y 0 y false equivalen a "off".

Los valores "on" y "off" siguen siendo admitidos.

Consulte también

Funciones

• xlim | ylim | zlim | tiledlayout | nexttile | title | grid

Propiedades

• Axes Properties | PolarAxes Properties

Temas

• Especificar los límites de los ejes
• Controlar el la relación de las longitudes del eje y de la unidad de datos