Main Content

annotation

Descripción

ejemplo

annotation(lineType,x,y) crea una anotación de línea o flecha que se extiende entre dos puntos de la figura actual. Especifique lineType como 'line', 'arrow', 'doublearrow' o 'textarrow'. Especifique x e y como vectores de dos elementos con el formato [x_begin x_end] e [y_begin y_end], respectivamente.

annotation(lineType) crea la anotación en la posición predeterminada entre los puntos (0.3,0.3) y (0.4,0.4).

ejemplo

annotation(shapeType,dim) crea una anotación de rectángulo, elipse o cuadro de texto con un tamaño y una ubicación determinados en la figura actual. Especifique shapeType como 'rectangle', 'ellipse' o 'textbox'. Especifique dim como vector de cuatro elementos con el formato [x y w h]. Los elementos x e y determinan la posición, y los elementos w y h determinan el tamaño.

annotation(shapeType) crea la anotación en la posición predeterminada para que la esquina inferior izquierda esté en (0.3,0.3) y la anchura y la altura sean ambas 0.1.

ejemplo

annotation(___,Name,Value) crea la anotación y especifica propiedades como argumentos de par nombre-valor. Distintos tipos de anotaciones admiten diferentes propiedades. Puede especificar propiedades con cualquiera de las combinaciones de argumentos de entrada de las sintaxis anteriores.

annotation(container,___) crea la anotación en la figura, uipanel o uitab, especificada por container en lugar de en la figura actual.

ejemplo

an = annotation(___) devuelve el objeto de anotación. El tipo de objeto devuelto depende del primer argumento de entrada. Utilice an para modificar las propiedades del objeto después de crearlo. Puede especificar un argumento de salida con cualquiera de las sintaxis anteriores.

Ejemplos

contraer todo

Cree una gráfica de líneas simple y añada una flecha de texto a la figura. Especifique la ubicación de la flecha de texto en coordenadas normalizadas de la figura, comenzando en el punto (0.3,0.6) y finalizando en (0.5,0.5). Especifique la descripción de texto estableciendo la propiedad String.

figure
plot(1:10)
x = [0.3 0.5];
y = [0.6 0.5];
annotation('textarrow',x,y,'String','y = x ')

Cree una gráfica de líneas simple y añada una anotación de cuadro de texto a la figura. Especifique la descripción de texto estableciendo la propiedad String. Fuerce que el cuadro se ajuste estrictamente al texto estableciendo la propiedad FitBoxToText en 'on'.

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str,'FitBoxToText','on');

Cree una anotación de cuadro de texto sin establecer la propiedad FitBoxToText. El cuadro de texto utiliza la anchura y la altura especificadas y se reajusta al texto según sea necesario.

figure
plot(1:10)
dim = [.2 .5 .3 .3];
str = 'Straight Line Plot from 1 to 10';
annotation('textbox',dim,'String',str)

Cree una anotación de cuadro de texto con texto multilínea estableciendo la propiedad String en un arreglo de celdas. Cada elemento del arreglo de celdas se muestra en una línea separada. Fuerce que el cuadro se ajuste estrictamente al texto estableciendo la propiedad FitBoxToText en 'on'.

figure
plot(1:10)
dim = [0.2 0.5 0.3 0.3];
str = {'Straight Line Plot','from 1 to 10'};
annotation('textbox',dim,'String',str,'FitBoxToText','on');

Cree una gráfica de puntos y añada una anotación de rectángulo a la figura. Cambie el color del contorno del rectángulo especificando la propiedad Color.

figure
data = [2 4 6 7 8 7 5 2];
stem(data)
dim = [.3 .68 .2 .2];
annotation('rectangle',dim,'Color','red')

Añada una segunda anotación de rectángulo a la figura. Especifique el color de relleno estableciendo la propiedad FaceColor. Añada transparencia estableciendo la propiedad FaceAlpha en un valor entre 0 (completamente transparente) y 1 (completamente opaco).

dim2 = [.74 .56 .1 .1];
annotation('rectangle',dim2,'FaceColor','blue','FaceAlpha',.2)

Cree una gráfica de líneas simple y añada una anotación de elipse a la figura. Especifique dim como el tamaño y la ubicación del rectángulo más pequeño que encierra la elipse.

figure
x = linspace(-4,4);
y = x.^3 - 12*x;
plot(x,y)

dim = [.2 .74 .25 .15];
annotation('ellipse',dim)

Dibuje un rectángulo rojo con las mismas dimensiones para mostrar cómo la elipse rellena el área rectangular.

annotation('rectangle',dim,'Color','red')

Cree una gráfica de líneas simple. A continuación, añada una flecha curvada a la gráfica combinando una anotación de línea y de flecha.

figure
plot(1:10)

xl = [.3 .3];
yl = [.3 .4];
annotation('line',xl,yl)

xa = [.3 .4];
ya = [.4 .4];
annotation('arrow',xa,ya)

Añada una flecha de texto a una figura y devuelva el objeto de flecha de texto de anotación, a.

figure
plot(1:10)
x = [0.3,0.5];
y = [0.6,0.5];
a = annotation('textarrow',x,y,'String','y = x ');

Modifique las propiedades de la flecha de texto de anotación con a. Por ejemplo, cambie el color a rojo y el tamaño de la fuente a 14 puntos.

a.Color = 'red';
a.FontSize = 14;

Consulte las páginas de propiedades de la anotación para ver una lista de propiedades de cada tipo de anotación.

Argumentos de entrada

contraer todo

Tipo de anotación de línea, especificado como uno de estos valores.

ValorTipo de objetoEjemplo
'line'Línea de anotaciónannotation('line',[.1 .2],[.1 .2])
'arrow'Flecha de anotaciónannotation('arrow',[.1 .2],[.1 .2])
'doublearrow'Flecha doble de anotaciónannotation('doublearrow',[.1 .2],[.1 .2])
'textarrow'

Flecha de texto de anotación. Para añadir texto en el origen de la flecha de texto, use la propiedad String.

annotation('textarrow',[.1 .2],[.1 .2],'String','my text')

Tipo de anotación de forma, especificado como uno de estos valores.

ValorTipo de objetoEjemplo
'rectangle'Rectángulo de anotaciónannotation('rectangle',[.2 .3 .4 .5])
'ellipse'Elipse de anotaciónannotation('ellipse',[.2 .3 .4 .5])
'textbox'

Cuadro de texto de anotación. Para especificar el texto, establezca la propiedad String. Para ajustar automáticamente las dimensiones del cuadro de forma que queden ceñidas al texto, establezca la propiedad FitBoxToText en 'on'.

annotation('textbox',[.2 .3 .4 .5],'String','my text','FitBoxToText','on')

Coordenadas x iniciales y finales, especificadas como vector de dos elementos con el formato [x_begin x_end]. Juntos, los argumentos de entrada x e y determinan los puntos finales de la anotación de línea, flecha, flecha doble o flecha de texto. La anotación se extiende desde el punto (x_begin, y_begin) hasta (x_end, y_end).

De forma predeterminada, las unidades se normalizan a la figura. La esquina inferior izquierda de la figura se asigna a (0,0) y la esquina superior derecha a (1,1). Para cambiar las unidades, utilice la propiedad Units.

Ejemplo: x = [.3 .5]

Coordenadas y iniciales y finales, especificadas como vector de dos elementos con el formato [y_begin y_end]. Juntos, los argumentos de entrada x e y determinan los puntos finales de la anotación de línea, flecha, flecha doble o flecha de texto. La anotación se extiende desde el punto (x_begin, y_begin) hasta (x_end, y_end).

De forma predeterminada, las unidades se normalizan a la figura. La esquina inferior izquierda de la figura se asigna a (0,0) y la esquina superior derecha a (1,1). Para cambiar las unidades, utilice la propiedad Units.

Ejemplo: y = [.3 .5]

Tamaño y ubicación, especificados como un vector de cuatro elementos con el formato [x y w h]. Los primeros dos elementos especifican las coordenadas de la esquina inferior izquierda del cuadro de texto, el rectángulo o la elipse con respecto a la esquina inferior izquierda de la figura. Los segundos dos elementos especifican la anchura y la altura de la anotación, respectivamente.

Si crea una elipse, dim es el tamaño y la ubicación del rectángulo más pequeño que encierra la elipse.

De forma predeterminada, las unidades se normalizan a la figura. La esquina inferior izquierda de la figura se asigna a (0,0) y la esquina superior derecha, a (1,1). Para cambiar las unidades, utilice la propiedad Units

Ejemplo: dim = [.3 .4 .5 .6]

Objetivo de la anotación, especificado como un objeto de figura, uipanel o uitab. Por ejemplo, para añadir una anotación a una figura determinada, especifique el objeto de figura como el primer argumento de entrada a la función.

f = figure;
annotation(f,'line',[.1 .2],[.2 .3])

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

En las versiones anteriores a R2021a, utilice comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: annotation('rectangle',[.5 .5 .1 .1],'EdgeColor','r') crea una anotación de rectángulo con un contorno rojo.

Cada tipo de objeto de anotación es compatible con un conjunto de propiedades diferente. Para obtener una lista completa de las propiedades y descripciones de cada tipo, consulte la página de propiedades asociada.

Argumentos de salida

contraer todo

Objeto de anotación, devuelto como escalar. El tipo de objeto de anotación devuelto depende del primer argumento de entrada.

Primer argumento de entradaTipo de objeto devueltoPágina de propiedades
'line'LíneaLine Properties
'arrow'FlechaArrow Properties
'doublearrow'Flecha dobleDoubleEndArrow Properties
'textarrow'Flecha de textoTextArrow Properties
'textbox'Cuadro de textoTextBox Properties
'rectangle'RectánguloRectangle Properties
'ellipse'ElipseEllipse Properties

Más acerca de

contraer todo

Consideraciones sobre compatibilidad

A partir de la versión R2014b, las anotaciones no pueden cruzar los límites de uipanel. En su lugar, se cortan en los límites. Las versiones anteriores de MATLAB® permiten que las anotaciones se extiendan más allá (o fuera de) los límites. Para mostrar una anotación dentro de una figura, uipanel o uitab específico, utilice el argumento de entrada container.

Historial de versiones

Introducido antes de R2006a