BubbleCloud 属性
BubbleCloud
属性控制 BubbleCloud
对象的外观和行为。通过更改属性值,您可以修改该气泡云的特定方面。例如,您可以添加标题:
b = bubblecloud(1:100); b.Title = 'My Bubble Cloud';
颜色和样式
气泡填充颜色,指定为下表中的值。
FaceColor 值 | 描述 |
---|---|
'flat' | 让 MATLAB® 为每组气泡指定不同颜色。颜色在图的 |
RGB 三元组或十六进制颜色代码 | 为所有气泡组只指定一种自定义颜色:
以下两个表提供一些常见颜色的 RGB 三元组和十六进制颜色代码。 |
颜色名称或短名称 | 使用颜色名称(如 下表列出了可用的颜色名称和短名称。 |
'none' | 显示所有没有任何颜色的气泡组。 |
下表列出了可用的颜色名称和短名称,以及对应的 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" |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 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))
获取十六进制颜色代码。
气泡边缘颜色,指定为下表中的一个值。
EdgeColor 值 | 描述 |
---|---|
'flat' | 让 MATLAB 为每组气泡指定一种不同的边缘颜色。颜色在图的 |
RGB 三元组或十六进制颜色代码 | 为所有气泡组只指定一种自定义边缘颜色:
以下两个表提供一些常见颜色的 RGB 三元组和十六进制颜色代码。 |
颜色名称或短名称 | 使用颜色名称(如 下表列出了可用的颜色名称和短名称。 |
'none' | 显示所有没有任何边缘颜色的气泡组。 |
下表列出了可用的颜色名称和短名称,以及对应的 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" |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 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] 范围内。下表列出了默认颜色。
颜色 | 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]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是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" |
下表列出了浅色和深色主题中绘图的默认调色板。
调色板 | 调色板颜色 |
---|---|
在 R2025a 之前的版本中: 大多数绘图默认使用这些颜色。 |
|
|
|
您可以使用 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
值被忽略。
该表可以有选择地包括包含以下数据的变量:
气泡标签 - 使用字符向量元胞数组或字符串向量创建此变量。
分组数据 - 使用字符向量元胞数组、字符串向量、分类向量、数值向量或逻辑向量创建此变量。
分组数据对于显示具有不同颜色的多个云非常有用。例如,您可以显示按制造商分组的汽车数据。
气泡大小的表变量,指定为以下值之一:
变量名称 - 包含大小数据的表变量的名称的字符向量或字符串标量。
变量索引 - 包含大小数据的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
气泡标签的表变量,指定为以下值之一:
变量名称 - 包含标签的表变量的名称的字符向量或字符串标量。
变量索引 - 包含标签的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
气泡组的表变量,指定为以下值之一:
变量名称 - 包含分组数据的表变量的名称的字符向量或字符串标量。
变量索引 - 包含分组数据的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
当您指定气泡组时,bubblecloud
会将您的数据分成若干单独的气泡云。每个气泡云都有一种不同颜色,这些颜色由 ColorOrder
属性确定。
向量数据
气泡大小,指定为包含非负值的数值向量。零值、NaN
和 Inf
值被忽略。例如,bubblecloud(1:10)
创建 10 个大小为 1
到 10
的气泡。
当您使用表数据创建气泡云时,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]
形式的四元素向量。外部大小和位置包括图例和标题。
left
和bottom
元素定义容器左下角到气泡云左下角的距离。width
和height
元素是气泡云维度,包括图例和标题周围的边距。
默认值 [0 0 1 1]
涵盖容器的整个内部。单位相对于容器的大小进行归一化。要更改单位,请设置 Units
属性。
注意
当父容器为 TiledChartLayout
对象时,设置此属性不起作用。
气泡云在父容器(通常为图窗、面板或分块图布局)中的内部大小和位置,返回为 [left bottom width height]
形式的四元素向量。内部大小和位置不包括图例或标题。
left
和bottom
元素定义容器左下角到包围气泡云的框的左下角的距离。width
和height
元素是包围气泡云的框的维度。
注意
当父容器为 TiledChartLayout
对象时,设置此属性不起作用。
气泡云在父容器(通常为图窗、面板或分块图布局)中的内部大小和位置,返回为 [left bottom width height]
形式的四元素向量。此属性等同于 InnerPosition
属性。
注意
当父容器为 TiledChartLayout
对象时,设置此属性不起作用。
位置单位,指定为下列值之一:
Units | 描述 |
---|---|
'normalized' (默认值) | 根据容器进行归一化,容器通常是图窗或面板。容器的左下角对应到 (0,0) ,右上角对应到 (1,1) 。 |
'inches' | 英寸。 |
'centimeters' | 厘米。 |
'characters' | 基于图形根对象的默认 uicontrol 字体:
|
'points' | 字体磅数。一磅等于 1/72 英寸。 |
'pixels' | 像素。 在 Windows® 和 Macintosh 系统上,像素的大小为 1/96 英寸。此大小与系统分辨率无关。 在 Linux® 系统上,一个像素的大小由系统分辨率确定。 |
在对象创建过程中将单位指定为名称-值对组时,您必须先设置 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 逻辑值。
'on'
- 显示气泡云。'off'
- 隐藏气泡云但不删除它。您仍然可以访问不可见的BubbleCloud
对象的属性。
父级/子级
父容器,指定为 Figure
、Panel
、Tab
、TiledChartLayout
或 GridLayout
对象。
版本历史记录
在 R2021a 中推出
另请参阅
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
选择网站
选择网站以获取翻译的可用内容,以及查看当地活动和优惠。根据您的位置,我们建议您选择:。
您也可以从以下列表中选择网站:
如何获得最佳网站性能
选择中国网站(中文或英文)以获得最佳网站性能。其他 MathWorks 国家/地区网站并未针对您所在位置的访问进行优化。
美洲
- América Latina (Español)
- Canada (English)
- United States (English)
欧洲
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)