BubbleCloud 属性
BubbleCloud
属性控制 BubbleCloud
对象的外观和行为。通过更改属性值,您可以修改该气泡云的特定方面。例如,您可以添加标题:
b = bubblecloud(1:100); b.Title = 'My Bubble Cloud';
标题
Title
— 图标题
字符向量 | 字符向量元胞数组 | 字符串数组 | 分类数组
图标题,指定为字符向量、字符向量元胞数组、字符串数组或分类数组。要创建一个多行标题,请指定字符向量元胞数组或字符串数组。数组中的每个元素是一行文本。
您也可以调用 title
函数为图添加标题。
bubblecloud(rand(1,20))
title("Random Bubbles")
LegendTitle
— 图例标题
字符向量 | 字符向量元胞数组 | 字符串数组 | 分类数组
图例标题,指定为字符向量、字符向量元胞数组、字符串数组或分类数组。要创建一个多行标题,请指定字符向量元胞数组或字符串数组。数组中的每个元素是一行文本。
如果在表中指定数据,则默认图例标题是指定组的变量的名称。
颜色和样式
FaceColor
— 气泡填充颜色
'flat'
(默认) | RGB 三元组 | 十六进制颜色代码 | 颜色名称 | 短名称 | 'none'
气泡填充颜色,指定为下表中的值。
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" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
EdgeColor
— 气泡边缘颜色
[0 0 0]
(默认) | 'flat'
| RGB 三元组 | 十六进制颜色代码 | 颜色名称 | 短名称 | 'none'
气泡边缘颜色,指定为下表中的一个值。
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" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
ColorOrder
— 色序
七种预定义颜色 (默认) | 由 RGB 三元组组成的三列矩阵
色序,指定为由 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
函数。
FaceAlpha
— 气泡填充颜色透明度
0.60
(默认) | 范围 [0,1]
中的标量。
气泡填充颜色透明度,指定为范围 [0,1]
中的标量。值 1 表示气泡不透明,值 0 表示完全透明。0 到 1 之间的值对应于部分透明的气泡。
LegendVisible
— 图例的可见性
on/off 逻辑值
图例可见性,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
在您使用分组数据创建气泡云时,MATLAB 将此属性设置为 'on'
并显示图例。否则,该值为 'off'
并且不显示图例。
MaxDisplayBubbles
— 最大气泡数
1000
(默认) | 正数
要显示的最大气泡数,指定为正数。
气泡标签字体
FontName
— 字体名称
支持的字体名称 | 'FixedWidth'
字体名称,指定为支持的字体名称或 'FixedWidth'
。要正确显示和打印文本,您必须选择系统支持的字体。默认字体取决于您的操作系统和区域设置。
要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 'FixedWidth'
。等宽字体依赖于根 FixedWidthFontName
属性。设置根 FixedWidthFontName
属性会导致立即更新显示方式以使用新字体。
FontSize
— 字体大小
大于 0 的标量值
字体大小,指定为大于 0 的标量值(以磅为单位)。默认字体大小取决于具体操作系统和区域设置。一磅等于 1/72
英寸。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
FontColor
— 字体颜色
[0 0 0]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
字体颜色,指定为 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" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
表数据
SourceTable
— 包含气泡数据的表
表 | 时间表
包含气泡数据的表。该表必须有至少一个指定气泡大小的变量。气泡大小可以包括非负数值、NaN
和 Inf
值。图中仅显示大小为正值的气泡。零值、NaN
和 Inf
值被忽略。
该表可以有选择地包括包含以下数据的变量:
气泡标签 - 使用字符向量元胞数组或字符串向量创建此变量。
分组数据 - 使用字符向量元胞数组、字符串向量、分类向量、数值向量或逻辑向量创建此变量。
分组数据对于显示具有不同颜色的多个云非常有用。例如,您可以显示按制造商分组的汽车数据。
SizeVariable
— 气泡大小的表变量
变量名称 | 变量索引 | 逻辑向量
气泡大小的表变量,指定为以下值之一:
变量名称 - 包含大小数据的表变量的名称的字符向量或字符串标量。
变量索引 - 包含大小数据的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
LabelVariable
— 气泡标签的表变量
变量名称 | 变量索引 | 逻辑向量
气泡标签的表变量,指定为以下值之一:
变量名称 - 包含标签的表变量的名称的字符向量或字符串标量。
变量索引 - 包含标签的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
GroupVariable
— 气泡组的表变量
变量名称 | 变量索引 | 逻辑向量
气泡组的表变量,指定为以下值之一:
变量名称 - 包含分组数据的表变量的名称的字符向量或字符串标量。
变量索引 - 包含分组数据的表变量的索引。将索引指定为介于
1
和表变量数目之间的数字。逻辑向量 - 逻辑值的向量,其元素数与表中的变量数相同。该向量只能包含一个
true
值。
当您指定气泡组时,bubblecloud
会将您的数据分成若干单独的气泡云。每个气泡云都有一种不同颜色,这些颜色由 ColorOrder
属性确定。
向量数据
SizeData
— 气泡大小
数值向量
气泡大小,指定为包含非负值的数值向量。零值、NaN
和 Inf
值被忽略。例如,bubblecloud(1:10)
创建 10 个大小为 1
到 10
的气泡。
当您使用表数据创建气泡云时,MATLAB 会自动用 SizeVariable
属性指定的数据填充此属性。
数据类型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
LabelData
— 气泡标签
字符向量元胞数组 | 字符串向量
气泡标签,指定为字符向量元胞数组或字符串向量。元胞数组或字符串向量中的元素数必须与 SizeData
向量中的元素数相匹配。例如,bubblecloud(1:3,["one" "two" "three"])
用标签 "one"
、"two"
和 "three"
创建三个气泡。
当您使用包含标签的表创建气泡云时,MATLAB 会自动用 LabelVariable
属性指定的数据填充此属性。
数据类型: cell
| string
GroupData
— 气泡组
字符向量元胞数组 | 字符串向量 | 分类向量 | 逻辑向量
气泡组,指定为字符向量元胞数组、字符串向量、分类向量或逻辑向量。元素数必须与 SizeData
向量中的元素数相匹配。例如,bubblecloud(1:3,["one" "two" "three"],["Group1" "Group2" "Group2"])
创建三个气泡,分成两组。
当您指定气泡组时,bubblecloud
会将您的数据分成若干单独的气泡云。每个气泡云都有一种不同颜色,这些颜色由 ColorOrder
属性确定。
当您使用包含组数据的表创建气泡云时,MATLAB 会自动用 GroupVariable
属性指定的数据填充此属性。
数据类型: cell
| string
| categorical
| logical
位置
PositionConstraint
— 保持不变的位置
'outerposition'
| 'innerposition'
在增加、删除或更改装饰元素时保持不变的位置属性,指定为下列值之一:
'outerposition'
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,OuterPosition
属性保持不变。如需任何位置调整,MATLAB 会调整InnerPosition
属性。'innerposition'
- 在添加、删除或更改装饰元素(例如标题或轴标签)时,InnerPosition
属性保持不变。如需任何位置调整,MATLAB 会调整OuterPosition
属性。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
OuterPosition
— 外界大小和位置
[0 0 1 1]
(默认) | 四元素向量
气泡云在父容器(通常为图窗、面板或分块图布局)中的外界大小和位置,指定为 [left bottom width height]
形式的四元素向量。外界大小和位置包括图例和标题。
left
和bottom
元素定义容器左下角到气泡云左下角的距离。width
和height
元素是气泡云维度,包括图例和标题周围的边距。
默认值 [0 0 1 1]
涵盖容器的整个内部。单位相对于容器的大小进行归一化。要更改单位,请设置 Units
属性。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
InnerPosition
— 内界大小和位置
四元素向量
气泡云在父容器(通常为图窗、面板或分块图布局)中的内界大小和位置,返回为 [left bottom width height]
形式的四元素向量。内界大小和位置不包括图例或标题。
left
和bottom
元素定义容器左下角到包围气泡云的框的左下角的距离。width
和height
元素是包围气泡云的框的维度。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
Position
— 内界大小和位置
四元素向量
气泡云在父容器(通常为图窗、面板或分块图布局)中的内界大小和位置,返回为 [left bottom width height]
形式的四元素向量。此属性等同于 InnerPosition
属性。
注意
当父容器为 TiledChartLayout
时,设置此属性不起作用。
Units
— 位置单位
'normalized'
(默认) | 'inches'
| 'centimeters'
| 'points'
| 'pixels'
| 'characters'
位置单位,指定为下列值之一:
Units | 描述 |
---|---|
'normalized' (默认值) | 根据容器进行归一化,容器通常是图窗或面板。容器的左下角对应到 (0,0) ,右上角对应到 (1,1) 。 |
'inches' | 英寸。 |
'centimeters' | 厘米。 |
'characters' | 基于图形根对象的默认 uicontrol 字体:
|
'points' | 字体磅数。一磅等于 1/72 英寸。 |
'pixels' | 像素。 以像素为单位的距离不依赖 Windows® 和 Macintosh 系统上的系统分辨率:
在 Linux® 系统上,一个像素的大小由系统分辨率确定。 |
在对象创建过程中将单位指定为名称-值对组时,您必须先设置 Units
属性,然后再指定要使用这些单位的属性(如 OuterPosition
)。
Layout
— 布局选项
空 LayoutOptions
数组 (默认) | TiledChartLayoutOptions
对象 | GridLayoutOptions
对象
布局选项,指定为 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
。
如果图不是分块图布局或网格布局的子级(例如,如果它是图窗或面板的子级),则此属性为空且不起作用。
Visible
— 可见性状态
'on'
(默认) | on/off 逻辑值
可见性状态,指定为 'on'
或 'off'
,或者指定为数值或逻辑值 1
(true
) 或 0
(false
)。值 'on'
等效于 true
,'off'
等效于 false
。因此,您可以使用此属性的值作为逻辑值。该值存储为 matlab.lang.OnOffSwitchState
类型的 on/off 逻辑值。
'on'
- 显示气泡云。'off'
- 隐藏气泡云但不删除它。您仍然可以访问不可见的BubbleCloud
对象的属性。
父级/子级
Parent
— 父容器
Figure
对象 | Panel
对象 | Tab
对象 | TiledChartLayout
对象 | GridLayout
对象
父容器,指定为 Figure
、Panel
、Tab
、TiledChartLayout
或 GridLayout
对象。
版本历史记录
在 R2021a 中推出
另请参阅
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- 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)