stairs

阶梯图

全页折叠

语法

stairs(Y)

stairs(X,Y)

stairs(___,LineSpec)

stairs(tbl,yvar)

stairs(tbl,xvar,yvar)

stairs(___,Name,Value)

stairs(ax,___)

h = stairs(___)

[xb,yb] = stairs(___)

说明

向量和矩阵数据

stairs(Y) 绘制 Y 中元素的阶梯图。

如果 Y 为向量，则 stairs 绘制一个线条。
如果 Y 为矩阵，则 stairs 为每个矩阵列绘制一个线条。

示例

stairs(X,Y) 在 Y 中由 X 指定的位置绘制元素。输入 X 和 Y 必须是相同大小的向量或矩阵。另外，X 可以是行或列向量，Y 必须是包含 length(X) 行的矩阵。

示例

stairs(___,LineSpec) 指定线型、标记符号和颜色。例如，":*r" 指定带星号标记的红色点线。可将此选项与上述语法中的任何输入参量组合一起使用。

示例

表数据

stairs(tbl,yvar) 绘制表中的指定变量对表的行索引的图。如果该表是时间表，则绘制指定变量对时间表的行时间的图。要绘制一组 y 值，请为 yvar 指定变量。要绘制多组 y 值，请为 yvar 指定多个变量。 (自 R2022b 起)

示例

stairs(tbl,xvar,yvar) 绘制表 tbl 中的变量 xvar 和 yvar。您可以为 xvar 和 yvar 指定一个或多个变量。如果两个参量都指定多个变量，它们指定的变量数目必须相同。 (自 R2022b 起)

示例

其他选项

stairs(___,Name,Value) 使用一个或多个名称-值对组参量修改阶梯图。例如，"Marker","o","MarkerSize",8 指定大小为 8 磅的圆形标记。

示例

stairs(ax,___) 将图形绘制到 ax 指定的坐标区中，而不是当前坐标区 (gca) 中。选项 ax 可以位于上述语法中的任何输入参量组合之前。

示例

h = stairs(___) 返回一个或多个 Stair 对象。在创建特定 Stair 对象后，使用 h 更改该对象的属性。

示例

[xb,yb] = stairs(___) 不创建绘图，但返回大小相等的矩阵 xb 和 yb，以使 plot(xb,yb) 绘制阶梯图。

此语法不支持表和表变量参量。

示例

全部折叠

绘制单数据序列

打开实时脚本

创建在 0 到 $4 π$ 区间内的 40 个均匀分布的值处计算的正弦阶梯图。

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(Y)

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

Y 的长度自动确定并生成 x 轴刻度。

绘制多个数据序列

打开实时脚本

创建在 0 到 $4 π$ 区间内的 50 个均匀分布的值处计算的两个余弦函数阶梯图。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(Y)

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

Y 中的行数自动确定并生成 x 轴刻度。

在指定的 x 值位置绘制单个数据序列

打开实时脚本

创建在 0 到 $4 π$ 区间内均匀分布的值处计算的正弦波阶梯图。指定该图的 x 值集。

X = linspace(0,4*pi,40);
Y = sin(X);

figure
stairs(X,Y)

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

绘制 Y 中的项对 X 中的对应项的图。

在指定的 x 值处绘制多个数据序列

打开实时脚本

创建在 0 到 $4 π$ 区间内的均匀分布的值处计算的两个余弦波阶梯图。指定该图的 x 值集。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];

figure
stairs(X,Y)

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

第一个向量输入 X 确定两个数据序列的 x 轴位置。

在唯一的 x 值集合处绘制多个数据序列

打开实时脚本

创建在不同的值处计算的两个余弦波的阶梯图。指定用于绘制每个数据序列的唯一 x 值集。

x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];

figure
stairs(X,Y)

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

绘制 X 的每一列对 Y 的对应列的图。

指定线型、标记符号和颜色

打开实时脚本

创建一个阶梯图，将线型设置为点划线，将标记符号设置为圆，将颜色设置为红色。

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y, '-.or')

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

指定其他样式选项

打开实时脚本

使用 Name,Value 对组参量创建一个阶梯图并将线宽设置为 2，将标记符号设置为菱形，并将标记面颜色设置为青色。

X = linspace(0,4*pi,20);
Y = sin(X);

figure
stairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

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

绘制表中的数据

自 R2022b 起

打开实时脚本

基于表数据绘图的一种便捷方法是将表传递给 stairs 函数，并指定要绘制的变量。

读取 weather.csv 的前 100 行和前 7 列数据作为一个时间表 tbl。然后显示该表的前三行。

tbl = readtimetable("weather.csv","Range",[1 1 101 7]);
head(tbl,3)

            Time            WindDirection    WindSpeed    Humidity    Temperature    RainInchesPerMinute    CumulativeRainfall
    ____________________    _____________    _________    ________    ___________    ___________________    __________________

    25-Oct-2021 00:00:09         46               1          84          49.2                 0                     0         
    25-Oct-2021 00:01:09         45             1.6          84          49.2                 0                     0         
    25-Oct-2021 00:02:09         36             2.2          84          49.2                 0                     0

在 x 轴上绘制 Time 变量，在 y 轴上绘制 CumulativeRainfall 变量。然后使用 axis padded 命令，使线条和图框不重叠。

以 h 形式返回 Stair 对象。请注意，轴标签与变量名称匹配。

h = stairs(tbl,"Time","CumulativeRainfall");
axis padded

Figure contains an axes object. The axes object with xlabel Time, ylabel CumulativeRainfall contains an object of type stair.

通过设置 Color 属性，将线的颜色更改为紫色。

h.Color = [0.5 0 0.8];

Figure contains an axes object. The axes object with xlabel Time, ylabel CumulativeRainfall contains an object of type stair.

在一个坐标区上绘制多个表变量

自 R2022b 起

打开实时脚本

创建向量 x、y1 和 y2，并使用它们创建一个表。绘制 y1 和 y2 变量对 x 变量的图。使用 axis padded 命令，使线条和图框不重叠。

添加图例，注意图例标签与变量名称匹配。

x = linspace(0,6,20);
y1 = cos(x);
y2 = sin(x);
tbl = table(x,y1,y2);
stairs(tbl,"x",["y1","y2"]);

% Pad x- and y-axes, and add legend
axis padded
legend

Figure contains an axes object. The axes object with xlabel x contains 2 objects of type stair.

您也可以省略 x 变量，并绘制 y1 和 y2 变量对表的行索引的图。

stairs(tbl,["y1","y2"]);
axis padded
legend

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

为阶梯图指定坐标区

打开实时脚本

您可以使用 tiledlayout 和 nexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。通过将坐标区对象指定为 stairs 的第一个参量，在坐标区中创建单独的阶梯图。

x = linspace(0,2*pi);
y1 = 5*sin(x);
y2 = sin(5*x);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
stairs(ax1,x,y1)

% Bottom plot
ax2 = nexttile;  
stairs(ax2,x,y2)

Figure contains 2 axes objects. Axes object 1 contains an object of type stair. Axes object 2 contains an object of type stair.

创建并修改阶梯图

打开实时脚本

创建两个数据序列的阶梯图并返回两个阶梯图对象。

X = linspace(0,1,30)';
Y = [cos(10*X), exp(X).*sin(10*X)];
h = stairs(X,Y);

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

对第一个数据序列使用小圆形标记。对第二个序列使用填充品红色的圆形。使用圆点表示法设置属性。

h(1).Marker = 'o';
h(1).MarkerSize = 4;
h(2).Marker = 'o';
h(2).MarkerFaceColor = 'm';

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

使用绘图函数创建一个阶梯图

打开实时脚本

在 0 和 $4 π$ 区间内的 50 个均匀分布的值处计算两个余弦函数并使用 plot 创建一个阶梯图。

X = linspace(0,4*pi,50)';
Y = [0.5*cos(X), 2*cos(X)];
[xb,yb] = stairs(X,Y);

stairs 返回两个大小相等的矩阵 xb 和 yb，但没有绘图。

使用 plot 可通过 xb 和 yb 创建阶梯图。

figure
plot(xb,yb)

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

输入参数

全部折叠

`Y` — y 值
向量或矩阵

y 值，指定为向量或矩阵。如果 Y 是向量，stairs 创建一个阶梯图对象。如果 Y 是矩阵，stairs 为每个矩阵列绘制一行，并为每个列创建一个单独的阶梯图对象。

`X` — x 值
向量或矩阵

x 值，指定为向量或矩阵。如果 Y 为向量，X 必须是大小相同的向量。如果 Y 为矩阵，X 必须是大小相同的矩阵或长度等于 Y 中的行数的向量。

`LineSpec` — 线型、标记和颜色
字符串标量 | 字符向量

线型、标记和颜色，指定为包含符号的字符串标量或字符向量。符号可以按任意顺序显示。您不需要同时指定所有三个特征（线型、标记和颜色）。例如，如果忽略线型，只指定标记，则绘图只显示标记，不显示线条。

示例: "--or" 是带有圆形标记的红色虚线。

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线

标记	描述	生成的标记
`"o"`	圆圈
`"+"`	加号
`"*"`	星号
`"."`	点
`"x"`	叉号
`"_"`	水平线条
`"\|"`	垂直线条
`"square"`	方形
`"diamond"`	菱形
`"^"`	上三角
`"v"`	下三角
`">"`	右三角
`"<"`	左三角
`"pentagram"`	五角形
`"hexagram"`	六角形

颜色名称	短名称	RGB 三元组
`"red"`	`"r"`	`[1 0 0]`
`"green"`	`"g"`	`[0 1 0]`
`"blue"`	`"b"`	`[0 0 1]`
`"cyan"`	`"c"`	`[0 1 1]`
`"magenta"`	`"m"`	`[1 0 1]`
`"yellow"`	`"y"`	`[1 1 0]`
`"black"`	`"k"`	`[0 0 0]`
`"white"`	`"w"`	`[1 1 1]`

`tbl` — 源表
表 | 时间表

包含要绘制的数据的源表，指定为表或时间表。

`yvar` — 包含 y 坐标的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | `vartype()`

包含 y 坐标的表变量，使用下表中的索引方案之一指定。

索引方案示例

索引方案	示例
变量名称：字符串、字符向量或元胞数组。 `pattern` 对象。	`"A"` 或 `'A'` - 名为 `A` 的变量 `["A","B"]` 或 `{'A','B'}` - 两个名为 `A` 和 `B` 的变量 `"Var"+digitsPattern(1)` - 变量名为 `"Var"` 后跟一个数字
变量索引：引用变量在表中位置的索引编号。由数字组成的向量。逻辑向量。通常，此向量的长度与变量的数目相同，但可以省略尾部的 `0` 或 `false` 值。	`3` - 表中的第三个变量 `[2 3]` - 表中的第二个和第三个变量 `[false false true]` - 第三个变量
变量类型： `vartype` 下标，用于选择指定类型的变量。	`vartype("categorical")` - 包含分类值的所有变量

变量名称：

字符串、字符向量或元胞数组。
pattern 对象。

"A" 或 'A' - 名为 A 的变量
["A","B"] 或 {'A','B'} - 两个名为 A 和 B 的变量
"Var"+digitsPattern(1) - 变量名为 "Var" 后跟一个数字

变量索引：

引用变量在表中位置的索引编号。
由数字组成的向量。
逻辑向量。通常，此向量的长度与变量的数目相同，但可以省略尾部的 0 或 false 值。

3 - 表中的第三个变量
[2 3] - 表中的第二个和第三个变量
[false false true] - 第三个变量

变量类型：

vartype 下标，用于选择指定类型的变量。

vartype("categorical") - 包含分类值的所有变量

您指定的表变量可以包含数值、分类、日期时间或持续时间值。如果 xvar 和 yvar 都指定多个变量，则变量的数目必须相同。

示例: stairs(tbl,"x",["y1","y2"]) 为 y 坐标指定名为 y1 和 y2 的表变量。

示例: stairs(tbl,"x",2) 为 y 坐标指定第二个变量。

示例: stairs(tbl,"x",vartype("numeric")) 为 y 坐标指定所有数值变量。

`xvar` — 包含 x 坐标的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | `vartype()`

包含 x 坐标的表变量，使用下表中的索引方案之一指定。

索引方案示例

索引方案	示例
变量名称：字符串、字符向量或元胞数组。 `pattern` 对象。	`"A"` 或 `'A'` - 名为 `A` 的变量 `["A","B"]` 或 `{'A','B'}` - 两个名为 `A` 和 `B` 的变量 `"Var"+digitsPattern(1)` - 变量名为 `"Var"` 后跟一个数字
变量索引：引用变量在表中位置的索引编号。由数字组成的向量。逻辑向量。通常，此向量的长度与变量的数目相同，但可以省略尾部的 `0` 或 `false` 值。	`3` - 表中的第三个变量 `[2 3]` - 表中的第二个和第三个变量 `[false false true]` - 第三个变量
变量类型： `vartype` 下标，用于选择指定类型的变量。	`vartype("categorical")` - 包含分类值的所有变量

变量名称：

字符串、字符向量或元胞数组。
pattern 对象。

"A" 或 'A' - 名为 A 的变量
["A","B"] 或 {'A','B'} - 两个名为 A 和 B 的变量
"Var"+digitsPattern(1) - 变量名为 "Var" 后跟一个数字

变量索引：

引用变量在表中位置的索引编号。
由数字组成的向量。
逻辑向量。通常，此向量的长度与变量的数目相同，但可以省略尾部的 0 或 false 值。

3 - 表中的第三个变量
[2 3] - 表中的第二个和第三个变量
[false false true] - 第三个变量

变量类型：

vartype 下标，用于选择指定类型的变量。

vartype("categorical") - 包含分类值的所有变量

您指定的表变量可以包含数值、分类、日期时间或持续时间值。如果 xvar 和 yvar 都指定多个变量，则变量的数目必须相同。

示例: stairs(tbl,["x1","x2"],"y") 为 x 坐标指定名为 x1 和 x2 的表变量。

示例: stairs(tbl,2,"y") 为 x 坐标指定第二个变量。

示例: stairs(tbl,vartype("numeric"),"y") 为 x 坐标指定所有数值变量。

`ax` — `Axes` 对象
`Axes` 对象

Axes 对象。如果未指定坐标区，则 stairs 在当前坐标区中绘图。

名称-值参数

全部折叠

以 Name1=Value1,...,NameN=ValueN 的形式指定可选参量对组，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: "Marker","s","MarkerFaceColor","red" 使用红色正方形标记绘制阶梯图。

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

`LineStyle` — 线型
`"-"` (默认) | `"--"` | `":"` | `"-."` | `"none"`

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

线型	描述	表示的线条
`"-"`	实线
`"--"`	虚线
`":"`	点线
`"-."`	点划线
`"none"`	无线条	无线条

`LineWidth` — 线条宽度
`0.5` (默认) | 正值

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

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值，则线条显示为一个像素的宽度。

`Color` — 线条颜色
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"`	不适用	不适用	不适用	无颜色

下表列出了浅色和深色主题中绘图的默认调色板。

调色板调色板颜色

调色板	调色板颜色
`"gem"` - 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
`"glow"` - 深色主题默认值

"gem" - 浅色主题默认值

在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

您可以使用 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)) 获取十六进制颜色代码。

示例: "blue"

示例: [0 0 1]

示例: "#0000FF"

`Marker` — 标记符号
`"none"` (默认) | `"o"` | `"+"` | `"*"` | `"."` | ...

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

标记	描述	生成的标记
`"o"`	圆圈
`"+"`	加号
`"*"`	星号
`"."`	点
`"x"`	叉号
`"_"`	水平线条
`"\|"`	垂直线条
`"square"`	方形
`"diamond"`	菱形
`"^"`	上三角
`"v"`	下三角
`">"`	右三角
`"<"`	左三角
`"pentagram"`	五角形
`"hexagram"`	六角形
`"none"`	无标记	不适用

`MarkerSize` — 标记大小
`6` (默认) | 正值

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

`MarkerEdgeColor` — 标记轮廓颜色
`"auto"` (默认) | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

标记轮廓颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "auto" 使用与 Color 属性相同的颜色。

对于自定义颜色，请指定 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"`	不适用	不适用	不适用	无颜色

下表列出了浅色和深色主题中绘图的默认调色板。

调色板调色板颜色

调色板	调色板颜色
`"gem"` - 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
`"glow"` - 深色主题默认值

"gem" - 浅色主题默认值

在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

`MarkerFaceColor` — 标记填充颜色
`"none"` (默认) | `"auto"` | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

标记填充颜色，指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"auto" 选项使用与父坐标区的 Color 属性相同的颜色。如果您指定 "auto"，并且坐标区图框不可见，则标记填充颜色为图窗的颜色。

对于自定义颜色，请指定 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"`	不适用	不适用	不适用	无颜色

下表列出了浅色和深色主题中绘图的默认调色板。

调色板调色板颜色

调色板	调色板颜色
`"gem"` - 浅色主题默认值在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。
`"glow"` - 深色主题默认值

"gem" - 浅色主题默认值

在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。

Sample of the "gem" color palette

"glow" - 深色主题默认值

Sample of the "glow" color palette

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

输出参量

全部折叠

`h` — `Stair` 对象
`Stair` 对象

Stair 对象。这些是唯一标识符，可以用来在创建特定 Stair 对象后查询和修改该对象的属性。

`xb` — 用于 `plot` 的 x 值
向量或矩阵

用于 plot 的 x 值，以向量或矩阵的形式返回。xb 包含能够让 plot(xb,yb) 创建阶梯图的相应值。

`yb` — 用于 `plot` 的 y 值
向量或矩阵

用于 plot 的 y 值，以向量或矩阵的形式返回。yb 包含能够让 plot(xb,yb) 创建阶梯图的相应值。

扩展功能

全部展开

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

stairs 函数支持 GPU 数组输入，但有以下用法说明和限制：

此函数接受 GPU 数组，但不在 GPU 上运行。

有关详细信息，请参阅在 GPU 上运行 MATLAB 函数 (Parallel Computing Toolbox)。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

用法说明和限制：

此函数在分布式数组上运行，但在客户端 MATLAB^® 中执行。

有关详细信息，请参阅使用分布式数组运行 MATLAB 函数 (Parallel Computing Toolbox)。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 将表直接传递给 `stairs`

通过将表传递给 stairs 函数并后跟要绘制的变量来创建图。当您将数据指定为表时，会自动使用表变量名称对轴标签和图例（如果有）进行标注。

stairs

语法

说明

向量和矩阵数据

表数据

其他选项

示例

绘制单数据序列

绘制多个数据序列

在指定的 x 值位置绘制单个数据序列

在指定的 x 值处绘制多个数据序列

在唯一的 x 值集合处绘制多个数据序列

指定线型、标记符号和颜色

指定其他样式选项

绘制表中的数据

在一个坐标区上绘制多个表变量

为阶梯图指定坐标区

创建并修改阶梯图

使用绘图函数创建一个阶梯图

输入参数

Y — y 值 向量或矩阵

X — x 值 向量或矩阵

LineSpec — 线型、标记和颜色 字符串标量 | 字符向量

tbl — 源表 表 | 时间表

yvar — 包含 y 坐标的表变量 字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()

xvar — 包含 x 坐标的表变量 字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype()

ax — Axes 对象 Axes 对象

名称-值参数

LineStyle — 线型 "-" (默认) | "--" | ":" | "-." | "none"

LineWidth — 线条宽度 0.5 (默认) | 正值

Color — 线条颜色 RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

Marker — 标记符号 "none" (默认) | "o" | "+" | "*" | "." | ...

MarkerSize — 标记大小 6 (默认) | 正值

MarkerEdgeColor — 标记轮廓颜色 "auto" (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

MarkerFaceColor — 标记填充颜色 "none" (默认) | "auto" | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

输出参量

h — Stair 对象 Stair 对象

xb — 用于 plot 的 x 值 向量或矩阵

yb — 用于 plot 的 y 值 向量或矩阵

扩展功能

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组 使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

版本历史记录

R2022b: 将表直接传递给 stairs

另请参阅

函数

属性

主题

`Y` — y 值
向量或矩阵

`X` — x 值
向量或矩阵

`LineSpec` — 线型、标记和颜色
字符串标量 | 字符向量

`tbl` — 源表
表 | 时间表

`yvar` — 包含 y 坐标的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | `vartype()`

`xvar` — 包含 x 坐标的表变量
字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | `vartype()`

`ax` — `Axes` 对象
`Axes` 对象

`LineStyle` — 线型
`"-"` (默认) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — 线条宽度
`0.5` (默认) | 正值

`Color` — 线条颜色
RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

`Marker` — 标记符号
`"none"` (默认) | `"o"` | `"+"` | `"*"` | `"."` | ...

`MarkerSize` — 标记大小
`6` (默认) | 正值

`MarkerEdgeColor` — 标记轮廓颜色
`"auto"` (默认) | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

`MarkerFaceColor` — 标记填充颜色
`"none"` (默认) | `"auto"` | RGB 三元组 | 十六进制颜色代码 | `"r"` | `"g"` | `"b"` | ...

`h` — `Stair` 对象
`Stair` 对象

`xb` — 用于 `plot` 的 x 值
向量或矩阵

`yb` — 用于 `plot` 的 y 值
向量或矩阵

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

R2022b: 将表直接传递给 `stairs`