17，Scatter函数

散点图 - MATLAB scatter - MathWorks 中国 https://ww2.mathworks.cn/help/matlab/ref/scatter.html#btrli6p-1

scatter

散点图

全页折叠

语法

scatter(x,y)

scatter(x,y,sz)

scatter(x,y,sz,c)

scatter(___,'filled')

scatter(___,mkr)

scatter(___,Name,Value)

scatter(ax,___)

s = scatter(___)

说明

示例

scatter(x,y) 在向量 x 和 y 指定的位置创建一个包含圆形的散点图。该类型的图形也称为气泡图。

示例

scatter(x,y,sz) 指定圆大小。要绘制大小相等的圆圈，请将 sz 指定为标量。要绘制大小不等的圆，请将 sz 指定为长度等于 x 和 y 的长度的向量。

示例

scatter(x,y,sz,c) 指定圆颜色。要以相同的颜色绘制所有圆圈，请将 c 指定为颜色名称或 RGB 三元组。要使用不同的颜色，请将 c 指定为向量或由 RGB 三元组组成的三列矩阵。

示例

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

示例

scatter(___,mkr) 指定标记类型。

示例

scatter(___,Name,Value) 使用一个或多个名称-值对组参数修改散点图。例如，'LineWidth',2 将标记轮廓宽度设置为 2 磅。

示例

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

示例

s = scatter(___) 返回 Scatter 对象。在创建散点图后，以后可使用 s 对其进行修改。

示例

全部折叠

创建散点图

尝试此示例

创建 x 为 0 和  之间的 200 个等间距值。创建 y 为带随机干扰的余弦值。然后，创建一个散点图。

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);  
scatter(x,y)

改变圆圈大小

尝试此示例

使用大小不同的圆圈创建一个散点图。以平方磅为单位指定大小

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
sz = linspace(1,100,200);
scatter(x,y,sz)

x、y 和 sz 中的相应元素确定每个圆圈的位置和大小。要按照相同的面积绘制所有圆圈，请将 sz 指定为数值标量。

改变圆圈颜色

尝试此示例

创建一个散点图并改变圆圈的颜色。

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
c = linspace(1,10,length(x));
scatter(x,y,[],c)

x、y 和 c 中的相应元素确定每个圆形的位置和颜色。scatter 函数将 c 中的元素映射到当前颜色图中的元素。

填充标记

尝试此示例

创建一个散点图并填充标记。scatter 使用标记边缘的颜色填充每个标记。

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
sz = 25;
c = linspace(1,10,length(x));
scatter(x,y,sz,c,'filled')

指定标记符号

尝试此示例

创建向量 x 和 y，作为带随机干扰的正弦和余弦值。然后，创建一个散点图，并使用面积为 140 平方磅的菱形标记。

theta = linspace(0,2*pi,150);
x = sin(theta) + 0.75*rand(1,150);
y = cos(theta) + 0.75*rand(1,150);  
sz = 140;
scatter(x,y,sz,'d')

更改标记颜色和线条宽度

尝试此示例

创建向量 x 和 y，作为带随机干扰的正弦和余弦值。创建一个散点图并设置标记边缘颜色、标记面颜色和线条宽度。

theta = linspace(0,2*pi,300);
x = sin(theta) + 0.75*rand(1,300);
y = cos(theta) + 0.75*rand(1,300);  
sz = 40;
scatter(x,y,sz,'MarkerEdgeColor',[0 .5 .5],...
              'MarkerFaceColor',[0 .7 .7],...
              'LineWidth',1.5)

指定散点图的子图

尝试此示例

创建一个包含两个子图的图窗，并向每个子图添加一个散点图。对下部子图中的散点图使用填充的菱形标记。

x = linspace(0,3*pi,200);
y = cos(x) + rand(1,200);
ax1 = subplot(2,1,1);
scatter(ax1,x,y)

ax2 = subplot(2,1,2);
scatter(ax2,x,y,'filled','d')

创建并修改散点序列

尝试此示例

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

theta = linspace(0,1,500);
x = exp(theta).*sin(100*theta);
y = exp(theta).*cos(100*theta);
s = scatter(x,y);

在创建散点序列后，使用 s 查询并设置其属性。将线宽设置为 0.6 磅。将标记边缘颜色设置为蓝色。使用 RGB 三元组颜色设置标记面。

注意：从 R2014b 开始，您可以使用圆点表示法设置属性。如果您正在使用早期版本，请改用 set 函数，例如 set(s,'LineWidth',0.6)。

s.LineWidth = 0.6;
s.MarkerEdgeColor = 'b';
s.MarkerFaceColor = [0 0.5 0.5];

输入参数

全部折叠

x - x 值
向量

x 值，指定为向量。x 和 y 必须是长度相等的向量。

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

y - y 值
向量

y 值，指定为向量。x 和 y 必须是长度相等的向量。

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

sz - 标记面积
36 （默认） | 数值标量 | 行或列向量 | []

以平方磅为单位的标记面积，指定为下列形式之一：

• 数值标量 - 以相同的大小绘制所有标记。

• 行或列向量 - 使每个标记具有不同的大小。x、y 和 sz 中的相应元素确定每个标记的位置和面积。sz 的长度必须等于 x 和 y 的长度。

• [] - 使用 36 平方磅的默认面积。

标记面积的单位为平方磅。

示例： 50

示例： [36 25 25 17 46]

c - 标记颜色
[0 0 1] （默认） | RGB 三元组 | 由 RGB 三元组组成的三列矩阵 | 向量 | 'r' | 'g' | 'b' | ...

标记颜色，指定为下列形式之一：

• RGB 三元组或颜色名称 - 使用相同的颜色绘制所有标记。

• 由 RGB 三元组组成的三列矩阵 - 对每个标记使用不同的颜色。矩阵的每行为对应标记指定一种 RGB 三元组颜色。行数必须等于 x 和 y 的长度。

• 向量 - 对每个标记使用不同的颜色，并以线性方式将 c 中的值映射到当前颜色图中的颜色。c 的长度必须等于 x 和 y 的长度。要更改坐标区的颜色图，请使用 colormap 函数。

  如果散点图中有三个点，并且您希望这些颜色成为颜色图的索引，请以三元素列向量的形式指定 c。

RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。此外，还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。

选项	说明	对应的 RGB 三元组
'red' 或 'r'	红色	[1 0 0]
'green' 或 'g'	绿色	[0 1 0]
'blue' 或 'b'	蓝色	[0 0 1]
'yellow' 或 'y'	黄色	[1 1 0]
'magenta' 或 'm'	品红色	[1 0 1]
'cyan' 或 'c'	青蓝色	[0 1 1]
'white' 或 'w'	白色	[1 1 1]
'black' 或 'k'	黑色	[0 0 0]

示例： 'k'

示例： [1 2 3 4]

mkr - 标记类型
'o' （默认） | '+' | '*' | '.' | 'x' | ...

标记类型，指定为下表中列出的值之一。

值	说明
'o'	圆圈
'+'	加号
'*'	星号
'.'	点
'x'	叉号
'square' 或 's'	方形
'diamond' 或 'd'	菱形
'^'	上三角
'v'	下三角
'>'	右三角
'<'	左三角
'pentagram' 或 'p'	五角星（五角形）
'hexagram' 或 'h'	六角星（六角形）
'none'	无标记

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

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

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

ax - 目标坐标区
Axes 对象 | PolarAxes 对象

目标坐标区，指定为 Axes 对象或 PolarAxes 对象。如果不指定坐标区或当前坐标区是笛卡尔坐标区，scatter 函数将使用当前坐标区。要在极坐标区上绘图，请指定 PolarAxes 对象作为第一个输入参数，或者使用 polarscatter 函数。

名称-值对组参数

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

此处列出的 Scatter 对象属性只是其中的一部分。有关完整列表，请参阅 Scatter 属性。

'MarkerEdgeColor' - 标记轮廓颜色
'flat' （默认） | 'none' | RGB 三元组 | 'r' | 'g' | 'b' | ...

标记轮廓颜色，指定为 'flat'、RGB 三元组或表中列出的颜色选项之一。默认值 'flat' 将使用 CData 属性中的颜色。

如果想自定义颜色，请指定一个 RGB 三元组。RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。此外，还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。

选项	说明	对应的 RGB 三元组
'red' 或 'r'	红色	[1 0 0]
'green' 或 'g'	绿色	[0 1 0]
'blue' 或 'b'	蓝色	[0 0 1]
'yellow' 或 'y'	黄色	[1 1 0]
'magenta' 或 'm'	品红色	[1 0 1]
'cyan' 或 'c'	青蓝色	[0 1 1]
'white' 或 'w'	白色	[1 1 1]
'black' 或 'k'	黑色	[0 0 0]
'none'	无颜色	不适用

示例： [0.5 0.5 0.5]

示例： 'blue'

'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]。此外，还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。

选项	说明	对应的 RGB 三元组
'red' 或 'r'	红色	[1 0 0]
'green' 或 'g'	绿色	[0 1 0]
'blue' 或 'b'	蓝色	[0 0 1]
'yellow' 或 'y'	黄色	[1 1 0]
'magenta' 或 'm'	品红色	[1 0 1]
'cyan' 或 'c'	青蓝色	[0 1 1]
'white' 或 'w'	白色	[1 1 1]
'black' 或 'k'	黑色	[0 0 0]
'none'	无颜色	不适用

示例： [0.3 0.2 0.1]

示例： 'green'

'LineWidth' - 标记边缘的宽度
0.5 （默认） | 正值

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

示例： 0.75

输出参数

全部折叠

s - Scatter 对象
Scatter 对象

Scatter 对象。在创建散点图后，可使用 s 访问和修改散点图的属性。

扩展功能

tall 数组
对行数太多而无法放入内存的数组进行计算。

另请参阅

函数

• hold | plot | scatter3

属性

• Scatter 属性

主题

• 绘制日期和持续时间图
• 对分类数据绘图

外部网站

• MATLAB 图库

在 R2006a 之前推出