line
创建基本线条
说明
line
使用默认属性设置绘制一条从点 (0,0)
到 (1,1)
的线条。
line(___,
使用一个或多个名称-值对组参量修改线条的外观。例如,Name,Value
)'LineWidth',3
将线宽设置为 3
磅。请在所有其他输入参量之后指定名称-值对组。如果使用名称-值对组指定数据,例如 line('XData',x,'YData',y)
,则必须指定向量数据。
line(
将在由 ax
,___)ax
指定的笛卡尔坐标区、极坐标区或地理坐标区中创建线条,而不是在当前坐标区 (gca
) 中创建线条。指定 ax
作为第一个输入参量。
示例
使用向量数据绘制线条
使用矩阵数据绘制多个线条
通过将 x
和 y
指定为矩阵来绘制两个线条。使用 line
绘制 y
的列对 x
的列的单独线条。
x = linspace(0,10)'; y = [sin(x) cos(x)]; line(x,y)
使用三维坐标绘制线条
通过指定 x、y 和 z 的值,在三维坐标中绘制线条。使用 view(3)
将坐标区更改为三维视图。
t = linspace(0,10*pi,200); x = sin(t); y = cos(t); z = t; line(x,y,z) view(3)
使用低级别语法绘制线条
以向量形式创建 x
和 y
。然后通过将数据指定为名称-值对组参量来调用 line
函数的低级版本。以这种方式调用该函数时,生成的线条为黑色。
x = linspace(0,10); y = sin(x); line('XData',x,'YData',y)
指定线条属性
在点 (1,2) 和 (9,12) 之间绘制一条红色虚线。将 Color
和 LineStyle
属性设置为名称-值对组。
x = [1 9]; y = [2 12]; line(x,y,'Color','red','LineStyle','--')
创建后更改线条属性
首先,绘制一条从点 (3,15) 到 (2,12) 的线条并返回 Line
对象。然后将线条更改为绿色虚线。使用圆点表示法设置属性。
x = [3 2]; y = [15 12]; pl = line(x,y);
pl.Color = 'green'; pl.LineStyle = '--';
输入参数
x
— 第一个坐标
向量 | 矩阵
第一个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。
第一个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第一个坐标是以数据单位表示的 x 轴上的位置。
如果
x
和y
是具有相同长度的向量,则line
将绘制单个线条。如果
x
和y
是具有相同大小的矩阵,则line
将绘制多个线条。函数绘制y
的列对x
的图。如果
x
或y
的其中一个是向量,另一个是矩阵,则line
将绘制多个线条。该向量的长度必须等于矩阵维度之一:如果向量长度等于矩阵行数,则
line
函数将绘制每一个矩阵列对向量的图。如果向量长度等于矩阵列数,则
line
函数将绘制每一个矩阵行对向量的图。如果矩阵为方阵,则
line
函数将绘制每一列对向量的图。
对于极坐标区,第一个坐标是以弧度表示的极坐标角 θ。对于地理坐标区,第一个坐标是纬度(以度为单位)。要在这些类型的坐标区中绘制线条,x
和 y
必须大小相同。
示例: x = linspace(0,10,25)
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
y
— 第二个坐标
向量 | 矩阵
第二个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。
第二个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第二个坐标是以数据单位表示的 y 轴上的位置。
如果
x
和y
是具有相同长度的向量,则line
将绘制单个线条。如果
x
和y
是具有相同大小的矩阵,则line
将绘制多个线条。函数绘制y
的列对x
的图。如果
x
或y
的其中一个是向量,另一个是矩阵,则line
将绘制多个线条。该向量的长度必须等于矩阵维度之一:如果向量长度等于矩阵行数,则
line
函数将绘制每一个矩阵列对向量的图。如果向量长度等于矩阵列数,则
line
函数将绘制每一个矩阵行对向量的图。如果矩阵为方阵,则
line
函数将绘制每一列对向量的图。
对于极坐标区,第二个坐标是以数据单位表示的半径。对于地理坐标区,第二个坐标是经度(以度为单位)。要在这些类型的坐标区中绘制线条,x
和 y
必须大小相同。
示例: y = sin(x)
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
z
— 第三个坐标
向量 | 矩阵
第三个坐标,指定为向量或矩阵。仅笛卡尔坐标区支持矩阵输入。
第三个坐标的解释取决于坐标区的类型。对于笛卡尔坐标区,第三个坐标是以数据单位表示的 z 轴上的位置。
如果
x
、y
和z
都是具有相同长度的向量,则line
将绘制一个三维线条。如果
x
、y
和z
是具有相同大小的矩阵,则line
将使用矩阵的列绘制多个三维线条。如果
x
、y
和z
中的一个或两个为向量,其余的是具有相同大小的矩阵,则line
将绘制多个三维线条。该向量的长度必须等于矩阵维度之一。
对于极坐标区和地理坐标区,第三个坐标会影响坐标区中二维线条的分层。要在这些类型的坐标区中使用第三个坐标,x
、y
和 z
的大小必须相同。
示例: z = sin(x) + cos(y)
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
ax
— 目标坐标区
Axes
对象 | PolarAxes
对象 | GeographicAxes
对象
目标坐标区,指定为 Axes
对象、PolarAxes
对象或 GeographicAxes
对象。如果未指定坐标区,line
函数将在当前坐标区中绘制线条。
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: line(x,y,'Color','red','LineWidth',3)
创建一个宽度为 3 磅的红色线条。
此处所列的属性只是一部分。有关完整列表,请参阅 Line 属性。
Color
— 线条颜色
[0 0.4470 0.7410]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
线条颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。
对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符串标量或字符向量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#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')
LineStyle
— 线型
"-"
(默认) | "--"
| ":"
| "-."
| "none"
线型,指定为下表中列出的选项之一。
线型 | 描述 | 表示的线条 |
---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
LineWidth
— 线条宽度
0.5
(默认) | 正值
线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。
线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值,则线条显示为一个像素的宽度。
Marker
— 标记符号
"none"
(默认) | "o"
| "+"
| "*"
| "."
| ...
标记符号,指定为下表中列出的值之一。默认情况下,对象不显示标记。指定标记符号可在每个数据点或顶点添加标记。
标记 | 描述 | 生成的标记 |
---|---|---|
"o" | 圆圈 |
|
"+" | 加号 |
|
"*" | 星号 |
|
"." | 点 |
|
"x" | 叉号 |
|
"_" | 水平线条 |
|
"|" | 垂直线条 |
|
"square" | 方形 |
|
"diamond" | 菱形 |
|
"^" | 上三角 |
|
"v" | 下三角 |
|
">" | 右三角 |
|
"<" | 左三角 |
|
"pentagram" | 五角形 |
|
"hexagram" | 六角形 |
|
"none" | 无标记 | 不适用 |
MarkerSize
— 标记大小
6
(默认) | 正值
标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。
提示
与
plot
函数不同,line
函数在绘制之前不会调用newplot
,也不使用图窗或坐标区的NextPlot
属性值。它只向当前坐标区添加线条,而不删除其他图形对象或重置坐标区属性。但是,某些坐标区属性(如坐标轴范围)可能会更新以适应线条。
扩展功能
GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。
分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。
版本历史记录
在 R2006a 之前推出R2023b: 默认线条颜色已更改
现在 SeriesIndex
属性可用于使用 line
函数创建的线条,这些线条与大多数其他绘图一样,循环使用相同的颜色(和可选的线型)。
当您指定 x
、y
和可选的 z
参量时,默认颜色更改仅适用于您创建的线条。如果使用仅使用名称-值参量的语法创建线条,则绘图的外观与在以前版本中相同。
例如,用 x 和 y 输入参量创建两个线条。在 R2023b 中,第一个线条为蓝色,第二个线条为红橙色。在 R2023b 之前,两个线条均为蓝色。
line1 = line([0 1],[0 1]); line2 = line([0 1],[1 2]);
要保留以前版本的行为,请将这些线条的 SeriesIndex
属性设置为 1
。您可以在调用 line
函数时使用名称-值参量设置该属性,也可以稍后使用圆点表示法设置 Line
对象的属性。
% 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;
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)