scatter3

scatter3(tbl,xvar,yvar,zvar) 绘制表 tbl 中的变量 xvar、yvar 和 zvar。要绘制一个数据集，请为 xvar、yvar 和 zvar 各指定一个变量。要绘制多个数据集，请为其中至少一个参数指定多个变量。对于指定多个变量的参数，指定的变量数目必须相同。（自 R2021b 开始提供）

示例

scatter3(tbl,xvar,yvar,zvar,'filled') 用实心圆绘制表中的指定变量。（自 R2021b 开始提供）

其他选项

示例

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

示例

scatter3(___,Name,Value) 通过使用一个或多个名称-值参数设置属性来修改散点图。例如：

scatter3(x,y,z,'LineWidth',2) 创建一个标记轮廓为两磅的散点图。
scatter3(tbl,'MyX','MyY','MyZ','ColorVariable','MyColors') 根据表中的数据创建一个散点图，并使用表中的数据自定义标记颜色。

有关属性的完整列表，请参阅 Scatter 属性。

示例

h = scatter3(___) 返回 Scatter 对象。在创建散点图后，可使用 h 修改其属性。

示例

全部折叠

创建三维散点图

打开实时脚本

创建三维散点图。使用 sphere 定义向量 x、y 和 z。

figure
[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];
scatter3(x,y,z)

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

改变标记大小

打开实时脚本

使用 sphere 定义向量 x、y 和 z。

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

定义向量 s 可指定标记大小。

S = repmat([100,50,5],numel(X),1);
s = S(:);

创建一个三维散点图并使用 view 更改图窗中坐标区的角度。

figure
scatter3(x,y,z,s)
view(40,35)

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

x、y、z 和 s 中的相应项确定每个标记的位置和大小。

改变标记颜色

打开实时脚本

使用 sphere 定义向量 x、y 和 z。

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

定义向量 s 和 c 以指定每个标记的大小和颜色。

S = repmat([50,25,10],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

创建一个三维散点图并使用 view 更改图窗中坐标区的角度。

figure
scatter3(x,y,z,s,c)
view(40,35)

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

x、y、z 和 c 中的相应项确定每个标记的位置和颜色。

填充标记

打开实时脚本

将向量 x 和 y 创建为带随机干扰的余弦和正弦值。

z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

创建一个三维散点图并填充标记。使用 view 可更改图窗中坐标区的角度。

scatter3(x,y,z,'filled')
view(-30,10)

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

设置标记类型

打开实时脚本

初始化随机数生成器以使 rand 的输出可重复。将向量 x 和 y 定义为带随机干扰的余弦和正弦值。

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

创建一个三维散点图并设置标记类型。使用 view 可更改图窗中坐标区的角度。

figure
scatter3(x,y,z,'*')
view(-30,10)

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

设置标记属性

打开实时脚本

初始化随机数生成器以使 rand 的输出可重复。将向量 x 和 y 定义为带随机干扰的余弦和正弦值。

rng default
z = linspace(0,4*pi,250);
x = 2*cos(z) + rand(1,250);
y = 2*sin(z) + rand(1,250);

创建一个三维散点图并设置标记边颜色和标记面颜色。使用 view 可更改图窗中坐标区的角度。

figure
scatter3(x,y,z,...
        'MarkerEdgeColor','k',...
        'MarkerFaceColor',[0 .75 .75])
view(-30,10)

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

绘制表中的数据

打开实时脚本

自 R2021b 开始提供

绘制表中数据的一种便捷方法是将表传递给 scatter3 函数，并指定要绘制的变量。例如，将 patients.xls 以表 tbl 形式读取。通过将 tbl 作为第一个参数传递给 scatter3 函数，后跟变量名称，绘制 Systolic、Diastolic 和 Weight 变量之间的关系。默认情况下，轴标签与变量名称匹配。

tbl = readtable('patients.xls');
scatter3(tbl,'Systolic','Diastolic','Weight');

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

您也可以同时绘制多个变量。例如，通过将 xvar 参数指定为元胞数组 {'Systolic','Diastolic'}，在同一 x 轴上绘制两个血压变量。然后，添加一个图例。图例标签与变量名称匹配。

scatter3(tbl,{'Systolic','Diastolic'},'Age','Weight');
legend

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

使用自定义标记大小和颜色绘制表数据

打开实时脚本

自 R2021b 开始提供

绘制表中数据并自定义颜色和标记大小的一种方法是设置 ColorVariable 和 SizeData 属性。您可以在调用 scatter3 函数时将这些属性设置为名称-值参数，也可以稍后在 Scatter 对象上设置它们。

例如，将 patients.xls 以表 tbl 形式读取。用填充标记绘制 Systolic、Diastolic 和 Weight 变量之间的关系。通过指定 ColorVariable 名称-值参数来更改标记颜色。将 Scatter 对象返回为 s，以便以后可以设置其他属性。

tbl = readtable('patients.xls');
s = scatter3(tbl,'Systolic','Diastolic','Weight','filled', ...
    'ColorVariable','Diastolic');

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

通过设置 SizeData 属性，将标记大小更改为 100 磅。然后添加颜色栏。

s.SizeData = 100;
colorbar

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

指定三维散点图的坐标区

打开实时脚本

自 R2019b 开始提供

您可以使用 tiledlayout 和 nexttile 函数显示分块图。

加载 seamount 数据集以获取向量 x、y 和 z。调用 tiledlayout 函数以创建一个 2×1 分块图布局。调用 nexttile 函数以创建坐标区对象 ax1 和 ax2。然后通过将坐标区对象指定为 scatter3 的第一个参数，在坐标区中创建单独的散点图。

load seamount
tiledlayout(2,1)
ax1 = nexttile;
ax2 = nexttile;
scatter3(ax1,x,y,z,'MarkerFaceColor',[0 .75 .75])
scatter3(ax2,x,y,z,'*')

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

使用句柄设置散点序列属性

打开实时脚本

使用 sphere 函数创建向量 x、y 和 z。

[X,Y,Z] = sphere(16);
x = [0.5*X(:); 0.75*X(:); X(:)];
y = [0.5*Y(:); 0.75*Y(:); Y(:)];
z = [0.5*Z(:); 0.75*Z(:); Z(:)];

创建向量 s 和 c 以指定每个标记的大小和颜色。

S = repmat([70,50,20],numel(X),1);
C = repmat([1,2,3],numel(X),1);
s = S(:);
c = C(:);

创建一个三维散点图并返回散点序列对象。

h = scatter3(x,y,z,s,c);

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

使用 RGB 三元组颜色值设置标记面颜色。使用圆点表示法设置属性。

h.MarkerFaceColor = [0 0.5 0.5];

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

输入参数

全部折叠

`X` — x 坐标
标量 | 向量 | 矩阵

x 坐标，指定为标量、向量或矩阵。X 的大小和形状取决于数据的形状。下表说明了最常见的情况。

绘图类型如何指定坐标

单点

绘图类型	如何指定坐标
单点	将 `X`、`Y` 和 `Z` 指定为标量。例如： scatter3(1,2,3)
一组点	指定 `X`、`Y` 和 `Z` 为相同长度的行向量或列向量的任意组合。例如： X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
不同颜色的多组点	如果所有数据集在一个或多个维度上共用坐标，请将共用坐标指定为向量，将其他坐标指定为矩阵。该向量的长度必须与这些矩阵的维度之一相匹配。例如，绘制两个共享同一 x 坐标的数据集。 X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 如果矩阵为方阵，`scatter3` 会为矩阵中的每列绘制一组单独的点。也可以指定 `X`、`Y` 和 `Z` 为相同大小的矩阵。在本例中，`scatter3` 绘制矩阵的列。例如，绘制四个数据集。 X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

将 X、Y 和 Z 指定为标量。例如：

scatter3(1,2,3)

一组点

指定 X、Y 和 Z 为相同长度的行向量或列向量的任意组合。例如：

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

不同颜色的多组点

如果所有数据集在一个或多个维度上共用坐标，请将共用坐标指定为向量，将其他坐标指定为矩阵。该向量的长度必须与这些矩阵的维度之一相匹配。例如，绘制两个共享同一 x 坐标的数据集。

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)

如果矩阵为方阵，scatter3 会为矩阵中的每列绘制一组单独的点。

也可以指定 X、Y 和 Z 为相同大小的矩阵。在本例中，scatter3 绘制矩阵的列。例如，绘制四个数据集。

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

`Y` — y 坐标
标量 | 向量 | 矩阵

y 坐标，指定为标量、向量或矩阵。y 的大小和形状取决于数据的形状。下表说明了最常见的情况。

绘图类型如何指定坐标

单点

绘图类型	如何指定坐标
单点	将 `X`、`Y` 和 `Z` 指定为标量。例如： scatter3(1,2,3)
一组点	指定 `X`、`Y` 和 `Z` 为相同长度的行向量或列向量的任意组合。例如： X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
不同颜色的多组点	如果所有数据集在一个或多个维度上共用坐标，请将共用坐标指定为向量，将其他坐标指定为矩阵。该向量的长度必须与这些矩阵的维度之一相匹配。例如，绘制两个共享同一 x 坐标的数据集。 X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 如果矩阵为方阵，`scatter3` 会为矩阵中的每列绘制一组单独的点。也可以指定 `X`、`Y` 和 `Z` 为相同大小的矩阵。在本例中，`scatter3` 绘制矩阵的列。例如，绘制四个数据集。 X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

将 X、Y 和 Z 指定为标量。例如：

scatter3(1,2,3)

一组点

指定 X、Y 和 Z 为相同长度的行向量或列向量的任意组合。例如：

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

不同颜色的多组点

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)

如果矩阵为方阵，scatter3 会为矩阵中的每列绘制一组单独的点。

也可以指定 X、Y 和 Z 为相同大小的矩阵。在本例中，scatter3 绘制矩阵的列。例如，绘制四个数据集。

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

`Z` — z 坐标
标量 | 向量 | 矩阵

z 坐标，指定为标量、向量或矩阵。Z 的大小和形状取决于数据的形状。下表说明了最常见的情况。

绘图类型如何指定坐标

单点

绘图类型	如何指定坐标
单点	将 `X`、`Y` 和 `Z` 指定为标量。例如： scatter3(1,2,3)
一组点	指定 `X`、`Y` 和 `Z` 为相同长度的行向量或列向量的任意组合。例如： X = [1 2 3 4]; Y = [5; 6; 7; 8]; Z = [9 10 11 12]; scatter3(X,Y,Z)
不同颜色的多组点	如果所有数据集在一个或多个维度上共用坐标，请将共用坐标指定为向量，将其他坐标指定为矩阵。该向量的长度必须与这些矩阵的维度之一相匹配。例如，绘制两个共享同一 x 坐标的数据集。 X = [1 2 3 4]; Y = [4 5 6 7; 8 9 10 11]; Z = [10 11 12 13; 14 15 16 17]; scatter3(X,Y,Z) 如果矩阵为方阵，`scatter3` 会为矩阵中的每列绘制一组单独的点。也可以指定 `X`、`Y` 和 `Z` 为相同大小的矩阵。在本例中，`scatter3` 绘制矩阵的列。例如，绘制四个数据集。 X = [1 3 5 6; 2 4 6 8]; Y = [10 25 45 61; 20 40 60 70]; Z = [12 5 6 8; 9 13 2 7]; scatter3(X,Y,Z)

将 X、Y 和 Z 指定为标量。例如：

scatter3(1,2,3)

一组点

指定 X、Y 和 Z 为相同长度的行向量或列向量的任意组合。例如：

X = [1 2 3 4];
Y = [5; 6; 7; 8];
Z = [9 10 11 12];
scatter3(X,Y,Z)

不同颜色的多组点

X = [1 2 3 4];
Y = [4 5 6 7; 8 9 10 11];
Z = [10 11 12 13; 14 15 16 17];
scatter3(X,Y,Z)

如果矩阵为方阵，scatter3 会为矩阵中的每列绘制一组单独的点。

也可以指定 X、Y 和 Z 为相同大小的矩阵。在本例中，scatter3 绘制矩阵的列。例如，绘制四个数据集。

X = [1 3 5 6; 2 4 6 8];
Y = [10 25 45 61; 20 40 60 70];
Z = [12 5 6 8; 9 13 2 7];
scatter3(X,Y,Z)

`S` — 标记大小
36 （默认） | 数值标量 | 行或列向量 | 矩阵 | `[]`

标记大小，指定为数值标量、向量、矩阵或空数组 ([])。大小控制每个标记的面积（以平方磅为单位）。空数组指定 36 磅的默认大小。指定大小的方式取决于您如何指定 X、Y 和 Z，以及您所需的绘图外观。下表说明了最常见的情况。

标记大小 X、Y 和 Z S 示例

标记大小	`X`、`Y` 和 `Z`	`S`	示例
所有点的大小均相同	针对 `X`、`Y` 和 `Z` 所述的向量或矩阵的任意有效组合	标量	将 `X` 指定为向量，将 `Y` 和 `Z` 指定为矩阵，将 `S` 指定为标量。 X = [1 2 3 4]; Y = [5 6 7 8; 9 10 11 12]; Z = [13 14 15 16; 17 18 19 20]; scatter3(X,Y,Z,100)
每个点的大小不同	相同长度的向量	与 `X`、`Y` 和 `Z` 长度相同的向量。有至少一个维度与 `X`、`Y` 和 `Z` 长度匹配的矩阵。指定矩阵对于在每个 (x,y,z) 位置显示具有不同大小的多个标记非常有用。	将 `X`、`Y`、`Z` 和 `S` 指定为向量。 X = [1 2 3 4]; Y = [4 5 6 7]; Z = [8 9 10 11]; S = [80 150 700 50]; scatter3(X,Y,Z,S) 将 `X`、`Y` 和 `Z` 指定为向量，将 `S` 指定为矩阵。 X = [1 2 3 4]; Y = [5 6 7 8]; Z = [9 10 11 12]; S = [80 30; 150 900; 50 500; 200 350]; scatter3(X,Y,Z,S)
每个点的大小不同	`X`、`Y` 或 `Z` 中有至少一个是用于绘制多个数据集的矩阵	其元素数与每个数据集中的点数相同的向量。与 `X`、`Y` 或 `Z` 矩阵大小相同的矩阵。	将 `X` 指定为向量，将 `Y` 和 `Z` 指定为矩阵，将 `S` 指定为向量。 X = [1 2 3 4]; Y = [1 6; 3 8; 2 7; 4 9]; Z = [2 8; 3 10; 4 7; 4 12]; S = [80 150 200 350]; scatter3(X,Y,Z,S) 将 `X` 指定为向量，将 `Y`、`Z` 和 `S` 指定为矩阵。 X = [1 2 3 4]; Y = [1 6; 3 8; 2 7; 4 9]; Z = [10 11; 12 13; 14 15; 16 17]; S = [80 30; 150 900; 50 2000; 200 350]; scatter3(X,Y,Z,S)

所有点的大小均相同

针对 X、Y 和 Z 所述的向量或矩阵的任意有效组合

标量

将 X 指定为向量，将 Y 和 Z 指定为矩阵，将 S 指定为标量。

X = [1 2 3 4];
Y = [5 6 7 8; 9 10 11 12];
Z = [13 14 15 16; 17 18 19 20];
scatter3(X,Y,Z,100)

每个点的大小不同

相同长度的向量

与 X、Y 和 Z 长度相同的向量。
有至少一个维度与 X、Y 和 Z 长度匹配的矩阵。指定矩阵对于在每个 (x,y,z) 位置显示具有不同大小的多个标记非常有用。

将 X、Y、Z 和 S 指定为向量。

X = [1 2 3 4];
Y = [4 5 6 7];
Z = [8 9 10 11];
S = [80 150 700 50];
scatter3(X,Y,Z,S)

将 X、Y 和 Z 指定为向量，将 S 指定为矩阵。

X = [1 2 3 4];
Y = [5 6 7 8];
Z = [9 10 11 12];
S = [80 30; 150 900; 50 500; 200 350];
scatter3(X,Y,Z,S)

每个点的大小不同

X、Y 或 Z 中有至少一个是用于绘制多个数据集的矩阵

其元素数与每个数据集中的点数相同的向量。
与 X、Y 或 Z 矩阵大小相同的矩阵。

将 X 指定为向量，将 Y 和 Z 指定为矩阵，将 S 指定为向量。

X = [1 2 3 4];
Y = [1 6; 3 8; 2 7; 4 9];
Z = [2 8; 3 10; 4 7; 4 12];
S = [80 150 200 350];
scatter3(X,Y,Z,S)

将 X 指定为向量，将 Y、Z 和 S 指定为矩阵。

X = [1 2 3 4];
Y = [1 6; 3 8; 2 7; 4 9];
Z = [10 11; 12 13; 14 15; 16 17];
S = [80 30; 150 900; 50 2000; 200 350];
scatter3(X,Y,Z,S)

`C` — 标记颜色
颜色名称 | RGB 三元组 | RGB 三元组矩阵 | 由颜色图索引组成的向量

标记颜色，指定为颜色名称、RGB 三元组、RGB 三元组矩阵或由颜色图索引组成的向量。

颜色名称 - 颜色名称（如 "red"）或短名称（如 "r"）。
RGB 三元组 - 三元素行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。RGB 三元组对于创建自定义颜色很有用。
RGB 三元组矩阵 - 三列矩阵，其中的每一行均为一个 RGB 三元组。
由颜色图索引组成的向量 - 数值向量，其长度与 X、Y 和 Z 向量相同。

指定颜色的方式取决于所需的颜色方案以及是绘制一组坐标还是多组坐标。下表说明了最常见的情况。

颜色方案	指定颜色的方式	示例
对所有点使用一种颜色。	从下表中指定一种颜色名称或短名称，或指定一个 RGB 三元组。	绘制一组点，并将颜色指定为 `"red"`。 X = [1 2 3 4]; Y = [2 5 3 6]; Z = [10 6 4 7]; S = 50; scatter3(X,Y,Z,S,"red") 绘制两组点，并使用 RGB 三元组 `[1 0 0]` 将颜色指定为红色。 X = [1 2 3 4]; Y = [2 5 3 6]; Z = [2 5; 1 2; 8 4; 7 9]; S = 50; scatter3(X,Y,Z,S,[1 0 0])
使用颜色图为每个点指定不同颜色。	指定一个由数字组成的行向量或列向量。这些数字映射到当前颜色图数组中。最小值映射到颜色图中的第一行，最大值映射到最后一行。中间值线性映射到中间行。如果您的绘图有三个点，请指定一个列向量，以确保这些值被解释为颜色图索引。仅当 `X`、`Y` 和 `Z` 是向量并且 `S` 是向量或标量时，才能使用此方法。	创建一个向量 `C`，它指定四个颜色图索引。使用当前颜色图中的颜色绘制四个点。然后，将颜色图更改为 `winter`。 C = [1 2 3 4]; X = [1 2 3 4]; Y = [1 0 6 2]; Z = [2 5 3 7]; S = 50; scatter3(X,Y,Z,S,C) colormap(gca,"winter")
为每个点创建一种自定义颜色。	指定一个由 RGB 三元组组成的 m×3 矩阵，其中 m 是图中的点数。仅当 `X`、`Y` 和 `Z` 是向量并且 `S` 是向量或标量时，才能使用此方法。	创建一个矩阵 `C`，它为绿色、红色、灰色和紫色指定 RGB 三元组。然后使用这些颜色创建一个包含四个点的散点图。 C = [0 1 0; 1 0 0; 0.5 0.5 0.5; 0.6 0 1]; X = [1 2 3 4]; Y = [2 5 3 6]; Z = [10 6 4 7]; S = 50; scatter3(X,Y,Z,S,C)
为每个数据集创建一种不同颜色。	指定一个由 RGB 三元组组成的 n×3 矩阵，其中 n 为数据集个数。仅当 `X`、`Y`、`Z` 或 `S` 中有至少一个是矩阵时，才能使用此方法。	创建一个包含两个 RGB 三元组的矩阵 `C`。然后使用这些颜色绘制两个数据集。 C = [1 0 0; 0.6 0 1]; X = [1 2 3 4]; Y = [5 6 7 8]; Z = [2 5; 1 2; 8 4; 11 9]; S = 50; scatter3(X,Y,Z,S,C)

常见颜色的颜色名称和 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"`

以下是 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"`

`markertype` — 标记
`'o'` （默认） | `'+'` | `'*'` | `'.'` | `'x'` | ...

标记，指定为下表中的标记之一。

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

`'filled'` — 用于填充标记内部的选项
`'filled'`

用于填充标记内部的选项，指定为 'filled'。此选项和具有一个面的标记（例如，'o' 或 'square'）一起使用。没有面而只有边的标记无法填充，如 '+'、'*'、'.' 和 'x'。

'filled' 选项将 Scatter 对象的 MarkerFaceColor 属性设置为 'flat'，并将 MarkerEdgeColor 属性设置为 'none'，这样便可只填充标记的面，而不绘制边。

`tbl` — 源表
表 | 时间表

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

`xvar` — 包含 x 坐标的表变量
一个或多个表变量索引

包含 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 指定一个变量，为 zvar 指定一个变量。例如，将 Patients.xls 读入表 tbl 中。绘制 Height、Weight 和 Diastolic 变量。

tbl = readtable("Patients.xls");
scatter3(tbl,"Height","Weight","Diastolic")

要一起绘制多个数据集，请为 xvar、yvar 或 zvar 中的至少一个指定多个变量。如果为多个参数指定多个变量，则为每个参数指定的变量数目必须相同。

例如，在 x 轴上绘制 Weight 变量，在 y 轴上绘制 Systolic 和 Diastolic 变量，在 z 轴上绘制 Age 变量。

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

您还可以对 xvar、yvar 和 zvar 使用不同索引方案。例如，将 xvar 指定为变量名称，将 yvar 指定为索引编号，将 zvar 指定为逻辑向量。

scatter3(tbl,"Height",6,[false false true])

`yvar` — 包含 y 坐标的表变量
一个或多个表变量索引

包含 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") - 包含分类值的所有变量

绘制您的数据

您指定的表变量可以包含数值、分类、日期时间或持续时间值。

tbl = readtable("Patients.xls");
scatter3(tbl,"Height","Weight","Diastolic")

例如，在 x 轴上绘制 Weight 变量，在 y 轴上绘制 Systolic 和 Diastolic 变量，在 z 轴上绘制 Age 变量。

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

您还可以对 xvar、yvar 和 zvar 使用不同索引方案。例如，将 xvar 指定为变量名称，将 yvar 指定为索引编号，将 zvar 指定为逻辑向量。

scatter3(tbl,"Height",6,[false false true])

`zvar` — 包含 z 坐标的表变量
一个或多个表变量索引

包含 z 坐标的表变量，指定为一个或多个表变量索引。

指定表索引

使用以下任一索引方案指定所需的一个或多个变量。

索引方案示例

索引方案	示例
变量名称：字符串、字符向量或元胞数组。 `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") - 包含分类值的所有变量

绘制您的数据

您指定的表变量可以包含数值、分类、日期时间或持续时间值。

tbl = readtable("Patients.xls");
scatter3(tbl,"Height","Weight","Diastolic")

例如，在 x 轴上绘制 Weight 变量，在 y 轴上绘制 Systolic 和 Diastolic 变量，在 z 轴上绘制 Age 变量。

scatter3(tbl,"Weight",["Systolic","Diastolic"],"Age")

您还可以对 xvar、yvar 和 zvar 使用不同索引方案。例如，将 xvar 指定为变量名称，将 yvar 指定为索引编号，将 zvar 指定为逻辑向量。

scatter3(tbl,"Height",6,[false false true])

`ax` — 坐标区对象
坐标区对象

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

名称-值参数

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

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

示例： 'MarkerFaceColor','red' 将标记面颜色设置为红色。

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

`LineWidth` — 标记边的宽度
`0.5` （默认） | 正值

标记边的宽度，指定为一个正值（以磅为单位）。

示例： 0.75

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

标记轮廓颜色，指定为 "flat"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "flat" 将使用 CData 属性中的颜色。

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

示例： [0.5 0.5 0.5]

示例： "blue"

示例： "#D2F9A7"

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

标记填充颜色，指定为 "flat"、"auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"flat" 选项使用 CData 值。"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"`

示例： [0.3 0.2 0.1]

示例： "green"

示例： "#D2F9A7"

`ColorVariable` — 包含颜色数据的表变量
表变量索引

包含颜色数据的表变量，指定为源表的变量索引。

指定表索引

使用以下任一索引方案指定所需的变量。

索引方案示例

索引方案	示例
变量名称：字符串标量或字符向量。 `pattern` 对象。模式对象只能引用一个变量。	`"A"` 或 `'A'` - 名为 `A` 的变量 `"Var"+digitsPattern(1)` - 名称为 `"Var"` 的变量后跟一位数字
变量索引：引用变量在表中位置的索引编号。逻辑向量。通常，此向量的长度与变量的数目相同，但可以省略尾部的 `0` 或 `false` 值。	`3` - 表中的第三个变量 `[false false true]` - 第三个变量
变量类型： `vartype` 下标，用于选择指定类型的表变量。该下标只能引用一个变量。	`vartype("double")` - 包含双精度值的变量

变量名称：

字符串标量或字符向量。
pattern 对象。模式对象只能引用一个变量。

"A" 或 'A' - 名为 A 的变量
"Var"+digitsPattern(1) - 名称为 "Var" 的变量后跟一位数字

变量索引：

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

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

变量类型：

vartype 下标，用于选择指定类型的表变量。该下标只能引用一个变量。

vartype("double") - 包含双精度值的变量

指定颜色数据

指定 ColorVariable 属性控制标记的颜色。当 MarkerFaceColor 属性设置为 "flat" 时，变量中的数据控制标记填充颜色。当 MarkerEdgeColor 设置为 "flat" 时，数据还可以控制标记轮廓颜色。

您指定的表变量可以包含任何数值类型的值。这些值可以是以下形式之一：

线性映射到当前颜色图中的一列数字。
由 RGB 三元组组成的一个三列数组。RGB 三元组是包含三个元素的向量，其元素值指定特定颜色的红、绿和蓝分量的强度。强度必须处于范围 [0,1] 中。例如，[0.5 0.7 1] 指定浅蓝色。

当您设置 ColorVariable 属性时，MATLAB 会更新 CData 属性。

输出参数

全部折叠

`h` — `Scatter` 对象
`Scatter` 对象

Scatter 对象。这是一个唯一标识符，可用于在创建 Scatter 对象后查询和修改其属性。

扩展功能

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: 用表创建的绘图将保留轴和图例标签中的特殊字符

当您将表和一个或多个变量名称传递给 scatter3 函数时，轴和图例标签现在会显示表变量名称中包含的任何特殊字符，如下划线。以前，特殊字符解释为 TeX 或 LaTeX 字符。

例如，如果将包含名为 Sample_Number 的变量的表传递给 scatter3 函数，则下划线会出现在轴和图例标签中。在 R2022a 及更早版本中，下划线解释为下标。

版本表变量 "Sample_Number" 的标签

版本	表变量 `"Sample_Number"` 的标签
R2022b
R2022a

R2022b

Label for the variable name "Sample_Number" in R2022b. The underscore is included in the label.

R2022a

Label for the variable name "Sample_Number" in R2022a. The N character displays as a subscript.

要显示具有 TeX 或 LaTeX 格式的轴和图例标签，请手动指定标签。例如，在绘制后，使用所需的标签字符串调用 xlabel 或 legend 函数。

xlabel("Sample_Number")
legend(["Sample_Number" "Another_Legend_Label"])

R2022a: 使用矩阵一次绘制多个数据集

scatter3 函数现在接受向量和矩阵的组合作为坐标。因此，您可以一次性可视化多个数据集，而不用再在各绘图命令之间使用 hold 函数。

R2021b: 将表直接传递给 `scatter3`

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

scatter3

语法

说明

向量和矩阵数据

表数据

其他选项

示例

创建三维散点图

改变标记大小

改变标记颜色

填充标记

设置标记类型

设置标记属性

绘制表中的数据

使用自定义标记大小和颜色绘制表数据

指定三维散点图的坐标区

使用句柄设置散点序列属性

输入参数

X — x 坐标 标量 | 向量 | 矩阵

Y — y 坐标 标量 | 向量 | 矩阵

Z — z 坐标 标量 | 向量 | 矩阵

S — 标记大小 36 （默认） | 数值标量 | 行或列向量 | 矩阵 | []

C — 标记颜色 颜色名称 | RGB 三元组 | RGB 三元组矩阵 | 由颜色图索引组成的向量

常见颜色的颜色名称和 RGB 三元组

markertype — 标记 'o' （默认） | '+' | '*' | '.' | 'x' | ...

'filled' — 用于填充标记内部的选项 'filled'

tbl — 源表 表 | 时间表

xvar — 包含 x 坐标的表变量 一个或多个表变量索引

指定表索引

绘制您的数据

yvar — 包含 y 坐标的表变量 一个或多个表变量索引

指定表索引

绘制您的数据

zvar — 包含 z 坐标的表变量 一个或多个表变量索引

指定表索引

绘制您的数据

ax — 坐标区对象 坐标区对象

名称-值参数

LineWidth — 标记边的宽度 0.5 （默认） | 正值

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

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

ColorVariable — 包含颜色数据的表变量 表变量索引

指定表索引

指定颜色数据

输出参数

h — Scatter 对象 Scatter 对象

扩展功能

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

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

版本历史记录

R2022b: 用表创建的绘图将保留轴和图例标签中的特殊字符

R2022a: 使用矩阵一次绘制多个数据集

R2021b: 将表直接传递给 scatter3

另请参阅

函数

属性

主题

WeChat

`X` — x 坐标
标量 | 向量 | 矩阵

`Y` — y 坐标
标量 | 向量 | 矩阵

`Z` — z 坐标
标量 | 向量 | 矩阵

`S` — 标记大小
36 （默认） | 数值标量 | 行或列向量 | 矩阵 | `[]`

`C` — 标记颜色
颜色名称 | RGB 三元组 | RGB 三元组矩阵 | 由颜色图索引组成的向量

`markertype` — 标记
`'o'` （默认） | `'+'` | `'*'` | `'.'` | `'x'` | ...

`'filled'` — 用于填充标记内部的选项
`'filled'`

`tbl` — 源表
表 | 时间表

`xvar` — 包含 x 坐标的表变量
一个或多个表变量索引

`yvar` — 包含 y 坐标的表变量
一个或多个表变量索引

`zvar` — 包含 z 坐标的表变量
一个或多个表变量索引

`ax` — 坐标区对象
坐标区对象

`LineWidth` — 标记边的宽度
`0.5` （默认） | 正值

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

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

`ColorVariable` — 包含颜色数据的表变量
表变量索引

`h` — `Scatter` 对象
`Scatter` 对象

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

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

R2021b: 将表直接传递给 `scatter3`