stem3
绘制三维离散序列数据
语法
说明
向量和矩阵数据
stem3(___,
填充圆。可将此选项与上述语法中的任何输入参量组合一起使用。"filled"
)
示例
行向量输入
使用一个行向量输入创建在 和 之间的余弦值的三维针状图。
figure X = linspace(-pi/2,pi/2,40); Z = cos(X); stem3(Z)
stem3
在等间距的 x 值位置绘制 Z
的元素对相同的 y 值的图。
列向量输入
使用一个列向量输入创建在 和 之间的余弦值的三维针状图。
figure X = linspace(-pi/2,pi/2,40)'; Z = cos(X); stem3(Z)
stem3
在等间距的 y 值位置绘制 Z
的元素对相同的 x 值的图。
矩阵输入
使用一个矩阵输入创建在 和 之间的正弦和余弦值的三维针状图。
figure X = linspace(-pi/2,pi/2,40); Z = [sin(X); cos(X)]; stem3(Z)
stem3
在等间距的 x 值位置绘制 Z
的每一行对相同的 y 值的图。
使用向量输入指定针状线条位置
创建一个三维针状图并指定针状线条沿曲线的位置。使用 view
可调整图窗中坐标区的角度。
figure X = linspace(-5,5,60); Y = cos(X); Z = X.^2; stem3(X,Y,Z) view(-8,30)
X
和 Y
确定针状线条位置。Z
确定标记高度。
使用矩阵输入指定针状线条位置
使用矩阵数据创建一个三维针状图并在 xy 平面中指定针状线条位置。
figure [X,Y] = meshgrid(0:.1:1); Z = exp(X+Y); stem3(X,Y,Z)
X
和 Y
确定针状线条位置。Z
确定标记高度。
填充标记
线型、标记符号和颜色选项
创建在 和 之间的余弦值的三维针状图。对针状图使用虚线线型,将标记符号设置为星号,以及将颜色设置为品红色。
figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'--*m')
要仅指定三个 LineSpec
选项中的两个,请在字符向量中省略第三个选项。例如,'*m'
设置标记符号和颜色并使用默认线型。
线型、标记符号和颜色选项
创建一个三维针状图并指定针状线条沿圆的位置。将针状图设置为点线样式,将标记符号设置为星号,以及将颜色设置为品红色。
figure
theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
stem3(X,Y,Z,':*m')
X
和 Y
确定针状线条位置。Z
确定标记高度。
其他样式选项
创建在 和 之间的余弦值的三维针状图。将标记符号设置为具有绿色面和品红色边的方形。
figure X = linspace(-pi,pi,40); Z = cos(X); stem3(Z,'Marker','s',... 'MarkerEdgeColor','m',... 'MarkerFaceColor','g')
绘制表中的数据
自 R2022b 开始提供
基于表数据绘图的一种便捷方法是将表传递给 stem3
函数,并指定要绘制的变量。
将 weather.csv
作为时间表 tbl
读取。然后显示该表的前三行。
tbl = readtimetable("weather.csv");
head(tbl,3)
Time WindDirection WindSpeed Humidity Temperature RainInchesPerMinute CumulativeRainfall PressureHg PowerLevel LightIntensity ____________________ _____________ _________ ________ ___________ ___________________ __________________ __________ __________ ______________ 25-Oct-2021 00:00:09 46 1 84 49.2 0 0 29.96 4.14 0 25-Oct-2021 00:01:09 45 1.6 84 49.2 0 0 29.96 4.139 0 25-Oct-2021 00:02:09 36 2.2 84 49.2 0 0 29.96 4.138 0
在 x 轴上绘制 Time
变量,在 y 轴上绘制 Temperature
变量,在 z 轴上绘制 CumulativeRainfall
变量。以 h
形式返回 Stem
对象。请注意,轴标签与表变量名称匹配。
h = stem3(tbl,"Time","Temperature","CumulativeRainfall");
通过设置 Color
属性,将绘图的颜色更改为红色。
h.Color = [0.7 0 0.2];
特定坐标区上的针状图
自 R2019b 开始提供
您可以使用 tiledlayout
和 nexttile
函数显示分块图。调用 tiledlayout
函数以创建一个 2×1 分块图布局。调用 nexttile
函数以创建坐标区对象 ax1
和 ax2
。通过将坐标区对象指定为 stem3
的第一个参量,在坐标区中创建单独的针状图。
X = linspace(-2,2,50); Y = X.^3; Z = exp(X); tiledlayout(2,1) % Top plot ax1 = nexttile; stem(ax1,X,Z) % Bottom plot ax2 = nexttile; stem3(ax2,X,Y,Z)
创建后修改针状序列
创建一个三维针状图并返回针状序列对象。
X = linspace(0,2);
Y = X.^3;
Z = exp(X).*cos(Y);
h = stem3(X,Y,Z,'filled');
将颜色更改为品红色,将标记面颜色设置为黄色。使用 view
可调整图窗中坐标区的角度。使用圆点表示法设置属性。
h.Color = 'm'; h.MarkerFaceColor = 'y'; view(-10,35)
输入参数
Z
— 要显示的数据序列
向量或矩阵
要显示的数据序列,指定为向量或矩阵。stem3
将 Z
中的每个元素绘制为一个针状线条,该线条从 xy 平面开始延伸并在数据值位置终止。
如果
Z
是行向量,stem3
将在等间距的 x 值位置绘制所有元素对相同的 y 值的图。如果
Z
是列向量,stem3
将在等间距的 y 值位置绘制所有元素对相同的 x 值的图。如果
Z
是矩阵,stem3
将在等间距的 x 值位置绘制Z
的每一行对相同的 y 值的图。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| categorical
| datetime
| duration
X
— 绘制 Z
的值的位置
向量或矩阵
绘制 Z
的值的位置,指定为向量或矩阵。X
、Y
和 Z
输入必须是大小相同的向量或矩阵。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| categorical
| datetime
| duration
Y
— 绘制 Z
的值的位置
向量或矩阵
绘制 Z
的值的位置,指定为向量或矩阵。X
、Y
和 Z
输入必须是大小相同的向量或矩阵。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| 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
— 源表
表 | 时间表
包含要绘制的数据的源表,指定为表或时间表。
zvar
— 包含 z 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 z 坐标的表变量,使用下表中的索引方案之一指定。仅指定一个变量。
索引方案 | 示例 |
---|---|
变量名称:
|
|
变量索引:
|
|
变量类型:
|
|
您指定的表变量可以包含数值、逻辑、分类、日期时间或持续时间值。
示例: stem3(tbl,"x","y","z")
为 z 坐标指定名为 z
的表变量。
xvar
— 包含 x 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 x 坐标的表变量,使用下表中的索引方案之一指定。仅指定一个变量。
索引方案 | 示例 |
---|---|
变量名称:
|
|
变量索引:
|
|
变量类型:
|
|
您指定的表变量可以包含数值、逻辑、分类、日期时间或持续时间值。
示例: stem3(tbl,"x","y","z")
为 x 坐标指定名为 x
的表变量。
yvar
— 包含 y 坐标的表变量
字符串标量 | 字符向量 | 模式 | 数值标量 | 逻辑向量 | vartype()
包含 y 坐标的表变量,使用下表中的索引方案之一指定。仅指定一个变量。
索引方案 | 示例 |
---|---|
变量名称:
|
|
变量索引:
|
|
变量类型:
|
|
您指定的表变量可以包含数值、逻辑、分类、日期时间或持续时间值。
示例: stem3(tbl,"x","y","z")
为 y 坐标指定名为 y
的表变量。
ax
— Axes
对象
Axes
对象
Axes
对象。如果未指定坐标区,则 stem
在当前坐标区中绘图。
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: "LineStyle",":","MarkerFaceColor","red"
以点线形式绘制针状图并将标记面颜色设置为红色。
此处所列的属性只是一部分。有关完整列表,请参阅 Stem 属性。
LineStyle
— 线型
"-"
(默认) | "--"
| ":"
| "-."
| "none"
线型,指定为下表中列出的选项之一。
线型 | 描述 | 表示的线条 |
---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 点划线 |
|
"none" | 无线条 | 无线条 |
LineWidth
— 针状图和标记边的线条宽度
0.5
(默认) | 正值
针状图和标记边的线条宽度,指定为以磅为单位的正值。
示例: 0.75
Color
— 针状图颜色
[0 0 0]
(默认) | 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"
Marker
— 标记符号
"o"
(默认) | "+"
| "*"
| "."
| "x"
| ...
标记符号,指定为下表中列出的标记之一。
标记 | 描述 | 生成的标记 |
---|---|---|
"o" | 圆圈 |
|
"+" | 加号 |
|
"*" | 星号 |
|
"." | 点 |
|
"x" | 叉号 |
|
"_" | 水平线条 |
|
"|" | 垂直线条 |
|
"square" | 方形 |
|
"diamond" | 菱形 |
|
"^" | 上三角 |
|
"v" | 下三角 |
|
">" | 右三角 |
|
"<" | 左三角 |
|
"pentagram" | 五角形 |
|
"hexagram" | 六角形 |
|
"none" | 无标记 | 不适用 |
示例: "+"
示例: "diamond"
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" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 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" |
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" | 不适用 | 不适用 | 不适用 | 无颜色 |
以下是 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" |
输出参量
h
— Stem
对象
Stem
Stem
对象。这是一个唯一标识符,可用于在创建 Stem
对象后修改其属性。
扩展功能
GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。
分布式数组
使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。
版本历史记录
在 R2006a 之前推出R2022b: 扩展的数据类型支持
x
、y
和 z
输入参量可以是任何数值、逻辑、日期时间、持续时间或分类值。在以前的版本中,仅支持数值和逻辑值。
R2022b: 将表直接传递给 stem3
通过将表传递给 stem3
函数并后跟要绘制的变量来创建图。当您将数据指定为表时,会自动使用表变量名称对轴标签和图例(如果有)进行标注。
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:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
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)