axes

Crear ejes cartesianos

contraer todo en la página

Sintaxis

axes
axes(Name,Value)
axes(parent,Name,Value)
ax = axes(___)
axes(cax)

Descripción

axes crea los ejes cartesianos predeterminados en la figura actual y los convierte en los ejes actuales. Habitualmente, no es necesario crear ejes antes de la representación, ya que las funciones gráficas crean ejes automáticamente durante la representación si no existen.

axes(Name,Value) modifica la apariencia de los ejes o controla cómo se muestran los datos utilizando uno o más argumentos de par nombre-valor. Por ejemplo, 'FontSize',14 establece el tamaño de la fuente para el texto de los ejes. Para obtener una lista de las propiedades, consulte Axes Properties.

ejemplo

axes(parent,Name,Value) crea los ejes en la figura, panel o pestaña especificados por parent en lugar de en la figura actual.

ejemplo

ax = axes(___) devuelve el objeto Axes creado. Utilice ax para consultar y modificar las propiedades del objeto Axes después de crearlo. Para obtener una lista de las propiedades, consulte Axes Properties.

axes(cax) establece la propiedad CurrentAxes de la figura principal para que sea cax. Si la propiedad HandleVisibilty de la figura principal está establecida en "on", cax también se convierte en los ejes actuales. Este comando también convierte a cax en el primer objeto enumerado en la propiedad Children del objeto principal. El objeto principal es normalmente una figura o un diseño de gráfica en mosaico.

Ejemplos

contraer todo

Abrir script en vivo

Coloque dos objetos Axes en una figura y añada una gráfica a cada uno.

Especifique la posición del primer objeto Axes para que tenga una esquina inferior izquierda en el punto (0,1 0,1) y un ancho y una altura de 0,7. Especifique la posición del segundo objeto Axes para que tenga una esquina inferior izquierda en el punto (0,65 0,65) y un ancho y una altura de 0,28. De forma predeterminada, los valores se normalizan a la figura. Devuelva los objetos Axes como ax1 y ax2.

figure
ax1 = axes('Position',[0.1 0.1 0.7 0.7]);
ax2 = axes('Position',[0.65 0.65 0.28 0.28]);

Figure contains 2 axes objects. Axes object 1 is empty. Axes object 2 is empty.

Añada una gráfica a cada objeto Axes. Especifique los ejes pasándolos como primer argumento de entrada a la función gráfica. La mayoría de las funciones gráficas restablecen algunas propiedades de los ejes, como los valores de marca y las etiquetas. No obstante, no restablecen la posición de los ejes.

contour(ax1,peaks(20))
surf(ax2,peaks(20))

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

Abrir script en vivo

Cree dos objetos Axes superpuestos. Después, especifique los ejes actuales y añada una gráfica.

Primero, cree dos objetos Axes y especifique las posiciones. Muestre el contorno del cuadro alrededor de cada eje. Devuelva los objetos Axes como ax1 y ax2.

figure
ax1 = axes('Position',[0.1 0.1 .6 .6],'Box','on');
ax2 = axes('Position',[.35 .35 .6 .6],'Box','on');

Figure contains 2 axes objects. Axes object 1 is empty. Axes object 2 is empty.

Convierta ax1 a los ejes actuales. De este modo, los ejes pasan a la parte delantera de la visualización y se convierten en el objetivo para funciones de gráficas posteriores. Añada una gráfica de líneas a los ejes.

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

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

Abrir script en vivo

Cree una figura con dos pestañas. Añada ejes a cada pestaña especificando el contenedor principal para cada uno. Represente una línea en la primera pestaña y una superficie en la segunda pestaña.

figure
tab1 = uitab('Title','Tab1');
ax1 = axes(tab1);
plot(ax1,1:10)

tab2 = uitab('Title','Tab2');
ax2 = axes(tab2);
surf(ax2,peaks)

Figure contains 2 axes objects and another object of type uitabgroup. Axes object 1 contains an object of type surface. Axes object 2 contains an object of type line.

Argumentos de entrada

contraer todo

Contenedor principal, especificado como objeto Figure, Panel, Tab, TiledChartLayout o GridLayout.

Ejes que se desea convertir en los actuales, especificados como un objeto Axes, un objeto PolarAxes, un objeto GeographicAxes o una visualización independiente como heatmap.

Si desea convertir un objeto a los ejes actuales sin cambiar el estado de la figura, establezca la propiedad CurrentAxes de la figura que contiene ese objeto; por ejemplo:

fig = gcf;
fig.CurrentAxes = cax;
Este método es útil si desea que una figura se mantenga minimizada o apilada debajo de otras figuras, pero desea especificar los ejes actuales.

Argumentos de par nombre-valor

contraer todo

Ejemplo: axes('Position',[.3 .3 .5 .5]) establece la posición.

Especifique pares opcionales separados por comas de argumentos Name,Value. Name es el nombre del argumento y Value es el valor correspondiente. Name debe aparecer entre comillas simples (' '). Puede especificar varios argumentos de par nombre-valor como Name1,Value1,...,NameN,ValueN.

Algunas funciones gráficas cambian los valores de las propiedades de los ejes cuando se representan, como los límites de los ejes o los valores de marca. Establezca las propiedades de los ejes después de la representación.

Nota

Las propiedades que se enumeran aquí son solo un subconjunto. Para obtener una lista completa, consulte Axes Properties.

Tamaño y ubicación, excluyendo el margen para las etiquetas, especificados como un vector de cuatro elementos con el formato [left bottom width height]. De forma predeterminada, MATLAB® mide los valores en unidades normalizadas al contenedor. Para cambiar las unidades, establezca la propiedad Units.

  • Los elementos left y bottom definen la distancia desde la esquina inferior izquierda del contenedor (normalmente una figura, panel o pestaña) hasta la esquina inferior izquierda del límite de posición.

  • Los elementos width y height son las dimensiones del límite de posición. Para ejes en una vista 3D, la propiedad Position es el rectángulo más pequeño que encierra los ejes.

Si desea especificar la posición y tener en cuenta el texto alrededor de los ejes, establezca la propiedad OuterPosition en su lugar. Estas figuras muestran las áreas definidas mediante los valores OuterPosition (azul) y los valores Position (rojo).

Vista 2D de los ejesVista 3D de los ejes

2-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box only. The title, axis labels, and tick labels lie outside this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and the axis labels.

3-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box. The title and axis labels lie outside this rectangle. Depending on the orientation of the plot box, some of the tick labels might lie inside or outside of this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and all of the axis labels.

Para obtener más información sobre la posición de los ejes, consulte Controlar el diseño de los ejes.

Nota

  • Cuando se consulta la posición de los ejes que tienen relaciones de aspecto restringidas (como ejes cuadrados o ejes que contienen imágenes), considere utilizar la función tightPosition para una mayor precisión. (Desde la versión R2022b)

  • Establecer esta propiedad no tiene efecto cuando el contenedor principal es un objeto TiledChartLayout.

Tamaño y ubicación, incluyendo etiquetas y margen, especificados como un vector de cuatro elementos con el formato [left bottom width height]. De forma predeterminada, MATLAB mide los valores en unidades normalizadas al contenedor. Para cambiar las unidades, establezca la propiedad Units. El valor predeterminado de [0 0 1 1] incluye todo el interior del contenedor.

  • Los elementos left y bottom definen la distancia desde la esquina inferior izquierda del contenedor (normalmente una figura, panel o pestaña) hasta la esquina inferior izquierda del límite de posición externo.

  • Los elementos width y height son las dimensiones del límite de posición externo.

Estas figuras muestran las áreas definidas mediante los valores OuterPosition (azul) y los valores Position (rojo).

Vista 2D de los ejesVista 3D de los ejes

2-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box only. The title, axis labels, and tick labels lie outside this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and the axis labels.

3-D axes with a title and axis labels. The inner position is outlined in red. It encloses the plot box. The title and axis labels lie outside this rectangle. Depending on the orientation of the plot box, some of the tick labels might lie inside or outside of this rectangle. The outer position is outlined in blue. It encloses the plot box, the title, and all of the axis labels.

Para obtener más información sobre la posición de los ejes, consulte Controlar el diseño de los ejes.

Nota

Establecer esta propiedad no tiene efecto cuando el contenedor principal es un objeto TiledChartLayout.

Unidades de posición, especificadas como uno de estos valores.

UnitsDescripción
"normalized" (valor predeterminado)Normalizadas con respecto al contenedor, que habitualmente es la figura o un panel. La esquina inferior izquierda del contenedor se asigna a (0,0) y la esquina superior derecha, a (1,1).
"inches"Pulgadas.
"centimeters"Centímetros.
"characters"

Se basan en la fuente UIControl predeterminada del objeto raíz de gráficas:

  • Anchura del carácter = anchura de la letra x.

  • Altura del carácter = distancia entre las líneas de referencia de dos líneas de texto.

"points"Puntos tipográficos. Un punto equivale a 1/72 pulgadas.
"pixels"

Píxeles.

En sistemas Windows® y Macintosh, el tamaño de un píxel es de 1/96 de una pulgada. Este tamaño es independiente de la resolución de su sistema.

En sistemas Linux®, la resolución del sistema determina el tamaño de un píxel.

Cuando se especifican las unidades como un par Name,Value durante la creación del objeto, debe establecer la propiedad Units antes de especificar las propiedades para las que desea usar estas unidades, como Position.

Más acerca de

contraer todo

Historial de versiones

Introducido antes de R2006a

Consulte también

Propiedades

Funciones

Temas