Main Content

BubbleCloud 属性

气泡云的外观和行为

自 R2021a 起

BubbleCloud 属性控制 BubbleCloud 对象的外观和行为。通过更改属性值,您可以修改该气泡云的特定方面。例如,您可以添加标题:

b = bubblecloud(1:100);
b.Title = 'My Bubble Cloud';

标题

全部展开

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

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

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

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

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

颜色和样式

全部展开

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

FaceColor描述
'flat'

让 MATLAB® 为每组气泡指定不同颜色。颜色在图的 ColorOrder 属性中定义。

RGB 三元组或十六进制颜色代码

为所有气泡组只指定一种自定义颜色:

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

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

以下两个表提供一些常见颜色的 RGB 三元组和十六进制颜色代码。

颜色名称或短名称

使用颜色名称(如 'red')或短名称(如 'r')为所有气泡组只指定一种预定义颜色。

下表列出了可用的颜色名称和短名称。

'none'

显示所有没有任何颜色的气泡组。

下表列出了可用的颜色名称和短名称,以及对应的 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

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

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

EdgeColor描述
'flat'

让 MATLAB 为每组气泡指定一种不同的边缘颜色。颜色在图的 ColorOrder 属性中定义。

RGB 三元组或十六进制颜色代码

为所有气泡组只指定一种自定义边缘颜色:

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

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

以下两个表提供一些常见颜色的 RGB 三元组和十六进制颜色代码。

颜色名称或短名称

使用颜色名称(如 'red')或短名称(如 'r')为所有气泡组只指定一种预定义边缘颜色。

下表列出了可用的颜色名称和短名称。

'none'

显示所有没有任何边缘颜色的气泡组。

下表列出了可用的颜色名称和短名称,以及对应的 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

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

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

颜色ColorOrder 矩阵


    [    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 英寸。

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

字体颜色,指定为 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

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

表数据

全部展开

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

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

  • 气泡标签 - 使用字符向量元胞数组或字符串向量创建此变量。

  • 分组数据 - 使用字符向量元胞数组、字符串向量、分类向量、数值向量或逻辑向量创建此变量。

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

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

  • 变量名称 - 包含大小数据的表变量的名称的字符向量或字符串标量。

  • 变量索引 - 包含大小数据的表变量的索引。将索引指定为介于 1 和表变量数目之间的数字。

  • 逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个 true 值。

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

  • 变量名称 - 包含标签的表变量的名称的字符向量或字符串标量。

  • 变量索引 - 包含标签的表变量的索引。将索引指定为介于 1 和表变量数目之间的数字。

  • 逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个 true 值。

气泡组的表变量,指定为以下值之一:

  • 变量名称 - 包含分组数据的表变量的名称的字符向量或字符串标量。

  • 变量索引 - 包含分组数据的表变量的索引。将索引指定为介于 1 和表变量数目之间的数字。

  • 逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个 true 值。

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

向量数据

全部展开

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

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

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

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

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

数据类型: cell | string

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

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

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

数据类型: cell | string | categorical | logical

位置

全部展开

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

  • "outerposition" - 在添加、删除或更改装饰元素(例如标题或轴标签)时,OuterPosition 属性保持不变。如需任何位置调整,MATLAB 会调整 InnerPosition 属性。

  • "innerposition" - 在添加、删除或更改装饰元素(例如标题或轴标签)时,InnerPosition 属性保持不变。如需任何位置调整,MATLAB 会调整 OuterPosition 属性。

注意

当父容器为 TiledChartLayout 对象时,设置此属性不起作用。

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

  • leftbottom 元素定义容器左下角到气泡云左下角的距离。

  • widthheight 元素是气泡云维度,包括图例和标题周围的边距。

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

注意

当父容器为 TiledChartLayout 对象时,设置此属性不起作用。

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

  • leftbottom 元素定义容器左下角到包围气泡云的框的左下角的距离。

  • widthheight 元素是包围气泡云的框的维度。

注意

当父容器为 TiledChartLayout 对象时,设置此属性不起作用。

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

注意

当父容器为 TiledChartLayout 对象时,设置此属性不起作用。

位置单位,指定为下列值之一:

Units描述
'normalized'(默认值)根据容器进行归一化,容器通常是图窗或面板。容器的左下角对应到 (0,0),右上角对应到 (1,1)
'inches'英寸。
'centimeters'厘米。
'characters'

基于图形根对象的默认 uicontrol 字体:

  • 字符宽度 = 字母 x 的宽度。

  • 字符高度 = 两个文本行的基线之间的距离。

'points'字体磅数。一磅等于 1/72 英寸。
'pixels'

像素。

以像素为单位的距离不依赖 Windows®Macintosh 系统上的系统分辨率:

  • 在 Windows 系统上,一个像素是 1/96 英寸。

  • Macintosh 系统上,一个像素是 1/72 英寸。

在 Linux® 系统上,一个像素的大小由系统分辨率确定。

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

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

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

Diagram of a 3-by-3 tiled chart layout.

以下代码将图 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 逻辑值。

  • 'on' - 显示气泡云。

  • 'off' - 隐藏气泡云但不删除它。您仍然可以访问不可见的 BubbleCloud 对象的属性。

父级/子级

全部展开

父容器,指定为 FigurePanelTabTiledChartLayoutGridLayout 对象。

版本历史记录

在 R2021a 中推出

另请参阅