本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

line

创建基本线条

说明

示例

line(x,y) 使用向量 xy 中的数据在当前坐标区中绘制线条。如果 xy 中有一个是矩阵或两者都是矩阵,则 line 将绘制多个线条。与 plot 函数不同,line 会向当前坐标区添加线条,而不删除其他图形对象或重置坐标区属性。

示例

line(x,y,z) 在三维坐标中绘制线条。

line 使用默认属性设置绘制一条从点 (0,0)(1,1) 的线条。

示例

line(___,Name,Value) 使用一个或多个名称-值对组参数修改线条的外观。例如,'LineWidth',3 将线宽设置为 3 磅。请在所有其他输入参数之后指定名称-值对组。如果使用名称-值对组指定数据,例如 line('XData','x','YData','y'),则必须指定向量数据。

line(ax,___) 将在由 ax 指定的笛卡尔坐标区、极坐标区或地理坐标区中创建线条,而不是在当前坐标区 (gca) 中创建线条。指定 ax 作为第一个输入参数。

示例

pl = line(___) 返回创建的所有基本 Line 对象。可在创建特定的 Line 对象后使用 pl 修改其属性。有关列表,请参阅 Line 属性

示例

全部折叠

以向量形式创建 xy。然后,绘制 yx 的图。

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

通过将 xy 指定为矩阵来绘制两个线条。使用 line 绘制 y 的列对 x 的列的单独线条。

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

通过指定 xyz 的值,在三维坐标中绘制线条。使用 view(3) 将坐标区更改为三维视图。

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

以向量形式创建 xy。然后,使用 line 函数的低级版本绘制 yx 的图。

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

在点 (1,2) 和 (9,12) 之间绘制一条红色虚线。将 ColorLineStyle 属性设置为名称-值对组。

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

首先,绘制一条从点 (3,15) 到 (2,12) 的线条并返回 Line 对象。然后将线条更改为绿色虚线。

注意:从 R2014b 开始,您可以使用圆点表示法设置属性。如果您使用的是早期版本,请改用 set 函数。

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

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

输入参数

全部折叠

第一个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。

第一个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第一个坐标是以数据单位表示的 x 轴上的位置。

  • 如果 xy 是具有相同长度的向量,则 line 将绘制单个线条。

  • 如果 xy 是具有相同大小的矩阵,则 line 将绘制多个线条。函数绘制 y 的列对 x 的图。

  • 如果 xy 的其中一个是向量,另一个是矩阵,则 line 将绘制多个线条。该向量的长度必须等于矩阵维度之一:

    • 如果向量长度等于矩阵行数,则 line 函数将绘制每一个矩阵列对向量的图。

    • 如果向量长度等于矩阵列数,则 line 函数将绘制每一个矩阵行对向量的图。

    • 如果矩阵为方阵,则 line 函数将绘制每一列对向量的图。

对于极坐标区,第一个坐标是以弧度表示的极坐标角 θ。对于地理坐标区,第一个坐标是纬度(以度为单位)。要在这些类型的坐标区中绘制线条,xy 必须大小相同。

示例: x = linspace(0,10,25)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

第二个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。

第二个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第二个坐标是以数据单位表示的 y 轴上的位置。

  • 如果 xy 是具有相同长度的向量,则 line 将绘制单个线条。

  • 如果 xy 是具有相同大小的矩阵,则 line 将绘制多个线条。函数绘制 y 的列对 x 的图。

  • 如果 xy 的其中一个是向量,另一个是矩阵,则 line 将绘制多个线条。该向量的长度必须等于矩阵维度之一:

    • 如果向量长度等于矩阵行数,则 line 函数将绘制每一个矩阵列对向量的图。

    • 如果向量长度等于矩阵列数,则 line 函数将绘制每一个矩阵行对向量的图。

    • 如果矩阵为方阵,则 line 函数将绘制每一列对向量的图。

对于极坐标区,第二个坐标是以数据单位表示的半径。对于地理坐标区,第二个坐标是经度(以度为单位)。要在这些类型的坐标区中绘制线条,xy 必须大小相同。

示例: y = sin(x)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

第三个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。

第三个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第三个坐标是以数据单位表示的 z 轴上的位置。

  • 如果 xyz 都是具有相同长度的向量,则 line 将绘制一个三维线条。

  • 如果 xyz 是具有相同大小的矩阵,则 line 将使用矩阵的列绘制多个三维线条。

  • 如果 xyz 中的一个或两个为向量,其余的是具有相同大小的矩阵,则 line 将绘制多个三维线条。该向量的长度必须等于矩阵维度之一。

对于极坐标区和地理坐标区,第三个坐标会影响坐标区中二维线条的分层。要在这些类型的坐标区中使用第三个坐标,xyz 的大小必须相同。

示例: z = sin(x) + cos(y)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

目标坐标区,指定为 Axes 对象、PolarAxes 对象或 GeographicAxes 对象。如果未指定坐标区,line 函数将在当前坐标区中绘制线条。

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: line(x,y,'Color','red','LineWidth',3) 创建一个宽度为 3 磅的红色线条。

此处所列的属性只是一部分。有关完整列表,请参阅 Line 属性

线条颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 '#FF8800''#ff8800''#F80''#f80' 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
'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'不适用不适用不适用无颜色

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[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'

示例: line(x,y,'Color','blue')

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

示例: line(x,y,'Color','#D9A2E9')

线型,指定为下表中列出的选项之一。

线型说明表示的线条
'-'实线

'--'虚线

':'点线

'-.'点划线

'none'无线条无线条

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

标记符号,指定为下表中列出的值之一。默认情况下,对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。

说明
'o'圆圈
'+'加号
'*'星号
'.'
'x'叉号
'square''s'方形
'diamond''d'菱形
'^'上三角
'v'下三角
'>'右三角
'<'左三角
'pentagram''p'五角星(五角形)
'hexagram''h'六角星(六角形)
'none'无标记

标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。

输出参数

全部折叠

基本线条对象。可使用 pl 在创建线条后查询或修改其属性。有关列表,请参阅 Line 属性

提示

  • plot 函数不同,line 函数在绘制之前不会调用 newplot,也不使用图窗或坐标区的 NextPlot 属性值。它只向当前坐标区添加线条,而不删除其他图形对象或重置坐标区属性。但是,某些坐标区属性(如坐标轴范围)可能会更新以适应线条。

扩展功能

在 R2006a 之前推出