Main Content

line

Crear una línea primitiva

Descripción

ejemplo

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.

ejemplo

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.

ejemplo

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.

ejemplo

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

contraer todo

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

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

Figure contains an axes object. The axes object contains an object of type line.

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)

Figure contains an axes object. The axes object contains 2 objects of type line.

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)

Figure contains an axes object. The axes object contains an object of type line.

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)

Figure contains an axes object. The axes object contains an object of type line.

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

Figure contains an axes object. The axes object contains an object of type line.

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

Figure contains an axes object. The axes object contains an object of type line.

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

Figure contains an axes object. The axes object contains an object of type line.

Argumentos de entrada

contraer todo

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

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

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

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 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 colorNombre cortoTriplete RGBCódigo de color hexadecimalApariencia
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"No se aplicaNo se aplicaNo se aplicaSin 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 RGBCódigo de color hexadecimalApariencia
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

Ejemplo: line(x,y,'Color','blue')

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

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

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

Estilo de líneaDescripciónLínea resultante
"-"Línea continua

Sample of solid line

"--"Línea discontinua

Sample of dashed line

":"Línea de puntos

Sample of dotted line

"-."Línea de puntos y rayas

Sample of dash-dotted line, with alternating dashes and dots

"none"Sin líneaSin línea

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.

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.

MarcadorDescripciónMarcador resultante
"o"Círculo

Sample of circle marker

"+"Signo más

Sample of plus sign marker

"*"Asterisco

Sample of asterisk marker

"."Punto

Sample of point marker

"x"Cruz

Sample of cross marker

"_"Línea horizontal

Sample of horizontal line marker

"|"Línea vertical

Sample of vertical line marker

"square"Cuadrado

Sample of square marker

"diamond"Rombo

Sample of diamond marker

"^"Triángulo hacia arriba

Sample of upward-pointing triangle marker

"v"Triángulo hacia abajo

Sample of downward-pointing triangle marker

">"Triángulo hacia la derecha

Sample of right-pointing triangle marker

"<"Triángulo hacia la izquierda

Sample of left-pointing triangle marker

"pentagram"Pentagrama

Sample of pentagram marker

"hexagram"Hexagrama

Sample of hexagram marker

"none"Sin marcadoresNo se aplica

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

Argumentos de salida

contraer todo

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

Historial de versiones

Introducido antes de R2006a

expandir todo