散点图的外观和行为 - MATLAB - MathWorks 中国 (2024)

标记符号，指定为下表中列出的选项之一：

标记边的透明度，指定为 [0,1] 范围中的标量或 'flat'。值为 1 表示不透明，值为 0 表示完全透明。介于 0 和 1 之间的值表示半透明。

要为绘图中的每个点设置不同边透明度值，请将 AlphaData 属性设置为与 XData 属性大小相同的向量，并将 MarkerEdgeAlpha 属性设置为 'flat'。

标记面透明度，指定为 [0,1] 范围中的标量或 'flat'。值为 1 表示不透明，值为 0 表示完全透明。介于 0 和 1 之间的值表示半透明。

要为图中的每个点设置不同标记面透明度值，请将 AlphaData 属性设置为与 XData 属性大小相同的向量，并将 MarkerFaceAlpha 属性设置为 'flat'。

绘制的每个点的透明度数据，指定为与 XData 属性大小相同的数组。指定这些值后，请设置 MarkerFaceAlpha 和 MarkerEdgeAlpha 属性来控制透明度的类型。如果 MarkerFaceAlpha 和 MarkerEdgeAlpha 属性均设置为标量值，则 Scatter 对象不使用 AlphaData 值。

AlphaDataMapping 属性确定 Scatter 对象如何解释 AlphaData 属性值。

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

控制如何设置 AlphaData 属性，指定为下列值之一：

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

示例: [1 0 0; 0 1 0; 0 0 1]

控制如何设置 CData 属性，指定为下列值之一：

链接到 CData 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 CData。

默认情况下，没有链接的变量，因此该值为空字符向量 。如果您链接变量，MATLAB 不会立即更新 CData 值。若要强制更新数据值，需要使用 refreshdata 函数。

序列索引，指定为正整数或 "none"。此属性可用于重新分配 Scatter 对象的标记颜色，以使它们与其他对象的颜色匹配。默认情况下，SeriesIndex 属性是与对象的创建顺序对应的数字，从 1 开始。

在您调用绘图函数时，MATLAB 使用该编号计算用于分配颜色的索引。索引引用存储在坐标区的 ColorOrder 属性中的数组的行。当您更改 Scatter 对象的 SeriesIndex 值时，或当您更改坐标区的 ColorOrder 属性时，标记颜色会发生变化。

SeriesIndex 值 "none" 对应于不参与索引方案的中性颜色。 (自 R2023b 起)

手动颜色分配如何覆盖 SeriesIndex 行为

要手动控制标记的填充颜色，请使用以下方法之一：

手动控制标记边颜色的方式与上述方法相同，只是需要将 MarkerEdgeColor 属性设置为颜色值或 "flat"。

当您手动设置对象的颜色时，MATLAB 会禁用该对象的自动颜色选择，并允许您的颜色保持不变，而不管 SeriesIndex 属性的值如何。CDataMode 属性表示 CData 颜色是由您手动设置的还是自动设置的。值 "manual" 表示手动选择，值 "auto" 表示自动选择。

当您执行以下任一操作时，自动颜色选择将处于禁用状态：

要再次启用自动选择，请将 MarkerFaceColor、MarkerEdgeColor 或这两个属性都设置为 "flat"。将 CDataMode 属性设置为 "auto"，并将 SeriesIndex 属性设置为一个正整数。

在某些情况下，MATLAB 会将 SeriesIndex 值设置为 0，这也会禁用自动颜色选择。

标记大小，指定为下列形式之一：

以磅为单位指定这些值，其中一磅等于 1/72 英寸。要指定面积为一平方英寸的标记，请使用值 72^2。

示例: 50

控制如何设置 SizeData 属性，指定为下列值之一：

链接到 SizeData 的变量，指定为包含 MATLAB 工作区变量的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 SizeData。

默认情况下，没有链接的变量，因此该值为空字符向量 。如果您链接变量，MATLAB 不会立即更新 SizeData 值。若要强制更新数据值，需要使用 refreshdata 函数。

x 值，指定为标量或向量。散点图显示 XData 中的每个值对应的单个标记。

绘图函数的输入参量 x 设置 x 的值。XData 和 YData 的长度必须相同。

示例: [1 2 4 2 6]

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

控制如何设置 XData 属性，指定为下列值之一：

y 值，指定为标量或向量。散点图显示 YData 中的每个值对应的单个标记。

绘图函数的输入参量 y 设置 y 的值。XData 和 YData 的长度必须相同。

示例: [1 3 3 4 6]

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

控制如何设置 YData 属性，指定为下列值之一：

z 值，指定为标量或向量。

示例: [1 2 2 1 0]

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

控制如何设置 ZData 属性，指定为下列值之一：

沿 x 维度的抖动类型（点的间距），指定为下列值之一：

沿 x 维度的最大抖动量（点之间的偏移量），以数据单位指定为非负标量值。

例如，要将抖动宽度设置为邻点之间最短距离的 90%，请取 x 的唯一值之间的最小距离并按 0.9 进行缩放。

XJitterWidth = 0.9 * min(diff(unique(x)));

沿 y 维度的抖动类型（点的间距），指定为下列值之一：

沿 y 维度的最大抖动量（点之间的偏移量），以数据单位指定为非负标量值。

例如，要将抖动宽度设置为邻点之间最短距离的 90%，请取 y 的唯一值之间的最小距离并按 0.9 进行缩放。

YJitterWidth = 0.9 * min(diff(unique(y)));

沿 z 维度的抖动类型（点的间距），指定为下列值之一：

以数据单位表示的沿 z 维度的最大抖动量（点之间的偏移量），指定为非负标量值。

例如，要将抖动宽度设置为邻点之间最短距离的 90%，请取 z 的唯一值之间的最小距离并按 0.9 进行缩放。

ZJitterWidth = 0.9 * min(diff(unique(z)));

半径值，指定为向量。ThetaData 和 RData 必须是长度相等的向量。

此属性仅适用于极坐标区。

控制如何设置 RData 属性，指定为下列值之一：

链接到 RData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 RData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 RData 值。若要强制更新数据值，需要使用 refreshdata 函数。

此属性仅适用于极坐标区。

角度值，指定为向量。ThetaData 和 RData 必须是长度相等的向量。

此属性仅适用于极坐标区。

控制如何设置 ThetaData 属性，指定为下列值之一：

链接到 ThetaData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 RData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 ThetaData 值。若要强制更新数据值，需要使用 refreshdata 函数。

此属性仅适用于极坐标区。

纬度值，指定为向量。LatitudeData 和 LongitudeData 必须是长度相等的向量。

此属性仅应用于地理坐标区。

控制如何设置 LatitudeData 属性，指定为下列值之一：

此属性仅应用于地理坐标区。

链接到 LatitudeData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 RData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 LatitudeData 值。若要强制更新数据值，需要使用 refreshdata 函数。

此属性仅应用于地理坐标区。

经度值，指定为向量。LongitudeData 和 LatitudeData 必须是长度相等的向量。

此属性仅应用于地理坐标区。

控制如何设置 LongitudeData 属性，指定为下列值之一：

此属性仅应用于地理坐标区。

链接到 LongitudeData 的变量，指定为包含 MATLAB 工作区变量名称的字符向量或字符串。MATLAB 通过计算基础工作区中的变量来生成 RData。

默认情况下，没有链接的变量，因此该值为空字符向量 ''。如果您链接变量，MATLAB 不会立即更新 LatitudeData 值。若要强制更新数据值，需要使用 refreshdata 函数。

此属性仅应用于地理坐标区。

包含 x 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 XData 属性。

下表列出了可用于指定表变量的不同索引方案。

包含 y 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 YData 属性。

下表列出了可用于指定表变量的不同索引方案。

包含 z 坐标的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含数值、分类、日期时间或持续时间值。当您设置此属性时，MATLAB 会更新 ZData 属性。

下表列出了可用于指定表变量的不同索引方案。

包含极坐标图半径值的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含任何类型的数值。当您设置此属性时，MATLAB 会更新 RData 属性。此属性仅适用于极坐标区。

以下是可用于指定表变量的不同索引方案的列表。

包含极坐标图角度值的表变量，使用下表中的索引方案之一指定。您指定的变量可以包含任何类型的数值。当您设置此属性时，MATLAB 会更新 ThetaData 属性。此属性仅适用于极坐标区。

以下是可用于指定表变量的不同索引方案的列表。

包含地理图纬度值的表变量，使用下表中的索引方案之一指定。当您设置此属性时，MATLAB 会更新 LatitudeData 属性。此属性仅应用于地理坐标区。

以下是可用于指定表变量的不同索引方案的列表。

包含地理图经度值的表变量，使用下表中的索引方案之一指定。当您设置此属性时，MATLAB 会更新 LongitudeData 属性。此属性仅应用于地理坐标区。

以下是可用于指定表变量的不同索引方案的列表。

包含标记大小数据的表变量，指定为源表的变量索引。

指定表索引

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

指定大小数据

您指定的变量可以包含任何数值类型。当您设置 SizeVariable 属性时，MATLAB 会更新 SizeData 属性。

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

指定表索引

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

指定颜色数据

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

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

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

包含透明度数据的表变量，指定为源表的变量索引。

指定表索引

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

指定透明度数据

您指定的变量中的数据控制标记的透明度。值越小，越透明；值越大，越不透明。这些值可以是任何数值类型的值。

在设置 AlphaVariable 属性后，请设置 MarkerFaceAlpha 和 MarkerEdgeAlpha 属性来控制透明度的类型。如果 MarkerFaceAlpha 和 MarkerEdgeAlpha 属性都设置为标量值，则散点图对象不使用表中的数据。

当您设置此属性时，MATLAB 会更新 AlphaData 属性。

数据提示内容，指定为 DataTipTemplate 对象。您可以通过修改底层 DataTipTemplate 对象的属性来控制数据提示中显示的内容。有关属性列表，请参阅 DataTipTemplate 属性。

有关修改数据提示的示例，请参阅创建自定义数据提示。

此 属性 为只读。

图形对象的类型，以 'scatter' 形式返回。使用该属性在绘制层次结构中查找指定类型的所有对象，例如，使用 findobj 搜索该类型。