参照线

x值不变的垂直线

自从R2018b

折叠所有页面

语法

参照线(x)

参照线(x, LineSpec)

参照线(x, LineSpec、标签)

参照线(___、名称、值)

参照线(ax,___）

Xl = xline(___）

描述

例子

参照线(x）在一个或多个位置创建垂直线x-当前轴上的坐标。例如,参照线(2)在x = 2．

例子

参照线(x，LineSpec）指定线条样式、线条颜色或同时指定两者。例如,Xline([12 20 33]，'——b')创建三条蓝色虚线。

例子

参照线(x，LineSpec，标签）向行添加标签。

例子

参照线(___，名称,值）使用一个或多个名称-值对参数指定常量行属性。有关属性列表，请参见ConstantLine属性．在所有其他输入参数之后指定名称-值对。

例子

参照线(斧头，___）创建指定轴上的行，而不是当前轴。

例子

Xl = xline(___）返回一个ConstantLine对象的数组ConstantLine对象。使用xl在创建行之后修改或查询该行的属性。

例子

全部折叠

创建垂直线

打开实时脚本

在x = 3处画一条垂直线。

参照线(3);

图中包含一个轴对象。axis对象包含一个常量类型的对象。

添加标签

打开实时脚本

若要创建带有标签的行，还必须指定行样式。默认的线条样式是实线，“- - -”．

X = linspace(0,6,100);Y = exp(x);情节(x, y)参照线(4.5,“- - -”, {“可接受的”，“限制”})；

图中包含一个轴对象。axis对象包含2个line、constantline类型的对象。

创建多个带标签的行

打开实时脚本

创建正态分布随机数向量，并在直方图中显示它们。然后在平均值、平均值以下一个标准差和平均值以上一个标准差处创建三条竖线，并分别贴上标签。

数据= 5 * randn(1500) + 20;直方图(数据、“FaceAlpha”, 0.1,“EdgeAlpha”, 0.1);M = mean(数据);S = std(数据);Xline ([m-s m m+s]，“- - -”, {-1标准开发，“平均”，“+1标准开发。”})

图中包含一个轴对象。axis对象包含直方图、常量线类型的4个对象。

指定线条样式和颜色

打开实时脚本

在x = 5处创建一条红色虚线。

参照线(5“——r”）;

图中包含一个轴对象。axis对象包含一个常量类型的对象。

添加图例和指定标签对齐方式

打开实时脚本

为图例创建带有标签和显示名称的垂直虚线。

Y = [3187 2693 1771 1826 1958 3222 1645];barh (y,“DisplayName的”，每日销售的) xl = xline(2328，“-”。，“平均”，“DisplayName的”，的平均销售）;

图中包含一个轴对象。axis对象包含2个bar、constantline类型的对象。这些对象表示每日销售额、平均销售额。

调整标签的垂直和水平对齐，然后显示图例。

xl。LabelVerticalAlignment =“中间”；xl。LabelHorizontalAlignment =“中心”；传奇(“显示”）;

图中包含一个轴对象。axis对象包含2个bar、constantline类型的对象。这些对象表示每日销售额、平均销售额。

在不同的轴上添加直线

打开实时脚本

调用tiledlayout函数创建2乘1平铺图表布局。调用nexttile函数创建坐标轴对象ax₁而且ax2．然后画在每个坐标轴上。添加虚线垂直线，并通过将坐标轴传递给参照线函数。

Tiledlayout (2,1) ax1 =nexttile;X = linspace(0,10,200);Y1 = cosx;Plot (ax1,x,y1) ax2 = nexttile;Y2 = sinx;情节(ax2, x, y2)参照线(ax₁,π/ 2,“:”，“因为(\π/ 2)= 0的）;参照线(ax2,π,“:”，“罪(\π)= 0”）;

图中包含2个轴对象。坐标轴对象1包含2个line、constantline类型的对象。坐标轴对象2包含2个line、constantline类型的对象。

输入参数

全部折叠

`x`- - - - - -x坐标
标量|向量

x-coordinates，指定为包含数值、类别、日期时间或持续时间值的标量或向量。的数据类型x的数据类型必须匹配x设在。

例子:参照线(10)显示在x = 10．

例子:Xline ([13 20 33])显示在x = 13，x = 20,x = 33．

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|分类|datetime|持续时间

`LineSpec`- - - - - -线条风格和颜色
特征向量|字符串标量

线条样式和颜色，指定为包含字符和符号的字符向量或字符串标量。字符和符号可以以任何顺序出现。您可以指定线条样式、线条颜色或两者都指定。标记符号，例如“o”将被忽略。

例子:“——g”是一条绿色虚线。

线条样式	描述	产生的线
`“-”`	实线
`”——“`	虚线
`"："`	虚线
`“-”。`	Dash-dotted线

颜色名称	短名称	外观
`“红色”`	`“r”`
`“绿色”`	`‘g’`
`“蓝”`	`“b”`
`“青色”`	`“c”`
`“红色”`	`“米”`
`“黄色”`	`“y”`
`“黑”`	`“k”`
`“白色”`	`' w '`

`斧头`- - - - - -目标轴
`轴`对象

目标轴，指定为轴对象。如果你愿意，可以使用这个论点参照线在当前坐标轴以外的坐标轴上绘图。

`标签`- - - - - -行标签
`”`(默认)|特征向量|字符串标量|字符向量的单元格数组|字符串数组

行标签，指定为字符向量、字符串标量、字符向量的单元格数组或字符串数组。

为一行创建标签

指定字符向量或字符串标量以显示一行文本。若要显示多行文本，请指定字符向量的单元格数组或字符串数组。

演讲如何指定标签 例子

一行文本

指定字符向量或字符串标量。

演讲	如何指定`标签`	例子
一行文本	指定字符向量或字符串标量。	参照线(12,“- - -”，“样本”）
多行文本	指定字符向量的单元格数组或字符串数组。数组中的每个元素都是一行不同的文本。	参照线(12,“- - -”, {“样本”，“x = 12”})

参照线(12,“- - -”，“样本”）

带标号的轴上的垂直线

多行文本

指定字符向量的单元格数组或字符串数组。数组中的每个元素都是一行不同的文本。

参照线(12,“- - -”, {“样本”，“x = 12”})

轴上带有两行文本的标签的垂直线

为多行创建标签

指定一个字符向量或字符串标量，以便在所有行旁边显示相同的标签。指定字符向量的单元格数组或字符串数组，以便为每一行显示不同的标签。

演讲如何指定标签 例子

一个共享文本标签

指定字符向量或字符串标量。

演讲	如何指定`标签`	例子
一个共享文本标签	指定字符向量或字符串标量。	Xline ([13 20 33]，“- - -”，“样本”）
每一行都有不同的标签	指定字符向量的单元格数组或字符串数组。数组中的每个元素都是不同行的标签。元素的个数`标签`数组的长度必须匹配`x`．	标签= {样品1的，示例2的，“示例3”};Xline ([13 20 33]，“- - -”、标签)
不同的标签与一些多行标签	创建字符向量或字符串数组的单元格数组。使用`sprintf`函数插入换行符(`' \ n '`)在课文中。	标签= {样品1的sprintf (的样品2 \ nx = 20)，“示例3”};Xline ([13 20 33]，“- - -”、标签)

Xline ([13 20 33]，“- - -”，“样本”）

轴线上的三条垂直线，并带有相应的标签

每一行都有不同的标签

指定字符向量的单元格数组或字符串数组。数组中的每个元素都是不同行的标签。元素的个数标签数组的长度必须匹配x．

标签= {样品1的，示例2的，“示例3”};Xline ([13 20 33]，“- - -”、标签)

轴线上的三条垂直线，有不同的标记

不同的标签与一些多行标签

创建字符向量或字符串数组的单元格数组。使用sprintf函数插入换行符(' \ n ')在课文中。

标签= {样品1的sprintf (的样品2 \ nx = 20)，“示例3”};Xline ([13 20 33]，“- - -”、标签)

轴线上的三条垂直线，有不同的标记。第二行标签有两行文本。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来名字在报价。

例子:参照线(5“LabelVerticalAlignment”“中产”)指定标签的垂直对齐方式为“中间”．

请注意

这里列出的属性只是一个子集。有关完整列表，请参见ConstantLine属性．

`颜色`- - - - - -线颜色
`[0.15 0.15 0.15]`(默认)|RGB值|十六进制颜色代码|`“r”`|`‘g’`|`“b”`|……

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

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

RGB三元组是一个三元素行向量，其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1]，例如，[0.4 0.6 0.7]．
十六进制颜色码是以散列符号(＃)后面跟着三个或六个十六进制数字，取值范围为0来F．这些值不区分大小写。因此，颜色代码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

或者，您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称	短名称	RGB值	十六进制颜色代码	外观
`“红色”`	`“r”`	`[10 0 0]`	`“# FF0000”`
`“绿色”`	`“g”`	`[0 10 0]`	`“# 00 ff00”`
`“蓝色”`	`“b”`	`[0 0 1]`	`“# 0000 ff”`
`“青色”`	`“c”`	`[0 1 1]`	`“# 00飞行符”`
`“红色”`	`“m”`	`[10 0 1]`	`“#”就`
`“黄色”`	`“y”`	`[11 10 0]`	`“# FFFF00”`
`“黑色”`	`“k”`	`[0 0 0]`	`“000000 #”`
`“白色”`	`“w”`	`[1 1 1]`	`“# FFFFFF”`
`“没有”`	不适用	不适用	不适用	没有颜色

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

RGB值	十六进制颜色代码	外观
`[0 0.4470 0.7410]`	`“# 0072 bd”`
`[0.8500 0.3250 0.0980]`	`“# D95319”`
`[0.9290 0.6940 0.1250]`	`“# EDB120”`
`[0.4940 0.1840 0.5560]`	`“# 7 e2f8e”`
`[0.4660 0.6740 0.1880]`	`“# 77 ac30”`
`[0.3010 0.7450 0.9330]`	`“# 4 dbeee”`
`[0.6350 0.0780 0.1840]`	`“# A2142F”`