annotation

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

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.

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.

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

Crear una anotación de flecha de texto

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

Crear una anotación de cuadro de texto

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)

Crear una anotación de cuadro de texto con texto multilínea

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');

Crear una anotación de rectángulo

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)

Crear una anotación de elipse

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

Combinar dos tipos de anotaciones

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)

Modificar una anotación después de crearla

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

`lineType` — Tipo de anotación de línea
`'line'` | `'arrow'` | `'doublearrow'` | `'textarrow'`

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

Valor	Tipo de objeto	Ejemplo
`'line'`	Línea de anotación	`annotation('line',[.1 .2],[.1 .2])`
`'arrow'`	Flecha de anotación	`annotation('arrow',[.1 .2],[.1 .2])`
`'doublearrow'`	Flecha doble de anotación	`annotation('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')`

`shapeType` — Tipo de anotación de forma
`'rectangle'` | `'ellipse'` | `'textbox'`

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

Valor	Tipo de objeto	Ejemplo
`'rectangle'`	Rectángulo de anotación	`annotation('rectangle',[.2 .3 .4 .5])`
`'ellipse'`	Elipse de anotación	`annotation('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')`

`x` — Coordenadas x iniciales y finales
vector de dos elementos con el formato `[x_begin x_end]`

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]

`y` — Coordenadas y iniciales y finales
vector de dos elementos con el formato `[y_begin y_end]`

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

Ejemplo: y = [.3 .5]

`dim` — Tamaño y ubicación
vector de cuatro elementos con el formato `[x y w h]`

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]

`container` — Objetivo de la anotación
objeto de figura | objeto uipanel | objeto uitab

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

`an` — Objeto de anotación
escalar

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

Primer argumento de entrada	Tipo de objeto devuelto	Página de propiedades
`'line'`	Línea	Line Properties
`'arrow'`	Flecha	Arrow Properties
`'doublearrow'`	Flecha doble	DoubleEndArrow Properties
`'textarrow'`	Flecha de texto	TextArrow Properties
`'textbox'`	Cuadro de texto	TextBox Properties
`'rectangle'`	Rectángulo	Rectangle Properties
`'ellipse'`	Elipse	Ellipse Properties

Más acerca de