xline
具有常量 x 值的垂直线
语法
说明
xline(___,
使用一个或多个名称-值对组参量指定常量线属性。有关属性列表,请参阅 ConstantLine 属性。请在所有其他输入参量之后指定名称-值对组。Name,Value
)
xl = xline(___)
返回一个 ConstantLine
对象或 ConstantLine
对象数组。使用 xl
修改或查询所创建的线条的属性。
示例
要创建一条具有标签的线条,还必须指定线型。默认线型是实线 '-'
。
x = linspace(0,6,100); y = exp(x); plot(x,y) xline(4.5,'-',{'Acceptable','Limit'});
创建一个由正态分布随机数组成的向量,并在直方图中显示它们。然后创建三条带标签的垂直线,一条表示平均值、一条表示低于平均值一个标准差,一条表示高于平均值一个标准差。
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.'})
为图例创建一条既具有标签又具有显示名称的垂直点划线。
y = [3187 2693 1771 1826 1958 3222 1645]; barh(y,'DisplayName','Daily Sales') xl = xline(2328,'-.','Average','DisplayName','Average Sales');
调整该标签的垂直和水平对齐,然后显示图例。
xl.LabelVerticalAlignment = 'middle'; xl.LabelHorizontalAlignment = 'center'; legend('show');
调用 tiledlayout
函数以创建一个 2×1 分块图布局。调用 nexttile
函数以创建坐标区对象 ax1
和 ax2
。然后在每个坐标区中绘图。通过将坐标区传递给 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');
输入参数
x 坐标,指定为标量或包含数值、分类、日期时间或持续时间值的向量。x
的数据类型必须与 x 轴的数据类型匹配。
示例: xline(10)
在 x=10
处显示一条线。
示例: xline([13 20 33])
在 x=13
、x=20
和 x=33
处显示线条。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| categorical
| datetime
| duration
线型和颜色,指定为包含字符和符号的字符向量或字符串标量。字符和符号可以按任何顺序出现。您可以指定线型和/或线条颜色。忽略 'o'
等标记符号。
示例: '--g'
表示绿色虚线。
线型 | 描述 | 表示的线条 |
---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
颜色名称 | 短名称 | 外观 |
---|---|---|
'red' | 'r' | |
'green' | 'g' | |
'blue' | 'b' | |
'cyan' | 'c' | |
'magenta' | 'm' | |
'yellow' | 'y' | |
'black' | 'k' | |
'white' | 'w' | |
目标坐标区,指定为 Axes
对象。如果希望 xline
在当前坐标区以外的坐标区中绘图,请使用此参量。
信号线标签,指定为字符向量、字符串标量、字符向量元胞数组或字符串数组。
为一条线创建标签
指定一个字符向量或字符串标量来显示一行文本。要显示多行文本,请指定字符向量元胞数组或字符串数组。
表示形式 | 如何指定 labels | 示例 |
---|---|---|
一行文本 | 指定一个字符向量或字符串标量。 |
xline(12,'-','Sample')
|
多行文本 | 指定一个字符向量元胞数组或字符串数组。数组中的每个元素是不同行的文本。 | xline(12,'-',{'Sample','x=12'}) |
为多行创建标签
指定一个字符向量或字符串标量,以便在所有行旁边显示相同的标签。指定一个字符向量元胞数组或字符串数组,为每行显示不同标签。
表示形式 | 如何指定 labels | 示例 |
---|---|---|
一个共享文本标签 | 指定一个字符向量或字符串标量。 |
xline([13 20 33],'-','Sample')
|
每行有不同标签 | 指定一个字符向量元胞数组或字符串数组。数组中的每个元素都是一个对应不同行的标签。labels 数组中的元素数必须与 x 的长度匹配。 | label = {'Sample 1','Sample 2','Sample 3'}; xline([13 20 33],'-',label) |
不同的标签,部分标签有多行 | 创建一个字符向量元胞数组或字符串数组。使用 sprintf 函数在文本中插入换行符 ('\n' )。 | label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'}; xline([13 20 33],'-',label) |
名称-值参数
以 Name1=Value1,...,NameN=ValueN
的形式指定可选参量对组,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量之后,但对各个参量对组的顺序没有要求。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: xline(5,'LabelVerticalAlignment','middle')
将标签的垂直对齐方式指定为 'middle'
。
注意
此处所列的属性只是一部分。有关完整列表,请参阅 ConstantLine 属性。
线条颜色,指定为 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" | 不适用 | 不适用 | 不适用 | 无颜色 |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 orderedcolors
和 rgb2hex
函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如,获取 "gem"
调色板的 RGB 三元组并将其转换为十六进制颜色代码。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);
在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder")
获取 RGB 三元组。
在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255))
获取十六进制颜色代码。
示例: 'g'
示例: [0.6 0.2 0.5]
示例: '#D2F9A7'
线宽,指定为以磅为单位的正值。
图例标签,指定为字符向量或字符串标量。只有调用 legend
命令之后,才会显示图例。如果未指定文本,则 legend
使用 'dataN'
形式设置标签。
标签相对于线的水平对齐,指定为下表中的选项之一。
选项 | 描述 | 示例 |
---|---|---|
'right' | 线的右侧。 | |
'left' | 线的左侧。 | |
'center' | 线的中心。标签将线分段。 | |
标签相对于线的垂直对齐,指定为下表中的选项之一。
选项 | 描述 | 示例 |
---|---|---|
'top' | 线的顶部 | |
'middle' | 线的中间 | |
'bottom' | 线的底部 | |
标签方向,指定为 'aligned'
或 'horizontal'
。下表中显示了示例。
方向 | 描述 | 示例 |
---|---|---|
'aligned' | 标签与线的方向相同。 | |
'horizontal' | 无论线的方向如何,标签始终为水平方向。 | |
算法
在坐标区的三维视图中,常量线出现在 z 坐标轴范围中点处的 x-y 平面中。如果坐标区旋转,则常量线会随之旋转。
版本历史记录
在 R2018b 中推出
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- 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)