yline

Línea horizontal con valor y constante

Sintaxis

yline(y)

yline(y,LineSpec)

yline(y,LineSpec,labels)

yline(___,Name,Value)

yline(ax,___)

yl = yline(___)

Descripción

yline(y) crea una línea horizontal en una o más coordenadas y en los ejes actuales. Por ejemplo, yline(2) crea una línea en y=2.

yline(y,LineSpec) especifica el estilo de línea, el color de línea o ambos. Por ejemplo, yline([12 20 33],'--b') crea tres líneas azules discontinuas.

yline(y,LineSpec,labels) añade etiquetas a las líneas.

yline(___,Name,Value) especifica las propiedades constantes de las líneas con uno o más argumentos de par nombre-valor. Para obtener una lista de las propiedades, consulte ConstantLine Properties. Especifique los pares nombre-valor tras el resto de argumentos de entrada.

yline(ax,___) crea la línea en los ejes especificados en lugar de en los ejes actuales. Para determinar los ejes actuales, utilice gca.

yl = yline(___) devuelve un objeto de ConstantLine o un arreglo de objetos de ConstantLine. Utilice yl para modificar o consultar las propiedades de la línea después de crearla.

Ejemplos

Crear una línea horizontal

Cree una línea horizontal en y = 2.5.

yline(2.5);

Añadir una etiqueta

Para crear una línea con una etiqueta, también debe especificar el estilo de línea. El estilo de línea predeterminado es una línea continua, '-'.

fplot(@(x) log(x));
xlim([0 15]);
ylim([0 4]);
yline(3,'-','Threshold');

Crear varias líneas con etiquetas

Defina un conjunto de vectores x e y y represéntelos. A continuación, rellene el eje y con espacio extra por encima y por debajo de los valores representados máximos y mínimos.

x = 0:0.1:60;
y = 4.*cos(x)./(x+2);
plot(x,y)
ylim padded

Busque los valores máximos y mínimos de y. Cree líneas horizontales en esas ubicaciones con las etiquetas 'Max' y 'Min'.

ymax = max(y);
ymin = min(y);
yline([ymax ymin],'--',{'Max','Min'})

Especificar el color y el estilo de línea

Cree una línea azul de puntos y rayas en y = 4.

yline(4,'-.b');

Especificar el estilo y el grosor de línea, y la alineación de las etiquetas

Cree una línea horizontal discontinua con una etiqueta y un ancho de línea especificado.

x = -2:0.25:2;
[X,Y] = meshgrid(x);
Z = X.*exp(-X.^2-Y.^2);
contour(X,Y,Z,30)

yl = yline(0,'--','y = 0','LineWidth',3);

Cambie la alineación horizontal de la etiqueta y el color de la línea.

yl.LabelHorizontalAlignment = 'center';
yl.Color = [.80 0 .40];

Añadir una línea a ejes específicos

Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 1 por 2. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Después, represente en cada uno de los ejes. Añada una línea horizontal a la primera gráfica pasando ax1 a la función yline.

tiledlayout(1,2)
ax1 = nexttile;
x = -pi/2:pi/60:pi/2;
y1 = tan(sin(x)) + cos(sin(x)); 
plot(ax1,x,y1)

ax2 = nexttile;
x = -pi/2:pi/60:pi/2;
y2 = tan(cos(x)) + exp(x);
plot(ax2,x,y2)

yline(ax1,1.0);

Argumentos de entrada

y — Coordenadas y

escalar | vector

Coordenadas y, especificadas como escalar o vector con valores numéricos, categóricos, de fecha/hora o de duración. El tipo de datos de y debe coincidir con el tipo de datos del eje y.

Ejemplo: yline(10) muestra una línea en y=10.

Ejemplo: yline([13 20 33]) muestra líneas en y=13, y=20 e y=33.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration

LineSpec — Estilo de línea y color

vector de caracteres | escalar de cadena

Estilo de línea y color, especificado como vector de caracteres o escalar de cadena que contiene caracteres y símbolos. Los caracteres y los símbolos pueden aparecer en cualquier orden. Puede especificar el estilo de línea, el color de línea o ambos. Los símbolos de marcador, como 'o', se ignoran.

Ejemplo: '--g' es una línea verde discontinua.

Estilo de línea	Descripción	Línea resultante
"-"	Línea continua
"--"	Línea discontinua
":"	Línea de puntos
"-."	Línea de puntos y rayas

Nombre del color	Nombre corto	Apariencia
'red'	'r'
'green'	'g'
'blue'	'b'
'cyan'	'c'
'magenta'	'm'
'yellow'	'y'
'black'	'k'
'white'	'w'

ax — Ejes objetivo

ejes actuales (predeterminado) | objeto Axes

Ejes objetivo, especificados como objeto Axes. Utilice este argumento si desea que yline se represente en ejes distintos de los ejes actuales.

labels — Etiquetas de línea

'' (predeterminado) | vector de caracteres | escalar de cadena | arreglo de celdas de vectores de caracteres | arreglo de cadenas

Etiquetas de línea, especificadas como vector de caracteres, arreglo de celdas de vectores de caracteres, arreglo de cadenas o arreglo numérico. Para crear una etiqueta multilínea, utilice un arreglo de cadenas o un arreglo de celdas de vectores de caracteres.

Crear una etiqueta para una línea

Especifique un vector de caracteres o un escalar de cadena para mostrar una línea de texto. Para mostrar varias líneas de texto, especifique un arreglo de celdas de vectores de caracteres o un arreglo de cadenas.

Presentación	Cómo especificar labels	Ejemplo
Una línea de texto	Especifique un vector de caracteres o un escalar de cadena.	yline(12,'-','Sample')
Texto multilínea	Especifique un arreglo de celdas de vectores de caracteres o un arreglo de cadenas. Cada elemento del arreglo es una línea de texto distinta.	yline(12,'-',{'Sample','x=12'})

Crear etiquetas para varias líneas

Especifique un vector de caracteres o un escalar de cadena para la misma etiqueta junto a todas las líneas. Especifique un arreglo de celdas de vectores de caracteres o un arreglo de cadenas para mostrar distintas etiquetas para cada línea.

Presentación	Cómo especificar labels	Ejemplo
Una etiqueta de texto compartida	Especifique un vector de caracteres o un escalar de cadena.	yline([13 20 33],'-','Sample')
Etiquetas distintas para cada línea	Especifique un arreglo de celdas de vectores de caracteres o un arreglo de cadenas. Cada elemento del arreglo es una etiqueta para una línea distinta. El número de elementos del arreglo labels debe coincidir con la longitud de x.	label = {'Sample 1','Sample 2','Sample 3'}; yline([13 20 33],'-',label)
Distintas etiquetas con algunas etiquetas multilínea	Cree un arreglo de celdas de vectores de caracteres o un arreglo de cadenas. Utilice la función sprintf para insertar caracteres de línea nueva ('\n') en el texto.	label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'}; yline([13 20 33],'-',label)

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: yline(3,':','Median Price','LabelHorizontalAlignment','center') especifica la alineación horizontal de la etiqueta como 'center'.

Nota

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

Color — Color de línea

[0.15 0.15 0.15] (predeterminado) | Triplete RGB | código de color hexadecimal | 'r' | 'g' | 'b' | ...

Color de línea, especificado como triplete RGB, código de color hexadecimal, nombre de color o nombre corto.

Para definir un color personalizado, especifique un triplete RGB o un código de color hexadecimal.

• Un triplete RGB es un vector fila de tres elementos, cuyos elementos especifican las intensidades de los componentes rojo, verde y azul del color. Las intensidades deben estar en el rango [0,1], por ejemplo [0.4 0.6 0.7].

• Un código de color hexadecimal es un escalar de cadena o un vector de caracteres que comienza con el símbolo de almohadilla (#) seguido de tres o seis dígitos hexadecimales, que pueden oscilar entre 0 y F. Los valores no distinguen entre mayúsculas y minúsculas. Por lo tanto, los códigos de color "#FF8800", "#ff8800", "#F80" y "#f80" son equivalentes.

Como alternativa, puede especificar algunos colores frecuentes por su nombre. En esta tabla se enumeran las opciones de color con su nombre, los tripletes RGB equivalentes y los códigos de color hexadecimales.

Nombre del color	Nombre corto	Triplete RGB	Código de color hexadecimal	Apariencia
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"
"none"	No se aplica	No se aplica	No se aplica	Sin color

A continuación, se indican los tripletes RGB y los códigos de color hexadecimales de los colores predeterminados que MATLAB^® utiliza en muchos tipos de gráficas.

Triplete RGB	Código de color hexadecimal	Apariencia
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

Ejemplo: 'g'

Ejemplo: [0.6 0.2 0.5]

Ejemplo: '#D2F9A7'

LineWidth — Ancho de línea

0.5 (predeterminado) | valor positivo

Ancho de línea, especificado como valor positivo en puntos.

DisplayName — Etiqueta de leyenda

'' (predeterminado) | vector de caracteres | escalar de cadena

Etiqueta de leyenda, especificada como vector de caracteres o escalar de cadena. La leyenda no se muestra hasta que llame al comando legend. Si no especifica el texto, legend establece la etiqueta utilizando la forma 'dataN'.

LabelHorizontalAlignment — Alineación horizontal de la etiqueta

'right' (predeterminado) | 'left' | 'center'

Alineación horizontal de la etiqueta con respecto a la línea, especificada como una de las opciones de la tabla.

Opción	Descripción	Ejemplo
'right'	Lado derecho de la línea
'left'	Lado izquierdo de la línea
'center'	Centro de la línea

LabelVerticalAlignment — Alineación vertical de la etiqueta

'top' (predeterminado) | 'middle' | 'bottom'

Alineación vertical de la etiqueta con respecto a la línea, especificada como una de las opciones de la tabla.

Opción	Descripción	Ejemplo
'top'	Parte superior de la línea
'middle'	Centro de la línea. La etiqueta segmenta la línea
'bottom'	Parte inferior de la línea

LabelOrientation — Orientación de la etiqueta

'aligned' (predeterminado) | 'horizontal'

Orientación de la etiqueta, especificada como 'aligned' o 'horizontal'. En la tabla se muestran ejemplos.

Orientación	Descripción	Ejemplo
'aligned'	La etiqueta tiene la misma orientación que la línea especificada.
'horizontal'	La etiqueta es horizontal, independientemente de la orientación de la línea.

Algoritmos

En una vista 3D de los ejes, la línea constante aparece en el plano x-y en el punto intermedio de los límites del eje z. Si los ejes se rotan, la línea constante rota en consecuencia.

Historial de versiones

Introducido en R2018b

Consulte también

Funciones

• xline | yregion | xregion

Propiedades

• ConstantLine Properties