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

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

地图

全部展开

要在上面绘制数据的地图,指定为下表中的字符串标量或字符向量之一,或者指定为 'none'

MathWorks® 提供了六个底图,可与地理坐标区和地理图结合使用。底图提供了各种显示选项,包括双色调陆海光栅图和彩色地形图等。默认情况下,地理坐标区或地理图使用随产品一起安装的 'darkwater' 底图。如果您选择了其他底图之一,地理坐标区或地理图将通过 Internet 访问地图。

如果您不能随时访问 Internet,可将由 MathWorks 托管的底图下载到您的本地系统上。有关下载底图的详细信息,请参阅在 MATLAB 中访问底图

如果您指定 'none',地理坐标区或地理图将绘制数据,包括经纬度网格、刻度和标签,但不包括地图。

底图

'darkwater'(默认值)

陆地区域:浅灰到中灰

海洋和水域:深灰色

由 MathWorks 托管。

'colorterrain'

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

由 MathWorks 托管。

'grayland'

陆地区域:浅灰到中灰

海洋和水域:白色

由 MathWorks 托管。

'grayterrain'

以灰度单调描绘的世界地形,结合着色地势,突出高山和低地的微观地形。

由 MathWorks 托管。

'bluegreen'

陆地区域:浅绿色

海洋和水域:浅蓝色

由 MathWorks 托管。

'landcover'

通过卫星照片衍生的地表覆盖数据,利用自然的浅色配色呈现着色地势,适合制作专题地图和参照地图(包括海底地势)。

由 MathWorks 托管。

示例: 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''innerposition'。默认值 'outerposition' 表示 OuterPosition 属性保持不变。当父容器的大小、数据或标签改变时,InnerPosition 属性值可能会改变。当您显示或删除大小图例或颜色图例时,InnerPosition 属性值也可能会更改。

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

示例: gb.ActivePositionProperty = 'outerposition'

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

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

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

有关说明,请参阅ActivePositionProperty

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

有关说明,请参阅ActivePositionProperty

地理气泡图在父容器(通常为图窗、面板或选项卡)中的内部大小和位置,返回为 [left bottom width height] 形式的四元素向量。此属性等同于InnerPosition属性。

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

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)。

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

父级/子级

全部展开

地理气泡图的父容器,指定为图窗、面板或选项卡对象。

在 R2017b 中推出