Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

stem3

绘制三维离散序列数据

  • Plot 3-D discrete sequence data

说明

示例

stem3(Z)Z 中的各项绘制为针状图,这些针状图从 xy 平面开始延伸并在各项值处以圆圈终止。xy 平面中的针状线条位置是自动生成的。

示例

stem3(X,Y,Z)Z 中的各项绘制为针状图,这些针状图从 xy 平面开始延伸,其中 XY 指定 xy 平面中的针状图位置。XYZ 输入必须是大小相同的向量或矩阵。

示例

stem3(___,'filled') 填充圆。可以将此选项与前面语法中的任何输入参数组合一起使用。

示例

stem3(___,LineSpec) 指定线型、标记符号和颜色。

示例

stem3(___,Name,Value) 使用一个或多个名称-值对组参数修改针状图。

示例

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

示例

h = stem3(___) 返回 Stem 对象 h

示例

全部折叠

使用一个行向量输入创建在 -π/2π/2 之间的余弦值的三维针状图。

figure
X = linspace(-pi/2,pi/2,40);
Z = cos(X);
stem3(Z)

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

stem3 在等间距的 x 值位置绘制 Z 的元素对相同的 y 值的图。

使用一个列向量输入创建在 -π/2π/2 之间的余弦值的三维针状图。

figure
X = linspace(-pi/2,pi/2,40)';
Z = cos(X);
stem3(Z)

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

stem3 在等间距的 y 值位置绘制 Z 的元素对相同的 x 值的图。

使用一个矩阵输入创建在 -π/2π/2 之间的正弦和余弦值的三维针状图。

figure
X = linspace(-pi/2,pi/2,40);
Z = [sin(X); cos(X)];
stem3(Z)

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

stem3 在等间距的 x 值位置绘制 Z 的每一行对相同的 y 值的图。

创建一个三维针状图并指定针状线条沿曲线的位置。使用 view 可调整图窗中坐标区的角度。

figure
X = linspace(-5,5,60);
Y = cos(X);
Z = X.^2;
stem3(X,Y,Z)
view(-8,30)

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

XY 确定针状线条位置。Z 确定标记高度。

使用矩阵数据创建一个三维针状图并在 xy 平面中指定针状线条位置。

figure
[X,Y] = meshgrid(0:.1:1);
Z = exp(X+Y);
stem3(X,Y,Z)

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

XY 确定针状线条位置。Z 确定标记高度。

创建在 -ππ 之间的余弦值的三维针状图并填充标记。

X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'filled')

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

创建在 -ππ 之间的余弦值的三维针状图。对针状图使用虚线线型,将标记符号设置为星号,以及将颜色设置为品红色。

figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'--*m')

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

要仅指定三个 LineSpec 选项中的两个,请在字符向量中省略第三个选项。例如,'*m' 设置标记符号和颜色并使用默认线型。

创建一个三维针状图并指定针状线条沿圆的位置。将针状图设置为点线样式,将标记符号设置为星号,以及将颜色设置为品红色。

figure
theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
stem3(X,Y,Z,':*m')

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

XY 确定针状线条位置。Z 确定标记高度。

创建在 -ππ 之间的余弦值的三维针状图。将标记符号设置为具有绿色面和品红色边的方形。

figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'Marker','s',...
     'MarkerEdgeColor','m',...
     'MarkerFaceColor','g')

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

从 R2019b 开始,您可以使用 tiledlayoutnexttile 函数显示分块图。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1ax2。通过将坐标区对象指定为 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)

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

创建一个三维针状图并返回针状序列对象。

X = linspace(0,2);
Y = X.^3;
Z = exp(X).*cos(Y);
h = stem3(X,Y,Z,'filled');

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

将颜色更改为品红色,将标记面颜色设置为黄色。使用 view 可调整图窗中坐标区的角度。使用圆点表示法设置属性。

h.Color = 'm';
h.MarkerFaceColor = 'y';
view(-10,35)

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

输入参数

全部折叠

要显示的数据序列,指定为向量或矩阵。stem3Z 中的每个元素绘制为一个针状线条,该线条从 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

绘制 Z 的值的位置,指定为向量或矩阵。XYZ 输入必须是大小相同的向量或矩阵。

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

绘制 Z 的值的位置,指定为向量或矩阵。XYZ 输入必须是大小相同的向量或矩阵。

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

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

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

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

Sample of solid line

'--'虚线

Sample of dashed line

':'点线

Sample of dotted line

'-.'点划线

Sample of dash-dotted line, with alternating dashes and dots

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

Sample of circle marker

'+'加号

Sample of plus sign marker

'*'星号

Sample of asterisk marker

'.'

Sample of point marker

'x'叉号

Sample of cross marker

'_'水平线条

Sample of horizontal line marker

'|'垂直线条

Sample of vertical line marker

's'方形

Sample of square marker

'd'菱形

Sample of diamond line marker

'^'上三角

Sample of upward-pointing triangle marker

'v'下三角

Sample of downward-pointing triangle marker

'>'右三角

Sample of right-pointing triangle marker

'<'左三角

Sample of left-pointing triangle marker

'p'五角形

Sample of pentagram marker

'h'六角形

Sample of hexagram marker

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

Sample of the color red

'green''g'[0 1 0]

Sample of the color green

'blue''b'[0 0 1]

Sample of the color blue

'cyan' 'c'[0 1 1]

Sample of the color cyan

'magenta''m'[1 0 1]

Sample of the color magenta

'yellow''y'[1 1 0]

Sample of the color yellow

'black''k'[0 0 0]

Sample of the color black

'white''w'[1 1 1]

Sample of the color white

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

名称-值参数

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

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

示例: 'LineStyle',':','MarkerFaceColor','red' 以点线形式绘制针状图并将标记面颜色设置为红色。

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

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

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

Sample of solid line

'--'虚线

Sample of dashed line

':'点线

Sample of dotted line

'-.'点划线

Sample of dash-dotted line, with alternating dashes and dots

'none'无线条无线条

针状图和标记边的线条宽度,指定为以磅为单位的正值。

示例: 0.75

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

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

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

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

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

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

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'不适用不适用不适用无颜色

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

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

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

示例: 'blue'

示例: [0 0 1]

示例: '#0000FF'

标记符号,指定为下表中列出的标记之一。

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

Sample of circle marker

'+'加号

Sample of plus sign marker

'*'星号

Sample of asterisk marker

'.'

Sample of point marker

'x'叉号

Sample of cross marker

'_'水平线条

Sample of horizontal line marker

'|'垂直线条

Sample of vertical line marker

's'方形

Sample of square marker

'd'菱形

Sample of diamond line marker

'^'上三角

Sample of upward-pointing triangle marker

'v'下三角

Sample of downward-pointing triangle marker

'>'右三角

Sample of right-pointing triangle marker

'<'左三角

Sample of left-pointing triangle marker

'p'五角形

Sample of pentagram marker

'h'六角形

Sample of hexagram marker

'none'无标记不适用

示例: '+'

示例: 'diamond'

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

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

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

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

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

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

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

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'不适用不适用不适用无颜色

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

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

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

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

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

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

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

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

Sample of the color red

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

Sample of the color green

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

Sample of the color blue

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

Sample of the color cyan

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

Sample of the color magenta

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

Sample of the color yellow

'black''k'[0 0 0]'#000000'

Sample of the color black

'white''w'[1 1 1]'#FFFFFF'

Sample of the color white

'none'不适用不适用不适用无颜色

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

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

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]'#D95319'

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]'#EDB120'

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]'#7E2F8E'

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]'#77AC30'

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]'#4DBEEE'

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]'#A2142F'

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

输出参数

全部折叠

Stem 对象。这是一个唯一标识符,可用于在创建 Stem 对象后修改其属性。

扩展功能

版本历史记录

在 R2006a 之前推出

另请参阅

函数

属性