阶梯图 - MATLAB stairs - MathWorks 中国 (2024)

Table of Contents
语法 说明 向量和矩阵数据 表数据 其他选项 示例 绘制单数据序列 绘制多个数据序列 在指定的 x 值位置绘制单个数据序列 在指定的 x 值处绘制多个数据序列 在唯一的 x 值集合处绘制多个数据序列 指定线型、标记符号和颜色 指定其他样式选项 绘制表中的数据 在一个坐标区上绘制多个表变量 为阶梯图指定坐标区 创建并修改阶梯图 使用绘图函数创建一个阶梯图 输入参数 Y — y 值 向量或矩阵 X — x 值 向量或矩阵 LineSpec — 线型、标记和颜色 字符串标量 | 字符向量 tbl — 源表 表 | 时间表 yvar — 包含 y 坐标的表变量字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype() xvar — 包含 x 坐标的表变量 字符串数组 | 字符向量 | 元胞数组 | 模式 | 数值标量或向量 | 逻辑向量 | vartype() ax — Axes 对象 Axes 对象 名称-值参数 Color — 线条颜色 [0 0.4470 0.7410] (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ... 输出参量 h — Stair 对象 Stair 对象 xb — 用于 plot 的 x 值 向量或矩阵 yb — 用于 plot 的 y 值 向量或矩阵 扩展功能 GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。 分布式数组使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。 版本历史记录 R2022b: 将表直接传递给 stairs 另请参阅 函数 属性 主题 MATLAB 命令 Americas Europe Asia Pacific References

阶梯图

全页折叠

  • 阶梯图 - MATLAB stairs- MathWorks 中国 (1)

阶梯图 - MATLAB stairs- MathWorks 中国 (2)

语法

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 指定的位置绘制元素。输入 XY 必须是相同大小的向量或矩阵。另外,X 可以是行或列向量,Y 必须是包含 length(X) 行的矩阵。

示例

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

表数据

示例

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

示例

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

其他选项

示例

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

示例

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

示例

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

示例

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

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

示例

全部折叠

绘制单数据序列

打开实时脚本

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

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

阶梯图 - MATLAB stairs- MathWorks 中国 (3)

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

绘制多个数据序列

打开实时脚本

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

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

阶梯图 - MATLAB stairs- MathWorks 中国 (4)

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

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

打开实时脚本

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

阶梯图 - MATLAB stairs- MathWorks 中国 (5)

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

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

打开实时脚本

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

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

阶梯图 - MATLAB stairs- MathWorks 中国 (6)

第一个向量输入 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)];figurestairs(X,Y)

阶梯图 - MATLAB stairs- MathWorks 中国 (7)

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

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

打开实时脚本

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

X = linspace(0,4*pi,20);Y = sin(X);figurestairs(Y, '-.or')

阶梯图 - MATLAB stairs- MathWorks 中国 (8)

指定其他样式选项

打开实时脚本

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

X = linspace(0,4*pi,20);Y = sin(X);figurestairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')

阶梯图 - MATLAB stairs- MathWorks 中国 (9)

绘制表中的数据

打开实时脚本

自 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

阶梯图 - MATLAB stairs- MathWorks 中国 (10)

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

h.Color = [0.5 0 0.8];

阶梯图 - MATLAB stairs- MathWorks 中国 (11)

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

打开实时脚本

自 R2022b 开始提供

创建向量 xy1y2,并使用它们创建一个表。绘制 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 legendaxis paddedlegend

阶梯图 - MATLAB stairs- MathWorks 中国 (12)

您也可以省略 x 变量,并绘制 y1y2 变量对表的行索引的图。

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

阶梯图 - MATLAB stairs- MathWorks 中国 (13)

为阶梯图指定坐标区

打开实时脚本

自 R2019b 开始提供

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

x = linspace(0,2*pi);y1 = 5*sin(x);y2 = sin(5*x);tiledlayout(2,1)% Top plotax1 = nexttile;stairs(ax1,x,y1)% Bottom plotax2 = nexttile; stairs(ax2,x,y2)

阶梯图 - MATLAB stairs- MathWorks 中国 (14)

创建并修改阶梯图

打开实时脚本

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

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

阶梯图 - MATLAB stairs- MathWorks 中国 (15)

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

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

阶梯图 - MATLAB stairs- MathWorks 中国 (16)

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

打开实时脚本

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

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

stairs 返回两个大小相等的矩阵 xbyb,但没有绘图。

使用 plot 可通过 xbyb 创建阶梯图。

figureplot(xb,yb)

阶梯图 - MATLAB stairs- MathWorks 中国 (17)

输入参数

全部折叠

Yy 值
向量或矩阵

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

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

Xx 值
向量或矩阵

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

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

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

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

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

线型描述表示的线条
"-"实线

阶梯图 - MATLAB stairs- MathWorks 中国 (18)

"--"虚线

阶梯图 - MATLAB stairs- MathWorks 中国 (19)

":"点线

阶梯图 - MATLAB stairs- MathWorks 中国 (20)

"-."点划线

阶梯图 - MATLAB stairs- MathWorks 中国 (21)

标记描述生成的标记
"o"圆圈

阶梯图 - MATLAB stairs- MathWorks 中国 (22)

"+"加号

阶梯图 - MATLAB stairs- MathWorks 中国 (23)

"*"星号

阶梯图 - MATLAB stairs- MathWorks 中国 (24)

"."

阶梯图 - MATLAB stairs- MathWorks 中国 (25)

"x"叉号

阶梯图 - MATLAB stairs- MathWorks 中国 (26)

"_"水平线条

阶梯图 - MATLAB stairs- MathWorks 中国 (27)

"|"垂直线条

阶梯图 - MATLAB stairs- MathWorks 中国 (28)

"square"方形

阶梯图 - MATLAB stairs- MathWorks 中国 (29)

"diamond"菱形

阶梯图 - MATLAB stairs- MathWorks 中国 (30)

"^"上三角

阶梯图 - MATLAB stairs- MathWorks 中国 (31)

"v"下三角

阶梯图 - MATLAB stairs- MathWorks 中国 (32)

">"右三角

阶梯图 - MATLAB stairs- MathWorks 中国 (33)

"<"左三角

阶梯图 - MATLAB stairs- MathWorks 中国 (34)

"pentagram"五角形

阶梯图 - MATLAB stairs- MathWorks 中国 (35)

"hexagram"六角形

阶梯图 - MATLAB stairs- MathWorks 中国 (36)

颜色名称短名称RGB 三元组外观
"red""r"[1 0 0]

阶梯图 - MATLAB stairs- MathWorks 中国 (37)

"green""g"[0 1 0]

阶梯图 - MATLAB stairs- MathWorks 中国 (38)

"blue""b"[0 0 1]

阶梯图 - MATLAB stairs- MathWorks 中国 (39)

"cyan" "c"[0 1 1]

阶梯图 - MATLAB stairs- MathWorks 中国 (40)

"magenta""m"[1 0 1]

阶梯图 - MATLAB stairs- MathWorks 中国 (41)

"yellow""y"[1 1 0]

阶梯图 - MATLAB stairs- MathWorks 中国 (42)

"black""k"[0 0 0]

阶梯图 - MATLAB stairs- MathWorks 中国 (43)

"white""w"[1 1 1]

阶梯图 - MATLAB stairs- MathWorks 中国 (44)

tbl源表
| 时间表

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

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

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

索引方案示例

变量名称:

  • 字符串、字符向量或元胞数组。

  • pattern 对象。

  • "A"'A' - 名为 A 的变量

  • ["A","B"]{'A','B'} - 两个名为 AB 的变量

  • "Var"+digitsPattern(1) - 变量名为 "Var" 后跟一个数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 由数字组成的向量。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

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

  • [false false true] - 第三个变量

变量类型:

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

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

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

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

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

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

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

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

索引方案示例

变量名称:

  • 字符串、字符向量或元胞数组。

  • pattern 对象。

  • "A"'A' - 名为 A 的变量

  • ["A","B"]{'A','B'} - 两个名为 AB 的变量

  • "Var"+digitsPattern(1) - 变量名为 "Var" 后跟一个数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 由数字组成的向量。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

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

  • [false false true] - 第三个变量

变量类型:

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

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

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

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

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

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

axAxes 对象
Axes 对象

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

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参量名称,Value 是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。

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

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

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

Color线条颜色
[0 0.4470 0.7410] (默认) | RGB 三元组 | 十六进制颜色代码 | "r" | "g" | "b" | ...

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

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

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

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

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

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

阶梯图 - MATLAB stairs- MathWorks 中国 (45)

"green""g"[0 1 0]"#00FF00"

阶梯图 - MATLAB stairs- MathWorks 中国 (46)

"blue""b"[0 0 1]"#0000FF"

阶梯图 - MATLAB stairs- MathWorks 中国 (47)

"cyan" "c"[0 1 1]"#00FFFF"

阶梯图 - MATLAB stairs- MathWorks 中国 (48)

"magenta""m"[1 0 1]"#FF00FF"

阶梯图 - MATLAB stairs- MathWorks 中国 (49)

"yellow""y"[1 1 0]"#FFFF00"

阶梯图 - MATLAB stairs- MathWorks 中国 (50)

"black""k"[0 0 0]"#000000"

阶梯图 - MATLAB stairs- MathWorks 中国 (51)

"white""w"[1 1 1]"#FFFFFF"

阶梯图 - MATLAB stairs- MathWorks 中国 (52)

"none"不适用不适用不适用无颜色

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

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

阶梯图 - MATLAB stairs- MathWorks 中国 (53)

[0.8500 0.3250 0.0980]"#D95319"

阶梯图 - MATLAB stairs- MathWorks 中国 (54)

[0.9290 0.6940 0.1250]"#EDB120"

阶梯图 - MATLAB stairs- MathWorks 中国 (55)

[0.4940 0.1840 0.5560]"#7E2F8E"

阶梯图 - MATLAB stairs- MathWorks 中国 (56)

[0.4660 0.6740 0.1880]"#77AC30"

阶梯图 - MATLAB stairs- MathWorks 中国 (57)

[0.3010 0.7450 0.9330]"#4DBEEE"

阶梯图 - MATLAB stairs- MathWorks 中国 (58)

[0.6350 0.0780 0.1840]"#A2142F"

阶梯图 - MATLAB stairs- MathWorks 中国 (59)

示例: "blue"

示例: [0 0 1]

示例: "#0000FF"

输出参量

全部折叠

hStair 对象
Stair 对象

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

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

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

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

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

扩展功能

版本历史记录

在 R2006a 之前推出

全部展开

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

另请参阅

函数

  • bar | histogram | stem

属性

  • Stair 属性

主题

  • 绘制日期时间
  • 对分类数据绘图
  • Plots That Support Tables

MATLAB 命令

您点击的链接对应于以下 MATLAB 命令:

 

请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。

阶梯图 - MATLAB stairs- MathWorks 中国 (60)

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:

Americas

Europe

Asia Pacific

Contact your local office

阶梯图 - MATLAB stairs
- MathWorks 中国 (2024)

References

Top Articles
Latest Posts
Article information

Author: Greg Kuvalis

Last Updated:

Views: 5866

Rating: 4.4 / 5 (55 voted)

Reviews: 86% of readers found this page helpful

Author information

Name: Greg Kuvalis

Birthday: 1996-12-20

Address: 53157 Trantow Inlet, Townemouth, FL 92564-0267

Phone: +68218650356656

Job: IT Representative

Hobby: Knitting, Amateur radio, Skiing, Running, Mountain biking, Slacklining, Electronics

Introduction: My name is Greg Kuvalis, I am a witty, spotless, beautiful, charming, delightful, thankful, beautiful person who loves writing and wants to share my knowledge and understanding with you.