xline

Línea vertical con valor x constante

Sintaxis

xline(x)

xline(x,LineSpec)

xline(x,LineSpec,labels)

xline(___,Name,Value)

xline(ax,___)

xl = xline(___)

Descripción

xline(x) crea una línea vertical en una o más coordenadas x de los ejes actuales. Por ejemplo, xline(2) crea una línea en x=2.

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

xline(x,LineSpec,labels) añade etiquetas a las líneas.

xline(___,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.

xline(ax,___) crea las líneas en los ejes especificados en lugar de en los ejes actuales.

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

Ejemplos

Crear una línea vertical

Cree una línea vertical en x = 3.

xline(3);

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, '-'.

x = linspace(0,6,100);
y = exp(x);
plot(x,y)
xline(4.5,'-',{'Acceptable','Limit'});

Crear varias líneas con etiquetas

Cree un vector de números aleatorios distribuidos de manera normal y muéstrelos en un histograma. A continuación, cree tres líneas verticales con etiquetas en el valor promedio, una desviación estándar por debajo del promedio y una desviación estándar por encima del promedio.

data = 5 * randn(1,500) + 20;
histogram(data,'FaceAlpha',0.1,'EdgeAlpha',0.1);
m = mean(data);
s = std(data);
xline([m-s m m+s],'-',{'-1 Standard Dev.','Average','+1 Standard Dev.'})

Especificar el color y el estilo de línea

Cree una línea discontinua roja en x = 5.

xline(5,'--r');

Añadir una leyenda y especificar la alineación de la etiqueta

Cree una línea vertical de puntos y rayas con una etiqueta y un nombre de visualización para una leyenda.

y = [3187 2693 1771 1826 1958 3222 1645];
barh(y,'DisplayName','Daily Sales')
xl = xline(2328,'-.','Average','DisplayName','Average Sales');

Ajuste la alineación vertical y horizontal de la etiqueta, y muestre la leyenda.

xl.LabelVerticalAlignment = 'middle';
xl.LabelHorizontalAlignment = 'center';
legend('show');

Añadir líneas a ejes diferentes

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. Después, represente en cada uno de los ejes. Agregue una línea vertical de puntos y una etiqueta a cada gráfica pasando los ejes a la función xline.

tiledlayout(2,1)
ax1 =nexttile;
x = linspace(0,10,200);
y1 = cos(x); 
plot(ax1,x,y1)

ax2 = nexttile;
y2 = sin(x); 
plot(ax2,x,y2)

xline(ax1,pi/2,':','cos(\pi/2)=0');
xline(ax2,pi,':','sin(\pi)=0');

Argumentos de entrada

x — Coordenadas x

escalar | vector

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

Ejemplo: xline(10) muestra una línea en x=10.

Ejemplo: xline([13 20 33]) muestra líneas en x=13, x=20 e x=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

objeto Axes

Ejes objetivo, especificados como objeto Axes. Utilice este argumento si desea que xline 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, escalar de cadena, arreglo de celdas de vectores de caracteres o arreglo de cadenas.

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.	xline(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.	xline(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.	xline([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'}; xline([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'}; xline([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: xline(5,'LabelVerticalAlignment','middle') especifica la alineación vertical de la etiqueta como 'middle'.

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. La etiqueta segmenta 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
'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.
'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

• yline | xregion | yregion

Propiedades

• ConstantLine Properties