Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

GeographicBubbleChart 属性

控制地理气泡图的外观和行为

GeographicBubbleChart 属性控制 GeographicBubbleChart 对象的外观和行为。通过更改属性值,您可以修改图外观的各个方面。使用圆点表示法引用特定的对象和属性。以下示例使用 SizeLegendTitle 属性指定大小图例的名称。

tsunamis = readtable('tsunamis.xlsx');
tsunamis.Cause = categorical(tsunamis.Cause);
figure
gb = geobubble(tsunamis,'Latitude','Longitude', ...
        'SizeVariable','MaxHeight','ColorVariable','Cause', ...
        'Basemap','colorterrain')
geolimits([10 65],[-180 -80])
title 'Tsunamis in North America';
gb.SizeLegendTitle = 'Maximum Height';

气泡位置

全部展开

气泡位置的纬度坐标,指定为由 [-90,90] 范围内的值组成的有限实数数值向量或指定为空白 ([]) 数组。LatitudeData 的大小必须与 LongitudeData 相同,且可以包含 NaN 值。

底图图块不会扩展到 [-85 85] 的大致纬度范围之外,但气泡可以出现在这一区域。不过,这些值通常是不可见的,除非使用 MapCenterZoomLevel 属性手动控制地图范围。此外,非常接近 90 度和 -90 度的气泡也不可见,因为它们对应于无穷或接近无穷的 y 值。

数据类型: single | double

用于表示气泡纬度的表变量,指定为下列形式之一:

  • 指定要用于存储纬度信息的表变量名称的字符串标量或字符向量。例如,geobubble(__,'LatitudeVariable','Latitude') 指定名为 'Latitude' 的变量。

  • 指示表变量索引的数值标量。例如,geobubble(__,'LatitudeVariable',1) 指定表中的第一个变量作为纬度。

  • 包含一个 true 元素的逻辑向量。

与此表变量关联的值必须为数值。只有在指定表作为输入时才能使用此属性。geobubble 将此变量的值存储在 'LatitudeData' 属性中,并将 'LatitudeData' 属性设置为只读。

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

气泡位置的经度坐标,指定为由 (-Inf,Inf) 范围内的值组成的有限实数数值向量或指定为空白 ([]) 数组。LongitudeData 的大小必须与 LatitudeData 相同,且可以包含 NaN 值。

数据类型: single | double

用于表示气泡经度的表变量,指定为下列形式之一:

  • 指定要用于存储经度信息的表变量名称的字符串或字符向量。例如,geobubble(__,'LongitudeVariable','Longitude') 指定名为 'Longitude' 的表变量。

  • 指示表变量索引的数值标量。例如,geobubble(__,'LongitudeVariable',16) 指定表中的第 16 个变量作为经度。

  • 包含一个 true 元素的逻辑向量。

与此表变量关联的值必须为数值。只有在指定表作为输入时才能使用此属性。geobubble 将此变量的值存储在 'LongitudeData' 属性中,并将 'LongitudeData' 属性设置为只读。

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

气泡大小

全部展开

气泡的最小宽度和最大宽度(以磅为单位),指定为数值标量或 1×2 数值向量。值不能为降序。如果您希望所有气泡具有相同(统一)的大小,请使用标量。值必须在 [1 100] 范围内。

示例: [4 10]

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

控制气泡大小的数据,指定为 (-Inf,Inf) 范围内的数值向量或标量,或指定为空 ([]) 数组。如果指定向量,则 SizeData 的大小必须与 LatitudeDataLongitudeData 相同。如果指定标量值,地理气泡图将通过标量扩展处理该值。sizedata 可以包含 NaN 值。

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

SizeData 值映射到气泡宽度的范围,指定为由有限实数数值组成的 1×2 向量,或指定为空 ([]) 矩阵。值不能为降序。要创建大小相同的气泡,请为每个元素指定相同的值。

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

用于确定气泡大小的表变量,指定为下列形式之一:

  • 指定要用于存储大小信息的表变量名称的字符串标量或字符向量。例如,geobubble(__,'SizeVariable','MaxHeight') 指定名为 'MaxHeight' 的变量。

  • 指示表变量索引的数值标量。例如,geobubble(__,'SizeVariable',16) 指定表中的第 16 个变量。

  • 包含一个 true 元素的逻辑向量。例如,sizevar = logical([0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1]) 指定表中的第 16 个变量。

只有在指定表作为输入时才能使用此属性。与此表变量关联的值必须为数值类型。如果您指定此变量,geobubble 会将与此变量关联的数据值存储在 'SizeData' 属性中,并将此属性设置为只读。

气泡颜色

全部展开

BubbleColorList 属性控制气泡使用的颜色。值为 m×3 数组,每一行是一个 RGB 颜色三元组,其中 m 等于 ColorData 向量中的类别数,如果 ColorData 有任何未定义的元素,则 m 等于类别数加 1,如果 ColorData 为空,则 m 等于 1。默认情况下,geobubble 从包含 7 种标准颜色的有序列表中选择颜色。如果 m 大于 7,则颜色会循环重复。要更改使用的颜色,请使用 MATLAB 颜色图函数之一,例如 parulajet,或者指定您自己的自定义 RGB 值列表。

数据类型: cell | double

控制气泡颜色的数据,指定为分类向量或空数组 ([])。分配给同一类别的气泡在地图上具有相同的颜色。地理气泡图使用 BubbleColorList 属性中列出的颜色为每个类别分配一种颜色。ColorData 的大小必须与 LatitudeDataLongitudeData 匹配,除非您指定空数组。

如果您使用颜色图例,地理气泡图将在图例上显示类别值。如果有任何值包含 TeX 标记字符,例如下划线 (_),则您可能会在颜色图例上看到意外的格式。MATLAB® 支持对图例上显示的文本使用某些 TeX 标记。要在常规文本中使用 TeX 标记字符,请编辑类别的名称(使用 renamecats),并在要包含的字符之前插入 TeX 转义字符,即反斜杠 (\)。有关使用 TeX 标记添加上标和下标、修改字体类型和颜色以及在文本中包含特殊字符的信息,请参阅文本对象的Interpreter属性。

数据类型: categorical

用于确定气泡颜色的表变量,以下列形式之一指定:

  • 指定要用于存储颜色信息的表变量名称的字符串标量或字符向量。例如,geobubble(__,'ColorVariable','Cause') 指定名为 'Cause' 的变量。

  • 指示表变量索引的数值标量。例如,geobubble(__,'ColorVariable',12) 指定表中的第 12 个变量。

  • 包含一个 true 元素的逻辑向量。例如,sizevar = logical([0 0 0 0 0 0 0 0 0 0 0 1]) 指定表中的第 12 个变量。

只有在指定表作为输入时才能使用此属性。与此表变量关联的值必须为分类值。指定颜色变量时,geobubble 将与此变量关联的数据值存储在 ColorData 属性中,并将 ColorData 属性设置为只读。

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

标签

全部展开

地理气泡图的标题,指定为字符向量、字符向量元胞数组、标量字符串、字符串数组、数值数组或 categorical 值。如果将此属性指定为 categorical 数组,MATLAB 将使用数组中的值,而不是类别。也可以使用 title 函数设置此值。

默认情况下,MATLAB® 支持对您指定的文本使用某些 TeX 标记。要添加上标和下标、修改字体类型和颜色以及在文本中包含特殊字符,请使用 TeX 标记。要在常规文本中使用 TeX 标记字符,例如下划线 (_),请在要包含的字符之前插入 TeX 转义字符,即反斜杠 (\)。有关详细信息,请参阅文本对象的Interpreter属性。

要显示为颜色图例标题的文本,指定为字符向量、字符串标量、字符串数组、字符向量元胞数组、数值或 categorical 值。如果将此属性指定为 categorical 数组,MATLAB 将使用数组中的值,而不是类别。

默认情况下,MATLAB® 支持对您指定的文本使用某些 TeX 标记。要添加上标和下标、修改字体类型和颜色以及在文本中包含特殊字符,请使用 TeX 标记。要在常规文本中使用 TeX 标记字符,例如下划线 (_),请在要包含的字符之前插入 TeX 转义字符,即反斜杠 (\)。有关详细信息,请参阅文本对象的Interpreter属性。

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

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

默认情况下,MATLAB® 支持对您指定的文本使用某些 TeX 标记。要添加上标和下标、修改字体类型和颜色以及在文本中包含特殊字符,请使用 TeX 标记。要在常规文本中使用 TeX 标记字符,例如下划线 (_),请在要包含的字符之前插入 TeX 转义字符,即反斜杠 (\)。有关详细信息,请参阅文本对象的Interpreter属性。

气泡大小和颜色图例的可见性,指定为 'on''off',或者指定为逻辑值 truefalse。您还可以使用 legend 函数切换图例的可见性。

数据类型: char | string | logical

字体

全部展开

地理气泡图使用的字体,指定为字符串标量或字符向量。要正确显示和打印文本,字体名称必须是系统支持的字体。默认字体取决于具体操作系统和区域设置。要使用在任何区域设置中都有较好显示效果的等宽字体,请使用 'FixedWidth''FixedWidth' 值依赖根 FixedWidthFontName 属性。设置根 FixedWidthFontName 属性会导致立即更新显示方式以使用新字体。

示例: 'Cambria'

数据类型: char | string

地理气泡图使用的字体大小,指定为有限正实数数值标量。该值以磅为单位,一磅等于 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® 对此做出背书。

示例: gb = geobubble(1:10,1:10,'Basemap','bluegreen')

示例: gb.Basemap = 'bluegreen'

数据类型: char | string

包含要绘制的数据的表,以表的形式指定。

数据类型: table

地图上的纬度线和经度线的可见性,指定为 'on''off',或指定为逻辑值 truefalse。也可以使用 grid 函数切换网格可见性。

数据类型: logical | char | string

此 属性 为只读。

地图的纬度范围,指定为 [southern_limit northern_limit] 形式的、位于 [-90,90] 范围内的 1×2 有限实数值向量。要设置纬度范围,请使用 geolimits 函数。

数据类型: double

此 属性 为只读。

地图的经度范围,指定为 [western_limit eastern_limit] 形式的 1×2 有限实数值向量。值必须在 (-Inf, Inf) 范围内。要设置经度范围,请使用 geolimits 函数。

示例: [-100 100]

数据类型: double

以纬度和经度表示的地图中心点,指定为 [center_latitude center_longitude] 形式的二元素有限实数值向量。值必须在 [(-90,90),(-Inf, Inf)] 范围内。

示例: [38.6292 -95.2520]

数据类型: single | double

地图的布局,包括地图本身和装饰元素,指定为下列值之一。

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

Geographic bubble chart with a normal layout

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

Geographic bubble charted with a maximized layout

示例: gb = geobubble(__,'MapLayout','maximized')

示例: gb.MapLayout = 'maximized'

数据类型: char | string

地图上比例尺的可见性,指定为 'on''off',或者指定为逻辑值 truefalse

数据类型: logical | char | string

地图的放大级别,指定为介于 0 和 25 之间(包括 0 和 25)的有限实数数值标量。该值是以 2 为底的对数地图缩放比例。ZoomLevel 的值增加 1,地图缩放比例将翻倍。

数据类型: single | double

位置

全部展开

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

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

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

注意

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

地理气泡图在父容器内的大小和位置,指定为 [left bottom width height] 形式的四元素数值向量。[0 0 1 1] 的默认值包括容器的整个内部。

以下图窗显示由 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] 形式的四元素向量。内部位置不包括标题和轴标签。

  • 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/72 英寸。
'pixels'

像素。

从 R2015b 开始,以像素为单位的距离不再依赖 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 逻辑值。

父级/子级

全部展开

父容器,指定为 FigurePanelTabTiledChartLayoutGridLayout 对象。

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

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

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

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

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

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

版本历史记录

在 R2017b 中推出

全部展开