BubbleCloud 属性

图标题，指定为字符向量、字符向量元胞数组、字符串数组或分类数组。要创建一个多行标题，请指定字符向量元胞数组或字符串数组。数组中的每个元素是一行文本。

您也可以调用 title 函数为图添加标题。

bubblecloud(rand(1,20))
title("Random Bubbles")

图例标题，指定为字符向量、字符向量元胞数组、字符串数组或分类数组。要创建一个多行标题，请指定字符向量元胞数组或字符串数组。数组中的每个元素是一行文本。

如果在表中指定数据，则默认图例标题是指定组的变量的名称。

气泡填充颜色，指定为下表中的值。

下表列出了可用的颜色名称和短名称，以及对应的 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

气泡边缘颜色，指定为下表中的一个值。

下表列出了可用的颜色名称和短名称，以及对应的 RGB 三元组和十六进制颜色代码。

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

色序，指定为由 RGB 三元组组成的三列矩阵。此属性定义在您指定组数据时 MATLAB 用于创建多个气泡云的颜色的调色板。数组的每一行都是一个 RGB 三元组。RGB 三元组是包含三个元素的向量，其元素分别指定颜色的红、绿、蓝分量的强度。强度必须在 [0, 1] 范围内。下表列出了默认颜色。

    [    0    0.4470    0.7410
    0.8500    0.3250    0.0980
    0.9290    0.6940    0.1250
    0.4940    0.1840    0.5560
    0.4660    0.6740    0.1880
    0.3010    0.7450    0.9330
    0.6350    0.0780    0.1840]

MATLAB 根据 GroupData 属性中的值的顺序为每个气泡云分配颜色。

设置此属性的另一种方法是将 BubbleCloud 对象传递给 colororder 函数。

气泡填充颜色透明度，指定为范围 [0,1] 中的标量。值 1 表示气泡不透明，值 0 表示完全透明。0 到 1 之间的值对应于部分透明的气泡。

图例可见性，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

在您使用分组数据创建气泡云时，MATLAB 将此属性设置为 'on' 并显示图例。否则，该值为 'off' 并且不显示图例。

要显示的最大气泡数，指定为正数。

字体名称，指定为支持的字体名称或 "FixedWidth"。要正确显示和打印文本，您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。

要使用在任何区域设置中都有较好显示效果的等宽字体，请使用 "FixedWidth"。等宽字体依赖于根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

字体大小，指定为大于 0 的标量值（以磅为单位）。默认字体大小取决于具体操作系统和区域设置。一磅等于 1/72 英寸。

字体颜色，指定为 RGB 三元组、十六进制颜色代码或下表中列出的选项之一。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

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

下表列出了浅色和深色主题中绘图的默认调色板。

您可以使用 orderedcolors 和 rgb2hex 函数获取这些调色板的 RGB 三元组和十六进制颜色代码。例如，获取 "gem" 调色板的 RGB 三元组并将其转换为十六进制颜色代码。

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

在 R2023b 之前的版本中: 使用 RGB = get(groot,"FactoryAxesColorOrder") 获取 RGB 三元组。

在 R2024a 之前的版本中: 使用 H = compose("#%02X%02X%02X",round(RGB*255)) 获取十六进制颜色代码。

包含气泡数据的表。该表必须有至少一个指定气泡大小的变量。气泡大小可以包括非负数值、NaN 和 Inf 值。图中仅显示大小为正值的气泡。零值、NaN 和 Inf 值被忽略。

该表可以有选择地包括包含以下数据的变量：

分组数据对于显示具有不同颜色的多个云非常有用。例如，您可以显示按制造商分组的汽车数据。

气泡大小的表变量，指定为以下值之一：

气泡标签的表变量，指定为以下值之一：

气泡组的表变量，指定为以下值之一：

当您指定气泡组时，bubblecloud 会将您的数据分成若干单独的气泡云。每个气泡云都有一种不同颜色，这些颜色由 ColorOrder 属性确定。

气泡大小，指定为包含非负值的数值向量。零值、NaN 和 Inf 值被忽略。例如，bubblecloud(1:10) 创建 10 个大小为 1 到 10 的气泡。

当您使用表数据创建气泡云时，MATLAB 会自动用 SizeVariable 属性指定的数据填充此属性。

气泡标签，指定为字符向量元胞数组或字符串向量。元胞数组或字符串向量中的元素数必须与 SizeData 向量中的元素数相匹配。例如，bubblecloud(1:3,["one" "two" "three"]) 用标签 "one"、"two" 和 "three" 创建三个气泡。

当您使用包含标签的表创建气泡云时，MATLAB 会自动用 LabelVariable 属性指定的数据填充此属性。

气泡组，指定为字符向量元胞数组、字符串向量、分类向量或逻辑向量。元素数必须与 SizeData 向量中的元素数相匹配。例如，bubblecloud(1:3,["one" "two" "three"],["Group1" "Group2" "Group2"]) 创建三个气泡，分成两组。

当您指定气泡组时，bubblecloud 会将您的数据分成若干单独的气泡云。每个气泡云都有一种不同颜色，这些颜色由 ColorOrder 属性确定。

当您使用包含组数据的表创建气泡云时，MATLAB 会自动用 GroupVariable 属性指定的数据填充此属性。

在增加、删除或更改装饰元素时保持不变的位置属性，指定为下列值之一：

气泡云在父容器（通常为图窗、面板或分块图布局）中的外部大小和位置，指定为 [left bottom width height] 形式的四元素向量。外部大小和位置包括图例和标题。

默认值 [0 0 1 1] 涵盖容器的整个内部。单位相对于容器的大小进行归一化。要更改单位，请设置 Units 属性。

气泡云在父容器（通常为图窗、面板或分块图布局）中的内部大小和位置，返回为 [left bottom width height] 形式的四元素向量。内部大小和位置不包括图例或标题。

气泡云在父容器（通常为图窗、面板或分块图布局）中的内部大小和位置，返回为 [left bottom width height] 形式的四元素向量。此属性等同于 InnerPosition 属性。

位置单位，指定为下列值之一：

在对象创建过程中将单位指定为名称-值对组时，您必须先设置 Units 属性，然后再指定要使用这些单位的属性（如 OuterPosition）。

布局选项，指定为 TiledChartLayoutOptions 或 GridLayoutOptions 对象。当图采用分块图布局或网格布局时，此属性非常有用。

要在分块图布局的网格中定位图，请设置 TiledChartLayoutOptions 对象的 Tile 和 TileSpan 属性。例如，假设有一个 3×3 分块图布局。布局的中心有一个包含若干图块的网格，外边缘四周各有一个图块。实际上，该网格不可见，外侧图块也不占用空间，除非您用坐标区或图填充它们。

以下代码将图 c 放置在网格的第三个图块中。

c.Layout.Tile = 3;

要使图占据多个图块，请将 TileSpan 属性指定为二元素向量。例如，此图占据了 2 行和 3 列的图块。

c.Layout.TileSpan = [2 3];

要将图放在四周的某个图块中，请将 Tile 属性指定为 "north"、"south"、"east" 或 "west"。例如，将值设置为 "east" 会将图放置在网格右侧的图块中。

c.Layout.Tile = "east";

要将图放入 App 内的一个布局中，请将此属性指定为 GridLayoutOptions 对象。有关在 App 中使用网格布局的详细信息，请参阅 uigridlayout。

如果图不是分块图布局或网格布局的子级（例如，如果它是图窗或面板的子级），则此属性为空且不起作用。

可见性状态，指定为 'on' 或 'off'，或者指定为数值或逻辑值 1 (true) 或 0 (false)。值 'on' 等效于 true，'off' 等效于 false。因此，您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState 类型的 on/off 逻辑值。

父容器，指定为 Figure、Panel、Tab、TiledChartLayout 或 GridLayout 对象。