Main Content

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

geoscatter

地理坐标中的散点图

  • Scatter chart in geographic coordinates

说明

向量数据

geoscatter(lat,lon) 在地理坐标中创建一个带圆形标记的散点图。使用 lat 指定以度为单位的纬度坐标,使用 lon 指定以度为单位的经度坐标。如果当前坐标区不是地理坐标区或地图坐标区,或如果没有当前坐标区,则该函数会在一个新的地理坐标区中创建散点图。

geoscatter(lat,lon,A) 以点方阵来指定圆的大小。要对所有圆使用相同的大小,请将 A 指定为标量。要绘制不同大小的每个圆,请将 A 指定为与 latlon 大小相同的向量。

示例

geoscatter(lat,lon,A,C) 指定圆颜色。您可以为所有圆指定一种颜色,也可以更改颜色。例如,您可以通过将 C 指定为 "red" 来绘制所有红色圆。

示例

geoscatter(___,"filled") 填充圆。您可以将 "filled" 选项与上述语法中的任何输入参数组合一起使用。

示例

geoscatter(___,mkr) 指定标记类型。

表数据

示例

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

示例

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

其他选项

geoscatter(ax,___)ax 指定的地理坐标区或地图坐标区中绘图。将坐标区指定为上述任一语法中的第一个参数。

示例

geoscatter(___,Name,Value) 使用一个或多个名称-值参数指定散点图的属性。有关属性列表,请参阅 Scatter 属性

s = geoscatter(___) 返回 Scatter 对象。在创建绘图后,使用 s 设置属性。有关属性的完整列表,请参阅 Scatter 属性

示例

全部折叠

指定波士顿几个位置的经度和纬度坐标。创建一个使用填充标记的散点图。

lat = [42.3501 42.3598 42.3626 42.3668 42.3557];
lon = [-71.0870 -71.0662 -71.0789 -71.0801 -71.0662];
geoscatter(lat,lon,"filled")

通过调整范围缩小绘图。

geolimits([42.3456 42.3694],[-71.0930 -71.0536])

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

使用密西西比河沿岸几个点的纬度和经度坐标创建一个散点图。将可选的大小和颜色参数指定为向量。这些颜色值映射到颜色图中的不同颜色。

lat = [32.30 33.92 35.17 36.98 37.69 38.34];
lon = [-91.05 -91.18 -90.09 -89.11 -89.52 -90.37];
A = 100*[5 12 15 3 10 3];
C = [1 2 2 3 1 1];

geoscatter(lat,lon,A,C,"filled")

通过调整绘图的纬度和经度范围来缩小。然后,将底图更改为地形底图。

geolimits([31.60 38.91],[-95.61 -84.27])
geobasemap grayterrain

指定几个欧洲城市的经度和纬度坐标。创建一个使用品红菱形标记的散点图。

lat = [48.85 51.5 40.41 41.9 52.52 52.36 52.22 47.49 44.42 50.07 48.20 46.94];
lon = [2.35 -0.12 -3.70 12.49 13.40 4.90 21.01 19.04 26.10 14.43 16.37 7.44];

geoscatter(lat,lon,"m","d")

通过调整绘图的纬度和经度范围来缩小。然后,将底图更改为地貌底图。

geolimits([30 60],[-13 43])
geobasemap topographic

指定波士顿几个位置的经度和纬度坐标。

lat = [42.3501 42.3598 42.3626 42.3668 42.3557];
lon = [-71.0870 -71.0662 -71.0789 -71.0801 -71.0662];

创建一个散点图并设置标记边颜色、标记面颜色和线条宽度。

geoscatter(lat,lon,70,"MarkerEdgeColor",[0.9290 0.6940 0.1250], ...
    "MarkerFaceColor",[0.3010 0.7450 0.9330],"LineWidth",2)

通过调整范围缩小绘图。然后,更改底图。

geolimits([42.3456 42.3694],[-71.0930 -71.0536])
geobasemap streets-dark

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

自 R2022b 开始提供

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

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

tbl = readtable("counties.xlsx"); 

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

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

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

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

自 R2022b 开始提供

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

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

tbl = readtable("counties.xlsx");

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

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

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

s.SizeData = 100;

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

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

输入参数

全部折叠

以度为单位的纬度坐标,指定为由 [–90, 90] 范围内的元素组成的向量。向量可以包含 NaN 值。

latlon 的大小必须匹配。

示例: [43.0327 38.8921 44.0435]

数据类型: single | double

以度为单位的经度坐标,指定为向量。向量可以包含 NaN 值。

latlon 的大小必须匹配。

示例: [-107.5556 -77.0269 -72.5565]

数据类型: single | double

标记大小,指定为数值标量、数值向量或空数组 ([])。大小控制每个标记的区域(以点方阵为单位)。

  • 数值标量 - 使用统一标记大小。例如,A = 100 以 100 点方阵的区域创建所有标记。

  • 数值向量 - 对每个数据点使用不同的标记大小。A 的大小必须与 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

当您指定标记颜色时,geoscatter 函数将 Scatter 对象的 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 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")一起使用。此选项不显示没有面而只有边的标记,如 "+""*"

"filled" 选项将 Scatter 对象的 MarkerFaceColor 属性设置为 "flat",并将 MarkerEdgeColor 属性设置为 "none"。因此,此选项显示标记面,而不显示边。

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

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

索引方案示例

变量名称:

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

  • 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 对象 1MapAxes (Mapping Toolbox™) 对象。

如果不指定此参数,则 geoscatter 函数将在当前坐标区中绘图,前提是当前坐标区是地理坐标区或地图坐标区对象。

名称-值参数

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

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

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

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

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

标记轮廓颜色,指定为 "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

包含颜色数据的表变量,指定为源表的变量索引。

指定表索引

使用以下任一索引方案指定所需的变量。

索引方案示例

变量名称:

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

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

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

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

变量索引:

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

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

  • 3 - 表中的第三个变量

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

变量类型:

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

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

指定颜色数据

指定 ColorVariable 属性控制标记的颜色。当 MarkerFaceColor 属性设置为 "flat" 时,变量中的数据控制标记填充颜色。当 MarkerEdgeColor 设置为 "flat" 时,数据还可以控制标记轮廓颜色。

您指定的表变量可以包含任何数值类型的值。这些值可以是以下形式之一:

  • 线性映射到当前颜色图中的一列数字。

  • 由 RGB 三元组组成的一个三列数组。RGB 三元组是包含三个元素的向量,其元素值指定特定颜色的红、绿和蓝分量的强度。强度必须处于范围 [0,1] 中。例如,[0.5 0.7 1] 指定浅蓝色。

当您设置 ColorVariable 属性时,MATLAB 会更新 CData 属性。

输出参数

全部折叠

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

提示

  • 当您在地理坐标区上绘图时,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®.