Main Content

geoplot

在地理坐标中绘制线条

  • Plot line in geographic coordinates

说明

向量数据

示例

geoplot(lat,lon) 在地理坐标中绘制一条线条。使用 lat 指定以度为单位的纬度坐标,使用 lon 指定以度为单位的经度坐标。如果当前坐标区不是地理坐标区或地图坐标区,或如果没有当前坐标区,则该函数将在一个新的地理坐标区中绘制线条。

示例

geoplot(lat,lon,LineSpec) 使用指定的线型、标记符号和颜色创建绘图。

示例

geoplot(lat1,lon1,...,latN,lonN) 使用同一坐标区上的多条线条绘制纬度和经度坐标对组。

geoplot(lat1,lon1,LineSpec1,...,latN,lonN,LineSpecN) 指定每个线条的线型、标记符号和颜色。您可以对某些线条指定 LineSpec,而对其他线条省略。例如,geoplot(lat1,lon1,"o",lat2,lon2) 为第一条线条指定标记,但不为第二条线条指定标记。

表数据

示例

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

其他选项

geoplot(ax,___)ax 指定的坐标区中显示绘图。将坐标区指定为上述任一语法中的第一个参量。

示例

geoplot(___,Name,Value) 使用一个或多个名称-值参量指定图形线条的属性。这些属性应用于绘制的所有线条。有关属性列表,请参阅 Line 属性

h = geoplot(___) 返回由图形线条对象组成的列向量。每个对象对应于一条绘制的线。创建绘图后,使用 h 修改该绘图的属性。有关属性列表,请参阅 Line 属性

注意

Mapping Toolbox™ 扩展了 geoplot (MATLAB®) 函数的功能。它增加了对在任何受支持的地理或投影坐标参考系 (CRS) 中显示具有坐标的点、线和多边形的支持。有关 geoplot (Mapping Toolbox) 的参考页,请参阅 geoplot (Mapping Toolbox)

示例

全部折叠

加载一个 MAT 文件,其中包含美国的连续外边缘坐标。MAT 文件中的变量 uslatuslon 分别指定以度为单位的纬度和经度坐标。在地貌底图上显示坐标。

load usapolygon.mat
geoplot(uslat,uslon)
geobasemap topographic

加载一个包含美国各州连续坐标的 MAT 文件。提取印第安纳州、田纳西州和西弗吉尼亚州的坐标。

load usastates.mat

lat1 = usastates(12).Lat;
lon1 = usastates(12).Lon;

lat2 = usastates(40).Lat;
lon2 = usastates(40).Lon;

lat3 = usastates(46).Lat;
lon3 = usastates(46).Lon;

使用三条线条显示这三个州的轮廓。

geoplot(lat1,lon1,lat2,lon2,lat3,lon3)

Figure contains an axes object with type geoaxes. The geoaxes object contains 3 objects of type line.

指定德国高速公路沿线几个点的纬度和经度坐标。使用带圆形标记的黑色虚线将这些点显示为 streets 底图上的一条线。

lat = [48.915 48.907 48.901 48.893 48.887 48.881 48.875 48.869 48.865];
lon = [10.192 10.188 10.182 10.171 10.166 10.165 10.167 10.173 10.184];

geoplot(lat,lon,"k--o")
geobasemap streets

指定密西西比河沿岸几个点的纬度和经度坐标。

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];

根据数据创建一个线图。使用 LineSpec 选项指定带方形标记的绿色虚线。使用名称-值参量指定线宽、标记大小和标记颜色。

geoplot(lat,lon,"--gs","LineWidth",2, ...
    "MarkerSize",10,"MarkerEdgeColor","b", ...
    "MarkerFaceColor",[0.5 0.5 0.5])

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

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

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

指定波士顿几个地方的地理坐标和名称。

lat = [42.3501 42.3598 42.3626 42.3668 42.3557];
lon = [-71.0870 -71.0662 -71.0789 -71.0801 -71.0662];
n = [" BACK BAY"," BEACON HILL"," BROAD CANAL"," EAST CAMBRIDGE"," FLAGSTAFF HILL"];

使用黑色星形标记在 streets 底图上绘制位置。通过调整范围缩小绘图。

geoplot(lat,lon,"k*")
geobasemap streets
geolimits([42.3456 42.3694],[-71.0930 -71.0536])

在相同的位置上显示地名。

text(lat,lon,n)

自 R2022b 开始提供

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

将一个包含 cyclone 数据的 MAT 文件加载到工作区。使用该数据的一部分创建一个表。该表的变量 LatitudeLongitude 中分别包含纬度和经度坐标。

load cycloneTracks
tbl = cycloneTracks(cycloneTracks.ID == 1320,:);

在地貌底图上绘制纬度和经度坐标。以 h 形式返回 Line 对象。

h = geoplot(tbl,"Latitude","Longitude");
geobasemap topographic

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

h.Marker = ".";
h.Color = "m";

输入参数

全部折叠

以度为单位的纬度坐标,指定为向量。

使用 NaN 值在线条中创建断点。例如,以下代码将绘制前两个元素,跳过第三个元素,然后使用最后两个元素绘制另一线条。

geoplot([10 20 NaN 30 40],[10 20 NaN 30 40])

latlon 的大小必须匹配。

示例: [43.0327 38.8921 44.0435]

数据类型: single | double

以度为单位的经度坐标,指定为向量。

使用 NaN 值在线条中创建断点。例如,以下代码将绘制前两个元素,跳过第三个元素,然后使用最后两个元素绘制另一线条。

geoplot([10 20 NaN 30 40],[10 20 NaN 30 40])

latlon 的大小必须匹配。

示例: [-107.5556 -77.0269 -72.5565]

数据类型: single | double

线型、标记和颜色,指定为包含符号的字符串标量或字符向量。符号可以按任意顺序显示。您不需要同时指定所有三个特征(线型、标记和颜色)。例如,如果忽略线型,只指定标记,则绘图只显示标记,不显示线条。

示例: "--or" 是带有圆形标记的红色虚线。

线型描述表示的线条
"-"实线

Sample of solid line

"--"虚线

Sample of dashed line

":"点线

Sample of dotted line

"-."点划线

Sample of dash-dotted line, with alternating dashes and dots

标记描述生成的标记
"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

颜色名称短名称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

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

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

索引方案示例

变量名称:

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

  • 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 都指定多个变量,则变量的数目必须相同。

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

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

示例: geoplot(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 都指定多个变量,则变量的数目必须相同。

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

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

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

目标坐标区,指定为 GeographicAxes 对象 1MapAxes (Mapping Toolbox) 对象。如果不指定此参量,则 geoplot 函数将在当前坐标区中绘图,前提是当前坐标区是地理或地图坐标区对象。

名称-值参数

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

示例: geoplot(lat,lon,LineWidth=2) 绘制一个线宽为 2 磅的线条。

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

示例: geoplot(lat,lon,"LineWidth",2) 绘制一个线宽为 2 磅的线条。

注意

使用名称-值参量为由此函数创建的 Line 对象的属性指定值。此处所列的属性只是一部分。有关完整列表,请参阅 Line 属性

属性设置适用于绘图中的所有线条。要设置单个线条的属性,请通过指定输出参量 h 来获取该线条的句柄。然后,使用圆点表示法来设置单个线条的属性。

线条颜色,指定为 RGB 三元组、十六进制颜色代码、颜色名称或短名称。

对于自定义颜色,请指定 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

示例: "blue"

示例: [0 0 1]

示例: "#0000FF"

线型,指定为下表中列出的选项之一。

线型描述表示的线条
"-"实线

Sample of solid line

"--"虚线

Sample of dashed line

":"点线

Sample of dotted line

"-."点划线

Sample of dash-dotted line, with alternating dashes and dots

"none"无线条无线条

线宽,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。如果该线条具有标记,则线条宽度也会影响标记边。

线宽不能小于像素的宽度。如果将线宽设置为小于系统上像素宽度的值,则线条显示为一个像素的宽度。

标记符号,指定为下表中的标记之一。默认情况下,图形线条没有标记。通过指定标记符号沿该线条上的每个数据点添加标记。

标记描述生成的标记
"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

"none"无标记不适用

标记填充颜色,指定为 "auto"、RGB 三元组、十六进制颜色代码、颜色名称或短名称。"auto" 选项使用与父坐标区的 Color 属性相同的颜色。如果您指定 "auto",并且坐标区图框不可见,则标记填充颜色为图窗的颜色。

对于自定义颜色,请指定 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

标记大小,指定为以磅为单位的正值,其中 1 磅 = 1/72 英寸。

输出参量

全部折叠

地理图,以 Line 对象的列向量形式返回。每个对象对应于一条绘制的线。创建对象后,可以使用 h 来修改其属性。

提示

  • 使用 geoglobe (Mapping Toolbox)geoplot3 (Mapping Toolbox) 绘制三维地理数据。

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

  • geoplot 函数基于坐标区的 ColorOrderLineStyleOrder 属性选用颜色和线型。该函数对第一种线型循环使用每种颜色。然后,再对下一个线型循环使用每种颜色,以此类推。

  • 不支持将需要笛卡尔坐标区的数据绘制为地理坐标区或地图坐标区。

  • 要在坐标区中绘制其他数据,请使用 hold on 命令。

版本历史记录

在 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®.