主要内容

GeographicBubbleChart 属性

独立地理气泡图的外观和行为

GeographicBubbleChart 属性控制 GeographicBubbleChart 对象的外观和行为。通过更改属性值,您可以修改图的特定方面。使用圆点表示法查询和设置属性。

gb = geobubble(1:10,1:10);
v = gb.GridVisible; 
gb.GridVisible = "off";

气泡位置

全部展开

以度为单位的纬度坐标,指定为由 [–90, 90] 范围内的元素组成的向量或指定为空数组 ([])。向量可以包含 NaN 值。LatitudeDataLongitudeData 的大小必须匹配。

在大多数情况下,该图的纬度范围不会超出 [-85, 85] 度的范围。当您设置该图的 MapCenterZoomLevel 属性时,纬度范围可能会超出此范围。有关详细信息,请参阅Interact with Geographic Axes

数据类型: single | double

包含纬度坐标的表变量,使用以下索引方案之一指定。

索引方案示例

变量名称:

  • 字符串标量或字符向量。

  • pattern 对象。模式对象只能引用一个变量。

  • "A"'A' - 名为 A 的变量

  • "Var"+digitsPattern(1) - 名称为 "Var" 的变量后跟一位数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

  • [false false true] - 第三个变量

变量类型:

  • vartype 下标,用于选择指定类型的表变量。该下标只能引用一个变量。

  • vartype("double") - 包含双精度值的变量

不管变量名称如何,图上的轴标签始终为 Latitude

您指定的变量必须包含 singledouble 类型的数值数据。数据必须处于 [–90, 90] 范围中。

设置此属性时,MATLAB® 会更新 LatitudeData 属性并将 LatitudeData 属性设置为只读。

以度为单位的经度坐标,指定为向量或空数组 ([])。向量可以包含 NaN 值。LatitudeDataLongitudeData 的大小必须匹配。

数据类型: single | double

包含经度坐标的表变量,使用以下索引方案之一指定。

索引方案示例

变量名称:

  • 字符串标量或字符向量。

  • pattern 对象。模式对象只能引用一个变量。

  • "A"'A' - 名为 A 的变量

  • "Var"+digitsPattern(1) - 名称为 "Var" 的变量后跟一位数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

  • [false false true] - 第三个变量

变量类型:

  • vartype 下标,用于选择指定类型的表变量。该下标只能引用一个变量。

  • vartype("double") - 包含双精度值的变量

不管变量名称如何,图上的轴标签始终为 Longitude

您指定的变量必须包含 singledouble 类型的数值数据。

设置此属性时,MATLAB 会更新 LongitudeData 属性并将 LongitudeData 属性设置为只读。

气泡大小

全部展开

最小和最大气泡直径,指定为正标量或由正数组成的 1×2 向量,其中第二个数大于第一个数。如果您希望所有气泡具有相同大小,请指定标量。以磅为单位指定气泡直径,其中一磅等于 1/72 英寸。值必须在 [1, 100] 范围内。

相对气泡大小,指定为下列形式之一:

  • 标量 - 对所有气泡使用相同大小。

  • 向量 - 对每个气泡使用不同大小。将 SizeData 指定为长度与 LatitudeData 相同的向量。

SizeData 可以包含 NaN 值。

大小限制,指定为由非降序值组成的 1×2 向量或空数组 ([])。此属性可确定大小数据值如何映射到气泡宽度,其中:

  • 第一个元素指定映射到最小气泡的大小数据值。

  • 第二个元素指定映射到最大气泡的大小数据值。

要创建大小相同的气泡,请为每个元素指定相同的值。

有关控制气泡大小的详细信息,请参阅控制独立地理气泡图中的气泡

包含气泡大小数据的表变量,使用以下索引方案之一指定。

索引方案示例

变量名称:

  • 字符串标量或字符向量。

  • pattern 对象。模式对象只能引用一个变量。

  • "A"'A' - 名为 A 的变量

  • "Var"+digitsPattern(1) - 名称为 "Var" 的变量后跟一位数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

  • [false false true] - 第三个变量

变量类型:

  • vartype 下标,用于选择指定类型的表变量。该下标只能引用一个变量。

  • vartype("double") - 包含双精度值的变量

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

气泡颜色

全部展开

气泡颜色列表,使用以下形式之一指定:

  • 由 RGB 三元组组成的三列矩阵,其元素指定颜色中红、绿和蓝分量的强度。要生成由 RGB 三元组组成的三列矩阵,一种简便方法是使用预定义的颜色图,如 turbo,或使用 orderedcolors 函数返回预定义调色板的颜色。

  • 颜色名称,如 "red""green""blue"

  • 短名称,如 "r""g""b"

  • 指示颜色名称或短名称的字符串标量向量,如 ["red","green","blue"]["r","g","b"]

  • 指示颜色名称或短名称的字符向量元胞数组,如 {'red','green','blue'}{'r','g','b'}

默认情况下,气泡图从包含 7 种标准颜色的有序列表中选择颜色。如果由 ColorData 指定的类别数大于 7,气泡图会循环重复使用颜色。

数据类型: cell | string | double

控制气泡颜色的数据,指定为分类向量或空数组 ([])。地理气泡图使用 BubbleColorList 属性中存储的颜色为每个类别分配一种颜色。与同一类别相关联的气泡在地图上具有相同的颜色。

ColorData 的大小必须与 LatitudeData 的大小匹配,除非您指定空数组。

地理气泡图以颜色图例显示类别值。当值包含 TeX 标记字符(例如下划线)时,颜色图例可能会显示意外的格式。

  • 要在常规文本中使用 TeX 标记字符,请使用 renamecats 函数编辑类别的名称,然后在要包含的字符之前插入 TeX 转义字符 (\)。

  • MATLAB 支持对图例上显示的文本使用某些 TeX 标记。有关使用 TeX 标记的详细信息,请参阅图文本中的希腊字母和特殊字符

数据类型: categorical

包含气泡颜色数据的表变量,使用以下索引方案之一指定。

索引方案示例

变量名称:

  • 字符串标量或字符向量。

  • pattern 对象。模式对象只能引用一个变量。

  • "A"'A' - 名为 A 的变量

  • "Var"+digitsPattern(1) - 名称为 "Var" 的变量后跟一位数字

变量索引:

  • 引用变量在表中位置的索引编号。

  • 逻辑向量。通常,此向量的长度与变量的数目相同,但可以省略尾部的 0false 值。

  • 3 - 表中的第三个变量

  • [false false true] - 第三个变量

变量类型:

  • vartype 下标,用于选择指定类型的表变量。该下标只能引用一个变量。

  • vartype("double") - 包含双精度值的变量

您指定的变量必须包含分类值。当您设置 ColorVariable 属性时,MATLAB 会更新 ColorData 属性。

标签

全部展开

地理气泡图的标题,指定为字符向量、字符向量元胞数组、字符串标量、字符串数组、数值或 categorical 值。当使用 categorical 数组指定此属性时,MATLAB 使用数组中的值,而不是类别。

您也可以使用 title 函数添加标题。

颜色图例的标题,指定为字符向量、字符向量元胞数组、字符串标量、字符串数组、数值或 categorical 值。当使用 categorical 数组指定此属性时,MATLAB 使用数组中的值,而不是类别。

大小图例的标题,指定为字符向量、字符向量元胞数组、字符串标量、字符串数组、数值或 categorical 值。当使用 categorical 数组指定此属性时,MATLAB 使用数组中的值,而不是类别。

大小图例和颜色图例的可见性,指定为 'on''off',或者指定为逻辑值 1 (true) 或 0 (false)。

您也可以使用 legend 函数切换图例的可见性。

数据类型: char | string | logical

字体

全部展开

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

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

地理气泡图中使用的字体大小,指定为正标量。默认字体大小取决于具体操作系统和区域设置。地理气泡图以磅为单位测量字体大小,其中一磅等于 1/72 英寸。

地图

全部展开

要在其上绘制数据的地图,指定为下表中列出的值之一。有六幅底图是使用 Natural Earth 创建的图块化数据集。其中五个底图是由 Esri® 托管的高缩放级别地图。

'streets-light' basemap

'streets-light'(默认值)

旨在提供地理上下文同时在浅色背景上突出显示用户数据的地图。

由 Esri 托管。

'streets-dark' basemap

'streets-dark'

旨在提供地理上下文同时在深色背景上突出显示用户数据的地图。

由 Esri 托管。

'streets' basemap

'streets'

通用公路图,强调公路和交通网络的准确、清晰样式。

由 Esri 托管。

'satellite' basemap

'satellite'

由高分辨率卫星图像组成的完整全球底图。

由 Esri 托管。

'topographic' basemap

'topographic'

具有用于描绘地貌特征的样式的通用地图。

由 Esri 托管。

'landcover' basemap

'landcover'

结合卫星衍生的地表数据、着色地势和海底地势的地图。明亮、自然的调色板适用于主题地图和参考地图。

使用 Natural Earth 创建。

'colorterrain' basemap

'colorterrain'

叠加了地表配色的着色地势图。潮湿的低地为绿色,干旱的低地为棕色。

使用 Natural Earth 创建。

'grayterrain' basemap

'grayterrain'

灰色地形图。着色地势强调高山和洼地的微地形。

使用 Natural Earth 创建。

'bluegreen' basemap

'bluegreen'

具有浅绿色陆地区域和浅蓝色水域的双色陆地海洋地图。

使用 Natural Earth 创建。

'grayland' basemap

'grayland'

具有灰色陆地区域和白色水域的双色陆地海洋地图。

使用 Natural Earth 创建。

'darkwater' basemap

'darkwater'

具有浅灰色陆地区域和深灰色水域的双色陆地海洋地图。此底图随 MATLAB 一起安装。

使用 Natural Earth 创建。

 

'none'

空白背景,用经纬度网格、刻度和标签绘制数据。

'darkwater' 外,所有底图都需要 Internet 访问权限。'darkwater' 底图包含在 MATLAB 中。

如果您不能随时访问 Internet,可使用附加功能资源管理器将使用 Natural Earth 创建的底图下载到您的本地系统上。这五个高缩放级别的地图无法下载。有关下载底图和更改本地系统上默认底图的详细信息,请参阅访问用于地理坐标区和地理图的底图

由 Esri 托管的底图会周期性更新。因此,随着时间的推移,您可能会看到可视化出现差异。

边界和区域标签的对齐是数据供应商提供的功能的展示,并不意味着 MathWorks® 对此做出背书。

数据类型: char | string

包含要绘制的数据的源表,指定为表或时间表。

网格线的可见性,指定为 'on''off',或逻辑值 1 (true) 或 0 (false)。

您也可以使用 grid 函数来切换网格线的可见性。

数据类型: logical | char | string

此 属性 为只读。

地图的纬度范围,返回为 [latmin latmax] 形式的二元素向量。每个元素都在 [-90, 90] 度范围内。

使用 geolimits 函数更改纬度范围。

当您通过调整窗口的大小来调整图的大小时,纬度范围不会改变,除非是为了适应地图纵横比的变化。

示例: [-85 85]

数据类型: double

此 属性 为只读。

地图的经度范围,返回为 [lonmin lonmax] 形式的二元素向量。

使用 geolimits 函数更改经度范围。

当您通过调整窗口的大小来调整图的大小时,经度范围不会改变,除非是为了适应地图纵横比的变化。

示例: [-100 100]

数据类型: double

地图的中心点,指定为 [center_latitude center_longitude] 形式的二元素数值向量,其中 center_latitude 是以度为单位的纬度,center_longitude 是以度为单位的经度。纬度值必须在范围 (-90, 90) 内。

数据类型: single | double

地图的布局,包括插页和装饰元素,指定为 'normal''maximized'

描述图解
'normal'地图以插页形式放置在图的边缘一侧,如 OuterPosition 属性所定义。坐标区标签、刻度以及刻度标签均可见。标题可见(如果指定了标题)。图例(如果有)显示在地图右侧的外部区域。

Geographic bubble chart with a normal layout

'maximized'地图填满由 OuterPosition 属性定义的整个空间。坐标区标签、刻度和刻度标签处于隐藏状态。标题处于隐藏状态(即使指定了标题)。网格处于隐藏状态(即使 GridVisible 属性的值为 'on')。图例(如果有)显示在地图内部的右上角。

Geographic bubble chart with a maximized layout

数据类型: char | string

地图上比例尺的可见性,指定为 'on''off',或者指定为逻辑值 1 (true) 或 0 (false)。

数据类型: logical | char | string

地图的缩放级别,指定为范围 [0, 25] 内的数值标量。该值是以 2 为底的对数地图缩放比例。ZoomLevel 的值增加 1,地图缩放比例将翻倍。

数据类型: single | double

位置

全部展开

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

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

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

注意

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

外部大小和位置,包括标签和图例,指定为 [left bottom width height] 形式的四元素向量。默认情况下,MATLAB 按照归一化的父容器单位来测量值。要更改单位,请设置 Units 属性。[0 0 1 1] 的默认值包括容器的整个内部。

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

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

以下图窗显示由 OuterPosition 值(蓝色)和 InnerPosition 值(红色)定义的区域。

A red box surrounds a map tightly. A larger blue box also includes its title, legends, and axis labels.

注意

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

内部大小和位置,不包括标签和图例,指定为 [left bottom width height] 形式的四元素向量。默认情况下,MATLAB 按照归一化的父容器单位来测量值。要更改单位,请设置 Units 属性。

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

  • widthheight 元素是地理气泡图的维度,不包括标签和图例。

以下图窗显示由 OuterPosition 值(蓝色)和 InnerPosition 值(红色)定义的区域。

A red box surrounds a map tightly. A larger blue box also includes its title, legends, and axis labels.

注意

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

大小和位置,不包括标签和图例,指定为 [left bottom width height] 形式的四元素向量。此属性等同于 InnerPosition 属性。

注意

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

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

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

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

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

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

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

像素。

在 Windows®Macintosh 系统上,像素的大小为 1/96 英寸。此大小与系统分辨率无关。

在 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 逻辑值。

父级/子级

全部展开

父容器,指定为 FigurePanelTabTiledChartLayoutGridLayout 对象。

父级的 Children 属性中对象句柄的可见性,指定为下列值之一:

  • "on" - 对象句柄始终可见。

  • "off" - 对象句柄始终不可见。该选项用于防止另一函数无意中对其进行更改。将 HandleVisibility 设置为 "off" 可在执行该函数时暂时隐藏句柄。

  • "callback" - 对象句柄在回调或回调所调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止通过命令行访问对象,但允许回调函数访问对象。

如果父级的 Children 属性中未列出该对象,则通过搜索对象层次结构或查询句柄属性获取对象句柄的函数无法返回该对象。此类函数的示例包括 getfindobjgcagcfgconewplotclaclfclose 函数。

隐藏的对象句柄仍有效。将根 ShowHiddenHandles 属性设置为 "on" 以列出所有对象句柄,而不管其 HandleVisibility 属性设置如何。

版本历史记录

在 R2017b 中推出

全部展开