Main Content

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

geoscatter

地理坐标中的散点图

自 R2018b 起

  • Scatter chart in geographic coordinates

说明

向量数据

示例

geoscatter(lat,lon) 在地理坐标区中向量 latlon 指定的经纬度位置(以度为单位)显示彩色圆。latlon 的大小必须相同。

geoscatter(lat,lon,A) 使用 A 指定每个标记的面积(以平方磅为单位)。要以相同的大小绘制所有标记,请将 A 指定为标量。要以不同的大小绘制标记,请将 A 指定为长度与 latlon 相同的向量。如果未指定 A,则 geoscatter 使用默认大小。

geoscatter(lat,lon,A,C) 使用 C 指定每个标记的颜色。

geoscatter(___,'filled') 填充标记。

geoscatter(___,M) 创建散点图,其中 M 指定使用的标记。默认情况下,geoscatter 使用圆作为标记。

表数据

示例

geoscatter(tbl,latvar,lonvar) 绘制表 tbl 中的变量 latvarlonvar。要绘制一个数据集,请为 latvar 指定一个变量,为 lonvar 指定一个变量。要绘制多个数据集,请为 latvarlonvar 或两者指定多个变量。如果两个参数都指定多个变量,它们指定的变量数目必须相同。(自 R2022b 开始提供)

示例

geoscatter(tbl,latvar,lonvar,'filled') 用实心圆绘制表中的指定变量。(自 R2022b 开始提供)

其他选项

geoscatter(gx,___) 将图形绘制到 gx 指定的地理坐标区中,而不是当前坐标区中。

geoscatter(___,Name,Value) 使用一个或多个名称-值参数指定散点图的属性。属性设置适用于所有散点图。

s = geoscatter(___) 返回 Scatter 对象。创建对象之后,可使用 S 修改其属性。

示例

全部折叠

设置纬度和经度数据。

lon = (-170:10:170);
lat = 50 * cosd(3*lon);

定义控制每个标记面积的数据。

A = 101 + 100*(sind(2*lon));

定义控制每个标记颜色的数据。

C = cosd(4*lon);

在地理散点图上绘制数据,指定标记的大小数据和颜色数据。将标记指定为三角形,而不是默认的圆形。

geoscatter(lat,lon,A,C,'^')

自 R2022b 开始提供

基于表数据绘图的一种便捷方法是将表传递给 geoscatter 函数,并指定要绘制的变量。

将一个包含郡县数据的文件作为表加载到工作区中。该表的变量 LatitudeLongitude 中分别包含纬度和经度坐标。

tbl = readtable("counties.xlsx"); 

在双色底图上绘制纬度和经度坐标。以 s 形式返回 Scatter 对象。

s = geoscatter(tbl,"Latitude","Longitude");
geobasemap grayland

通过设置 MarkerMarkerEdgeColor 属性来更改绘图的标记样式和颜色。

s.Marker = "*";
s.MarkerEdgeColor = "m";

Figure contains an axes object. The axes object contains an object of type scatter.

自 R2022b 开始提供

绘制表中数据并自定义颜色和标记大小的一种方法是设置 ColorVariableSizeData 属性。您可以在调用 geoscatter 函数时将这些属性设置为名称-值参数,也可以稍后在 Scatter 对象上设置它们。

例如,将一个包含郡县数据的文件作为表加载到工作区中。该表的变量 LatitudeLongitude 中分别包含纬度和经度坐标。

tbl = readtable("counties.xlsx");

使用填充标记绘制纬度和经度坐标。以 s 形式返回 Scatter 对象。

s = geoscatter(tbl,"Latitude","Longitude","filled");

Figure contains an axes object. The axes object contains an object of type scatter.

通过设置 SizeData 属性,将标记大小更改为 100 磅。

s.SizeData = 100;

通过将 ColorVariable 属性设置为表变量来更改标记颜色。然后添加颜色栏。

s.ColorVariable = "Population2010";
c = colorbar;
c.Label.String = "County Population in 2010";

Figure contains an axes object. The axes object contains an object of type scatter.

指定纬度和经度采样数据的坐标。

lon = (-170:10:170);
lat = 50 * cosd(3*lon);

定义控制每个标记面积的数据。

A = 101 + 100*(sind(2*lon));

定义控制每个标记颜色的数据。

C = cosd(4*lon);

创建一个地理散点图,指定标记大小数据、颜色数据和标记类型。然后,更改底图。

geoscatter(lat,lon,A,C,'^')
geobasemap colorterrain

Figure contains an axes object. The axes object contains an object of type scatter.

输入参数

全部折叠

以度为单位的纬度坐标,指定为 [-90 90] 范围内的有限实数数值向量。向量可以包含嵌入的 NaN 值。lat 的大小必须与 lon 相同。

示例: [43.0327 38.8921 44.0435]

数据类型: single | double

以度为单位的经度坐标,指定为有限实数数值向量。向量可以包含嵌入的 NaN 值。lon 的大小必须与 lat 相同。

示例: [-107.5556 -77.0269 -72.5565]

数据类型: single | double

以平方磅为单位的标记大小,指定为下列形式之一:

  • 标量 - 统一的标记大小。例如,A = 100 以 100 平方磅的面积创建所有标记。

  • 向量 - 每个数据点具有不同的标记大小。该向量必须与 latlon 具有相同的长度。

  • 空方括号 [] - 面积为 36 平方磅的默认标记大小。如果您要指定颜色输入参数,但使用默认标记面积,则可以使用此选项;例如 geoscatter(lat,lon,[],c)

散点图对象的 SizeData 属性存储标记大小。

示例: 50

示例: [36 25 25 17 46]

标记颜色,指定为下列形式之一:

  • RGB 三元组或颜色名称 - 使用相同的颜色绘制所有标记。

  • 由 RGB 三元组组成的三列矩阵 - 对每个标记使用不同的颜色。矩阵的每行为对应标记指定一种 RGB 三元组颜色。行数必须等于 latlon 的长度。

  • 向量 - 对每个标记使用不同的颜色,并以线性方式将 C 中的值映射到当前颜色图。C 的长度必须等于 latlon 的长度。要更改坐标区的颜色图,请使用 colormap 函数。

RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]。此外,还可以按名称指定一些常见的颜色。下表列出长和短颜色名称选项以及对应的 RGB 三元组值。

颜色名称短名称RGB 三元组外观
"red""r"[1 0 0]

Sample of the color red

"green""g"[0 1 0]

Sample of the color green

"blue""b"[0 0 1]

Sample of the color blue

"cyan" "c"[0 1 1]

Sample of the color cyan

"magenta""m"[1 0 1]

Sample of the color magenta

"yellow""y"[1 1 0]

Sample of the color yellow

"black""k"[0 0 0]

Sample of the color black

"white""w"[1 1 1]

Sample of the color white

当您指定标记颜色时,geoscatterScatter 对象的 MarkerFaceColor 属性设置为 'flat',并将标记颜色存储在 CData 属性中。

示例: 'green'

示例: 'g'

示例: [0 1 0]

标记符号,指定为以下值之一。

标记描述生成的标记
"o"圆圈

Sample of circle marker

"+"加号

Sample of plus sign marker

"*"星号

Sample of asterisk marker

"."

Sample of point marker

"x"叉号

Sample of cross marker

"_"水平线条

Sample of horizontal line marker

"|"垂直线条

Sample of vertical line marker

"square"方形

Sample of square marker

"diamond"菱形

Sample of diamond line marker

"^"上三角

Sample of upward-pointing triangle marker

"v"下三角

Sample of downward-pointing triangle marker

">"右三角

Sample of right-pointing triangle marker

"<"左三角

Sample of left-pointing triangle marker

"pentagram"五角形

Sample of pentagram marker

"hexagram"六角形

Sample of hexagram marker

用于填充标记内部的选项,指定为 'filled'。此选项和具有一个面的标记(例如,'o''square')一起使用。

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

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

索引方案示例

变量名称:

  • 字符串、字符向量或元胞数组。

  • pattern 对象。

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

  • ["A","B"]{'A','B'} - 名为 AB 的两个变量

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

变量索引:

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

  • 由数字组成的向量。

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

  • 3 - 表中的第三个变量

  • [2 3] - 表中的第二个和第三个变量

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

变量类型:

  • vartype 下标,用于选择指定类型的变量。

  • vartype("categorical") - 包含分类值的所有变量

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

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

如果 latvarlonvar 都指定多个变量,则变量的数目必须相同。

示例: geoscatter(tbl,["lat1","lat2"],"lon") 为纬度坐标指定名为 lat1lat2 的表变量。

示例: geoscatter(tbl,2,"lon") 指定纬度坐标的第二个变量。

示例: geoscatter(tbl,vartype("numeric"),"lon") 指定纬度坐标的所有数值变量。

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

索引方案示例

变量名称:

  • 字符串、字符向量或元胞数组。

  • pattern 对象。

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

  • ["A","B"]{'A','B'} - 名为 AB 的两个变量

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

变量索引:

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

  • 由数字组成的向量。

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

  • 3 - 表中的第三个变量

  • [2 3] - 表中的第二个和第三个变量

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

变量类型:

  • vartype 下标,用于选择指定类型的变量。

  • vartype("categorical") - 包含分类值的所有变量

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

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

如果 latvarlonvar 都指定多个变量,则变量的数目必须相同。

示例: geoscatter(tbl,"lat",["lon1","lon2"]) 为经度坐标指定名为 lon1lon2 的表变量。

示例: geoscatter(tbl,"lat",2) 指定经度坐标的第二个变量。

示例: geoscatter(tbl,"lat",vartype("numeric")) 指定经度坐标的所有数值变量。

父级地理坐标区对象,指定为 GeographicAxes 对象。 1 您可以通过设置 GeographicAxes 对象的属性来修改其外观和行为。有关属性列表,请参阅 GeographicAxes 属性

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN,其中 Name 是参数名称,Value 是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。

在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name 引起来。

示例: geoscatter(lat,lon,'filled','MarkerFaceAlpha',.5) 创建经过填充的半透明标记。

此处列出的散点图对象属性只是其中的一部分。有关完整列表,请参阅 Scatter 属性

标记符号,指定为以下选项之一。

标记描述生成的标记
"o"圆圈

Sample of circle marker

"+"加号

Sample of plus sign marker

"*"星号

Sample of asterisk marker

"."

Sample of point marker

"x"叉号

Sample of cross marker

"_"水平线条

Sample of horizontal line marker

"|"垂直线条

Sample of vertical line marker

"square"方形

Sample of square marker

"diamond"菱形

Sample of diamond line marker

"^"上三角

Sample of upward-pointing triangle marker

"v"下三角

Sample of downward-pointing triangle marker

">"右三角

Sample of right-pointing triangle marker

"<"左三角

Sample of left-pointing triangle marker

"pentagram"五角形

Sample of pentagram marker

"hexagram"六角形

Sample of hexagram marker

"none"无标记不适用

标记轮廓颜色,指定为 "flat"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。默认值 "flat" 将使用 CData 属性中的颜色。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"不适用不适用不适用无颜色

以下是 MATLAB® 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

示例: [0.5 0.5 0.5]

示例: "blue"

示例: "#D2F9A7"

标记填充颜色,指定为 "flat""auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"flat" 选项使用 CData 值。"auto" 选项使用与坐标区的 Color 属性相同的颜色。

对于自定义颜色,请指定 RGB 三元组或十六进制颜色代码。

  • RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内,例如 [0.4 0.6 0.7]

  • 十六进制颜色代码是字符向量或字符串标量,以井号 (#) 开头,后跟三个或六个十六进制数字,范围可以是 0F。这些值不区分大小写。因此,颜色代码 "#FF8800""#ff8800""#F80""#f80" 是等效的。

此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称短名称RGB 三元组十六进制颜色代码外观
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"不适用不适用不适用无颜色

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

示例: [0.3 0.2 0.1]

示例: "green"

示例: "#D2F9A7"

标记边的宽度,指定为一个正值(以磅为单位)。

示例: 0.75

输出参数

全部折叠

地理散点图,以 Scatter 对象形式返回。使用 s 可在创建地理散点图后访问和修改其属性。

提示

  • 要自定义包含散点图对象的地理坐标区,请获取该对象的父对象 gx = s.Parent,然后修改其属性。有关属性列表,请参阅 GeographicAxes 属性

  • 如果您有 Mapping Toolbox™,则可以使用 addCustomBasemap 函数指定自己选择的底图。

  • 当您在地理坐标区上绘图时,geoscatter 函数假定坐标参考 WGS84 坐标参考系。如果使用参考不同坐标参考系的坐标进行绘图,则坐标可能会显示为未对齐。

版本历史记录

在 R2018b 中推出

全部展开


1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.