line

Crear una línea primitiva

Sintaxis

line(x,y)

line(x,y,z)

line

line(___,Name,Value)

line(ax,___)

pl = line(___)

Descripción

line(x,y) representa una línea en los ejes actuales usando los datos en los vectores x e y. Si x o y, o bien ambas son matrices, line representa varias líneas. A diferencia de la función plot, line añade la línea a los ejes actuales sin eliminar otros objetos de gráficas ni restablecer las propiedades de los ejes.

line(x,y,z) representa una línea en coordenadas de tres dimensiones.

line representa una línea del punto (0,0) a (1,1) con la configuración predeterminada de las propiedades.

line(___,Name,Value) modifica la apariencia de la línea utilizando uno o más pares de argumentos nombre-valor. Por ejemplo, 'LineWidth',3 establece el ancho de línea en 3 puntos. Especifique los pares nombre-valor tras el resto de argumentos de entrada. Si especifica los datos mediante pares nombre-valor, por ejemplo line('XData',x,'YData',y), debe especificar los datos de los vectores.

line(ax,___) crea la línea en los ejes cartesianos, polares o geográficos especificados por ax en lugar de en los ejes actuales (gca). Especifique ax como primer argumento de entrada.

pl = line(___) devuelve todos los objetos Line primitivos creados. Utilice pl para modificar las propiedades de un objeto Line específico después de crearlo. Para obtener una lista, consulte Line Properties.

Ejemplos

Representar una línea mediante datos de vector

Cree x e y como vectores. A continuación, represente y frente a x.

x = linspace(0,10);
y = sin(x);
line(x,y)

Representar múltiples líneas mediante datos de matriz

Represente dos líneas especificando x e y como matrices. Use line para representar las columnas de y frente a las columnas de x como líneas separadas.

x = linspace(0,10)';
y = [sin(x) cos(x)];
line(x,y)

Representar una línea mediante coordenadas 3D

Represente una línea en coordenadas 3D especificando los valores x, y y z. Cambie los ejes a una vista 3D mediante view(3).

t = linspace(0,10*pi,200);
x = sin(t);
y = cos(t);
z = t;
line(x,y,z)
view(3)

Representar una línea usando sintaxis de bajo nivel

Cree x e y como vectores. A continuación, llame a la versión de bajo nivel de la función line especificando los datos como argumentos de par nombre-valor. Cuando llama a la función de este modo, la línea resultante es de color negro.

x = linspace(0,10);
y = sin(x);
line('XData',x,'YData',y)

Especificar las propiedades de las líneas

Represente una línea discontinua roja entre los puntos (1,2) y (9,12). Establezca las propiedades Color y LineStyle como pares nombre-valor.

x = [1 9];
y = [2 12];
line(x,y,'Color','red','LineStyle','--')

Modificar las propiedades de las líneas después de crearlas

En primer lugar, dibuje una línea del punto (3,15) a (2,12) y devuelva el objeto Line. A continuación, cambie la línea por una línea verde discontinua. Utilice la notación de puntos para establecer las propiedades.

x = [3 2];
y = [15 12];
pl = line(x,y);

pl.Color = 'green';
pl.LineStyle = '--';

Argumentos de entrada

x — Primera coordenada

vector | matriz

Primera coordenada, especificada como vector o matriz. Las entradas de matriz solo son compatibles con ejes cartesianos.

La interpretación de la primera coordenada depende del tipo de ejes. Para ejes cartesianos, la primera coordenada es la posición del eje x en unidades de datos.

• Si tanto x como y son vectores con la misma longitud, line representa una única línea.

• Si x e y son matrices con el mismo tamaño, line representa varias líneas. La función representa columnas de y frente a x.

• Si x o y es un vector y el otro es una matriz, line representa varias líneas. La longitud del vector debe coincidir con una de las dimensiones de la matriz:

  • Si la longitud del vector es igual al número de filas de la matriz, line representa cada columna de la matriz frente al vector.

  • Si la longitud del vector es igual al número de columnas de la matriz, line representa cada fila de la matriz frente al vector.

  • Si la matriz es cuadrada, line representa cada columna frente al vector.

Para ejes polares, la primera coordenada es el ángulo polar θ en radianes. Para ejes geográficos, la primera coordenada es la latitud en grados. Para representar líneas en estos tipos de ejes, x e y deben tener el mismo tamaño.

Ejemplo: x = linspace(0,10,25)

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

y — Segunda coordenada

vector | matriz

Segunda coordenada, especificada como vector o matriz. Las entradas de matriz solo son compatibles con ejes cartesianos.

La interpretación de la segunda coordenada depende del tipo de eje. Para ejes cartesianos, la segunda coordenada es la posición del eje y en unidades de datos.

• Si tanto x como y son vectores con la misma longitud, line representa una única línea.

• Si x e y son matrices con el mismo tamaño, line representa varias líneas. La función representa columnas de y frente a x.

• Si x o y es un vector y el otro es una matriz, line representa varias líneas. La longitud del vector debe coincidir con una de las dimensiones de la matriz:

  • Si la longitud del vector es igual al número de filas de la matriz, line representa cada columna de la matriz frente al vector.

  • Si la longitud del vector es igual al número de columnas de la matriz, line representa cada fila de la matriz frente al vector.

  • Si la matriz es cuadrada, line representa cada columna frente al vector.

Para ejes polares, la segunda coordenada es el radio en unidades de datos. Para ejes geográficos, la segunda coordenada es la longitud en grados. Para representar líneas en estos tipos de ejes, x e y deben tener el mismo tamaño.

Ejemplo: y = sin(x)

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

z — Tercera coordenada

vector | matriz

Tercera coordenada, especificada como vector o matriz. Las entradas de matriz solo son compatibles con ejes cartesianos.

La interpretación de la tercera coordenada depende del tipo de eje. Para ejes cartesianos, la tercera coordenada es la posición del eje z en unidades de datos.

• Si x, y y z son vectores con la misma longitud, line representa una única línea 3D.

• Si x, y y z son matrices con el mismo tamaño, line representa varias líneas 3D mediante las columnas de la matriz.

• Si uno o dos de x, y y z es un vector y los demás son matrices del mismo tamaño, line representa varias líneas 3D. La longitud del vector debe coincidir con una de las dimensiones de la matriz.

Para ejes polares y geográficos, la tercera coordenada afecta a la disposición de las líneas 2D de los ejes. Para usar la tercera coordenada en estos tipos de ejes, x, y y z deben ser del mismo tamaño.

Ejemplo: z = sin(x) + cos(y)

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

ax — Ejes objetivo

objeto Axes | objeto PolarAxes | objeto GeographicAxes

Ejes objetivo, especificados como objeto Axes, objeto PolarAxes u objeto GeographicAxes. Si no especifica los ejes, la función line se representa en los ejes actuales.

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: line(x,y,'Color','red','LineWidth',3) crea una línea roja de 3 puntos de ancho.

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

Color — Color de línea

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

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
"gem": tema claro predeterminado Antes de R2025a: La mayoría de las gráficas utilizan estos colores de forma predeterminada.
"glow": tema oscuro predeterminado

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: line(x,y,'Color','blue')

Ejemplo: line(x,y,'Color',[0.5 0.5 1])

Ejemplo: line(x,y,'Color','#D9A2E9')

LineStyle — Estilo de línea

"-" (predeterminado) | "--" | ":" | "-." | "none"

Estilo de línea, especificado como una de las opciones enumeradas en esta tabla.

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
"none"	Sin línea	Sin línea

LineWidth — Ancho de línea

0.5 (predeterminado) | valor positivo

Ancho de línea, especificado como valor positivo en puntos, donde 1 punto = 1/72 de pulgada (0,035 cm). Si la línea tiene marcadores, el ancho de línea también afecta a los bordes de los marcadores.

El ancho de línea no puede ser inferior al de un píxel. Si establece el ancho de línea en un valor inferior al ancho de un píxel en su sistema, la línea se muestra igual de ancha que un píxel.

Marker — Símbolo de marcador

"none" (predeterminado) | "o" | "+" | "*" | "." | ...

Símbolo de marcador, especificado como uno de los valores enumerados en esta tabla. De forma predeterminada, el objeto no muestra marcadores. La especificación de un símbolo de marcador agrega marcadores en todos los puntos de datos o vértices.

Marcador	Descripción	Marcador resultante
"o"	Círculo
"+"	Signo más
"*"	Asterisco
"."	Punto
"x"	Cruz
"_"	Línea horizontal
"|"	Línea vertical
"square"	Cuadrado
"diamond"	Rombo
"^"	Triángulo hacia arriba
"v"	Triángulo hacia abajo
">"	Triángulo hacia la derecha
"<"	Triángulo hacia la izquierda
"pentagram"	Pentagrama
"hexagram"	Hexagrama
"none"	Sin marcadores	No se aplica

MarkerSize — Tamaño del marcador

6 (predeterminado) | valor positivo

Tamaño del marcador, especificado como valor positivo en puntos, donde 1 punto = 1/72 de pulgada (0,035 cm).

Argumentos de salida

pl — Objeto de línea primitiva

objeto de línea primitiva

Objeto de línea primitiva. Utilice pl para consultar o modificar las propiedades de la línea después de crearla. Para obtener una lista, consulte Line Properties.

Sugerencias

• A diferencia de la función plot, line no llama a newplot antes de la representación y no respeta el valor de la propiedad NextPlot para la figura o los ejes. Tan solo añade la línea a los ejes actuales sin eliminar otros objetos de gráficas ni restablecer las propiedades de los ejes. Sin embargo, algunas propiedades de los ejes, como los límites, pueden actualizarse para dar cabida a la línea.

Capacidades ampliadas

Arreglos GPU

Acelere código mediante la ejecución en una unidad de procesamiento gráfico (GPU) mediante Parallel Computing Toolbox™.

La función line es compatible con entradas de arreglos de GPU con estas notas y limitaciones de uso:

• Esta función acepta arreglos de GPU, pero no se ejecuta en una GPU.

Para obtener más información, consulte Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Notas y limitaciones de uso:

• Esta función opera sobre arreglos distribuidos, pero se ejecuta en el cliente MATLAB^®.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

R2023b: El color de línea predeterminado ha cambiado

Ahora que la propiedad SeriesIndex está disponible para las líneas creadas con la función line, estas pasan por los mismos colores (y estilos de línea opcionales) que la mayoría de las demás gráficas.

El cambio de color predeterminado solo se aplica a las líneas que se crean al especificar los argumentos x, y y el argumento opcional z. Si crea líneas con una sintaxis que solo utiliza argumentos de par nombre-valor, las gráficas tienen el mismo aspecto que en versiones anteriores.

Por ejemplo, cree dos líneas con argumentos de entrada x e y. En la versión R2023b, la primera línea es azul y la segunda roja-naranja. Antes de la versión R2023b, ambas líneas eran azules.

line1 = line([0 1],[0 1]);
line2 = line([0 1],[1 2]);

Para conservar el comportamiento de las versiones anteriores, establezca la propiedad SeriesIndex de las líneas en 1. Puede establecer la propiedad utilizando un argumento de par nombre-valor cuando llame a la función line, o también puede establecer la propiedad del objeto Line utilizando la notación de puntos más adelante.

% Use a name-value argument
line1 = line([0 1],[0 1],SeriesIndex=1);
 
% Use dot notation
line2 = line([0 1],[1 2]);
line2.SeriesIndex = 1;

Consulte también

Funciones

• annotation | plot | plot3 | loglog | xline | yline

Propiedades

• Line Properties

Temas

• Plot Dates and Times
• Representar datos categóricos