本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

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

地图

全部展开

要在其上绘制数据的地图,指定为下表中列出的值之一。其中六幅底图是图块数据集,由 MathWorks® 从公共域数据中派生而来。其中五个底图是由 Esri® 托管的高缩放级别地图。

MATLAB® 包括一个已安装的底图,一个名为 'darkwater' 的双色地图。使用此底图不需要访问 Internet。使用其他底图,包括默认底图 'streets-light',确实需要访问 Internet。

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

由 Esri 托管的五个底图标注了地图数据提供者。当您放大地图时,这些标注信息可能会发生变化,因为不同组织为不同位置提供不同缩放级别的地图数据。边界和区域标签的对齐是我们的数据供应商提供的功能的展示,并不意味着 MathWorks 对此做出背书。

'streets-light'

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

由 Esri 托管。

'satellite'

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

由 Esri 托管。

'streets-dark'

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

由 Esri 托管。

'topographic'

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

由 Esri 托管。

'streets'

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

由 Esri 托管。

'landcover'

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

由 MathWorks 提供。

'grayterrain'

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

由 MathWorks 提供。

'colorterrain'

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

由 MathWorks 提供。

'grayland'

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

由 MathWorks 提供。

'bluegreen'

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

由 MathWorks 提供。

'darkwater'

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

由 MathWorks 提供。

 

'none'

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

示例: gx = geoaxes('Basemap','bluegreen')

示例: gx.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 属性值,则图包含一个标题。图例(如果有)显示在地图右侧的外部区域。
'maximized'地图填满由 OuterPosition 属性定义的整个空间。坐标区标签、刻度和刻度标签处于隐藏状态。标题处于隐藏状态,即使设置了 Title 属性也是如此。网格处于隐藏状态,即使 GridVisible 设置为 'on' 也是如此。图例(如果有)显示在地图内部的右上角。

示例: 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 属性。

下图显示地理气泡图的 innerpositionouterposition 定义。innerposition 不包含标题或轴标签。

示例: gb.ActivePositionProperty = 'outerposition'

注意

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

地理气泡图在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,返回为 [left bottom width height] 形式的四元素向量。内部位置不包括标题和轴标签。

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

  • widthheight 元素是地理气泡图的维度。

有关说明,请参阅ActivePositionProperty

注意

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

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

有关说明,请参阅ActivePositionProperty

注意

当父容器为 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)。

布局选项,指定为 TiledChartLayoutOptions 对象。此属性指定当图是分块图布局的子级时的选项。使用此属性,设置 TiledChartLayoutOptions 对象的 TileTileSpan 属性,确定图在布局中的位置。

例如,以下代码将图 c 放在分块图布局的第三个图块中。

c.Layout.Tile = 3;

要使图占据多个图块,请将 TileSpan 属性指定为二元素向量。例如,此图占据了 2 行和 3 列的图块。

c.Layout.TileSpan = [2 3];

如果图不是分块图布局的子级(例如,如果它是图窗或面板的子级),则此属性为空且不起作用。

地理气泡图的可见性,指定为 'on''off',或者指定为逻辑值 truefalse

父级/子级

全部展开

父容器,指定为 FigurePanelTabTiledChartLayout 对象。

在 R2017b 中推出