xline
R2026aLínea vertical con valor x constante
Sintaxis
Descripción
xline( crea una línea vertical en una o más coordenadas x de los ejes actuales. Por ejemplo, x)xline(2) crea una línea en x=2.
xline(___, 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.Name,Value)
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
Cree una línea vertical en x = 3.
xline(3);
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'});
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.'})
Cree una línea discontinua roja en x = 5.
xline(5,'--r');
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');
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
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
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' |
|
Ejes objetivo, especificados como objeto Axes. Utilice este argumento si desea que xline se represente en ejes distintos de los ejes actuales.
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 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 entre0yF. 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 |
En esta tabla, se enumeran las paletas de colores predeterminados para las gráficas en los temas claro y oscuro.
| Paleta | Colores de la paleta |
|---|---|
Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada. |
|
|
|
Puede obtener los tripletes RGB y los códigos de color hexadecimales de estas paletas usando las funciones orderedcolors y rgb2hex. Por ejemplo, puede obtener los tripletes RGB de la paleta "gem" y convertirlos en códigos de color hexadecimales.
RGB = orderedcolors("gem");
H = rgb2hex(RGB);Antes de R2023b: Obtenga los tripletes RGB usando RGB = get(groot,"FactoryAxesColorOrder").
Antes de R2024a: Obtenga los códigos de color hexadecimales usando H = compose("#%02X%02X%02X",round(RGB*255)).
Ejemplo: 'g'
Ejemplo: [0.6 0.2 0.5]
Ejemplo: '#D2F9A7'
Transparencia de línea, especificada como un escalar en el intervalo [0,1]. Un valor de 1 es opaco y 0 es totalmente transparente. Los valores situados entre 0 y 1 son semitransparentes.
Ancho de línea, especificado como valor positivo en puntos.
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 |
|
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 |
|
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
