阶梯图
全页折叠
语法
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 到 区间内的 40 个均匀分布的值处计算的正弦阶梯图。
X = linspace(0,4*pi,40);Y = sin(X);figurestairs(Y)
Y
的长度自动确定并生成 x 轴刻度。
绘制多个数据序列
打开实时脚本
创建在 0 到 区间内的 50 个均匀分布的值处计算的两个余弦函数阶梯图。
X = linspace(0,4*pi,50)';Y = [0.5*cos(X), 2*cos(X)];figurestairs(Y)
Y
中的行数自动确定并生成 x 轴刻度。
在指定的 x 值位置绘制单个数据序列
打开实时脚本
创建在 0 到 区间内均匀分布的值处计算的正弦波阶梯图。指定该图的 x 值集。
X = linspace(0,4*pi,40);Y = sin(X);figurestairs(X,Y)
绘制 Y
中的项对 X
中的对应项的图。
在指定的 x 值处绘制多个数据序列
打开实时脚本
创建在 0 到 区间内的均匀分布的值处计算的两个余弦波阶梯图。指定该图的 x 值集。
X = linspace(0,4*pi,50)';Y = [0.5*cos(X), 2*cos(X)];figurestairs(X,Y)
第一个向量输入 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)
绘制 X
的每一列对 Y
的对应列的图。
指定线型、标记符号和颜色
打开实时脚本
创建一个阶梯图,将线型设置为点划线,将标记符号设置为圆,将颜色设置为红色。
X = linspace(0,4*pi,20);Y = sin(X);figurestairs(Y, '-.or')
指定其他样式选项
打开实时脚本
使用 Name,Value
对组参量创建一个阶梯图并将线宽设置为 2,将标记符号设置为菱形,并将标记面颜色设置为青色。
X = linspace(0,4*pi,20);Y = sin(X);figurestairs(Y,'LineWidth',2,'Marker','d','MarkerFaceColor','c')
绘制表中的数据
打开实时脚本
自 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
通过设置 Color
属性,将线的颜色更改为紫色。
h.Color = [0.5 0 0.8];
在一个坐标区上绘制多个表变量
打开实时脚本
自 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 legendaxis paddedlegend
您也可以省略 x
变量,并绘制 y1
和 y2
变量对表的行索引的图。
stairs(tbl,["y1","y2"]);axis paddedlegend
为阶梯图指定坐标区
打开实时脚本
自 R2019b 开始提供
您可以使用 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 plotax1 = nexttile;stairs(ax1,x,y1)% Bottom plotax2 = nexttile; stairs(ax2,x,y2)
创建并修改阶梯图
打开实时脚本
创建两个数据序列的阶梯图并返回两个阶梯图对象。
X = linspace(0,1,30)';Y = [cos(10*X), exp(X).*sin(10*X)];h = stairs(X,Y);
对第一个数据序列使用小圆形标记。对第二个序列使用填充品红色的圆形。使用圆点表示法设置属性。
h(1).Marker = 'o';h(1).MarkerSize = 4;h(2).Marker = 'o';h(2).MarkerFaceColor = 'm';
使用绘图函数创建一个阶梯图
打开实时脚本
在 0 和 区间内的 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
创建阶梯图。
figureplot(xb,yb)
输入参数
全部折叠
Y
— y 值
向量或矩阵
y 值,指定为向量或矩阵。如果 Y
是向量,stairs
创建一个阶梯图对象。如果 Y
是矩阵,stairs
为每个矩阵列绘制一行,并为每个列创建一个单独的阶梯图对象。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
X
— x 值
向量或矩阵
x 值,指定为向量或矩阵。如果 Y
为向量,X
必须是大小相同的向量。如果 Y
为矩阵,X
必须是大小相同的矩阵或长度等于 Y
中的行数的向量。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
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 坐标的表变量,使用下表中的索引方案之一指定。
索引方案 | 示例 |
---|---|
变量名称:
|
|
变量索引:
|
|
变量类型:
|
|
您指定的表变量可以包含数值、分类、日期时间或持续时间值。如果 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 坐标的表变量,使用下表中的索引方案之一指定。
索引方案 | 示例 |
---|---|
变量名称:
|
|
变量索引:
|
|
变量类型:
|
|
您指定的表变量可以包含数值、分类、日期时间或持续时间值。如果 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 属性。
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" |
示例: "blue"
示例: [0 0 1]
示例: "#0000FF"
输出参量
全部折叠
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) 上运行来加快代码执行。
用法说明和限制:
此函数接受 GPU 数组,但不在 GPU 上运行。
有关详细信息,请参阅Run MATLAB Functions on a GPU (Parallel Computing Toolbox)。
分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。
用法说明和限制:
此函数在分布式数组上运行,但在客户端 MATLAB 中执行。
有关详细信息,请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。
版本历史记录
在 R2006a 之前推出
全部展开
R2022b: 将表直接传递给 stairs
通过将表传递给 stairs
函数并后跟要绘制的变量来创建图。当您将数据指定为表时,会自动使用表变量名称对轴标签和图例(如果有)进行标注。
另请参阅
函数
- bar | histogram | stem
属性
- Stair 属性
主题
- 绘制日期时间
- 对分类数据绘图
- Plots That Support Tables
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:
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)
Asia Pacific
- Australia (English)
- India (English)
- New Zealand (English)
- 中国
- 简体中文
- English
- 日本 (日本語)
- 한국 (한국어)
Contact your local office