contourm
地图数据的 Project 2-D 等高线图
语法
说明
contourm(___, 用于指定等高线的样式和颜色。LineSpec)
contourm(___, 通过一个或多个名称-值参量，为等高线图指定附加选项。Name,Value)
C = contourm(___)C，其中包含各层顶点的纬度和经度坐标。
示例
从 1996 年地球重力场模型 (EGM96) 中读取大地水准面高度并导入工作区。然后，绘制等高线图并添加图例。
[Z,R] = egm96geoid; [C,h] = contourm(Z,R); xlabel("Longitude") ylabel("Latitude") clegendm(C,h,-1)
为朝鲜半岛周边地区制作一张高程图。
load korea5c worldmap(korea5c,korea5cR) geoshow(korea5c,korea5cR,DisplayType="texturemap") demcmap(korea5c)
利用 1996 年地球重力场模型 (EGM96) 中的大地水准面高度绘制等高线图。将等高线水位从 -20 指定到 40，步长为 5。
N = egm96geoid(korea5cR);
[C,h] = contourm(N,korea5cR,-20:5:40,"k");使用白色文本框并以红色文字标注等高线。
t = clabelm(C,h); set(t,"Color","r") set(t,"BackgroundColor","white") set(t,"FontWeight","bold")
自 R2024a 起
通过合并多个相邻的数据网格，生成等高线图。
将两个 DTED 文件中的高程数据读入工作区。使用 mergetiles 函数合并数据。
[Z1,R1] = readgeoraster("w106/n39.dt0",OutputType="double"); [Z2,R2] = readgeoraster("w106/n40.dt0",OutputType="double"); [Z,R] = mergetiles(Z1,R1,Z2,R2);
绘制该地区的地图。然后，在合并后的数据上显示三个级别的等高线。
figure usamap(Z,R) [cm,cp] = contourm(Z,R,3);
更改颜色图。在图例中显示等高线等级。
colormap lines leg = clegendm(cm,cp,-1); leg.Title.String = "Elevation (m)";
本示例使用了美国地质调查局提供的经修改的数据。
输入参数
常规或基于地理位置的数据网格，指定为一个 M 行 × N 列的矩阵。
contourm 函数不会为 Z 中值为 NaN 的元素显示等高线。
Z 的栅格参考，指定为 GeographicCellsReference 或 GeographicPostingsReference 对象。R 的 RasterSize 属性必须与 size(Z) 保持一致。
纬度坐标，指定为 M-by-N 矩阵或 M-元素向量。
该参量不支持 NaN 值。若要标示缺失数据，请将 Z 的相应元素设置为 NaN 的值。
经度坐标，指定为 M 行 N 列的矩阵或 M 元素的向量。
该参量不支持 NaN 值。若要标示缺失数据，请将 Z 的相应元素设置为 NaN 的值。
等高线，指定为正整数或数值向量。
若要在系统自动选择的
n等高线级别上显示等高线，请将此参量指定为n。该函数根据Z中的值选择级别。若要在特定等高线上显示等高线，请将此参量指定为一个值递增的向量。
若要显示单一等高线，
k，请将此参量指定为一个包含两个元素的行向量[k k]。
线条样式和颜色，指定为包含字符和符号的字符向量或字符串标量。这些字符和符号可以按任意顺序出现。您可以指定线条样式、线条颜色，或两者兼有。诸如 'o' 之类的标记符号将被忽略。
示例: '--g' 是一条绿色的虚线。
| 线型 | 描述 | 生成的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 虚线 |
|
| 颜色名称 | 简称 | 外观 |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
名称-值参数
将可选参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但对各个参量对组的顺序没有要求。
示例: contourm(Z,R,ShowText="on") 显示等高线标签。
如果使用的是 R2021a 之前的版本，请使用逗号分隔每个名称和值，并用引号将 Name 引起来。
示例: contourm(Z,R,"ShowText","on") 显示等高线标签。
注意
除了本节中提到的名称-值参量外，您还可以使用名称-值参量为该函数返回的 Group 对象的 HandleVisibility、Parent、Tag、UserData 和 Visible 属性指定值。有关这些组对象属性的更多信息，请参阅 Group 属性。
填充等高线之间的区域，指定为以下值之一：
"off"— 请勿用颜色填充等高线之间的区域。"on"— 将等高线之间的区域填充上颜色。
等高线沿线的标签间距，以点为单位的标量值指定，其中 1 磅等于 1/72 英寸。使用此属性可控制等高线沿线上的等高线标签数量。值越小，生成的标签就越多。
必须将 ShowText 指定为 "on"，LabelSpacing 才能生效。
如果等高线的长度小于 LabelSpacing，则该函数会在该线上显示一个标签。
等高线，指定为 Z 中值逐渐增大的行向量。默认情况下，contourm 函数会选择覆盖 Z 中所有值的范围的值。
等高线的颜色，指定为 "flat"、颜色名称、简写名称、RGB 三元组或 "none"。"flat" 的默认值会从绘制等高线的图的颜色图中，为每个等高线级别的线条选择一种不同的颜色。值 "none" 不会为线条应用任何颜色。
若要设置自定义颜色，请指定一个 RGB 三元组。RGB 三元组是一个三元素行向量，其元素分别指定颜色中红、绿、蓝三种色度的强度值。强度值必须在 [0,1] 范围内；例如，[0.4 0.6 0.7]。
或者，您可以通过名称指定一些常用颜色。本表列出了命名颜色选项及其对应的 RGB 三元组。
| 颜色名称 | 简称 | RGB 三元组 | 外观 |
|---|---|---|---|
"red" | "r" | [1 0 0] |
|
"green" | "g" | [0 1 0] |
|
"blue" | "b" | [0 0 1] |
|
"cyan" | "c" | [0 1 1] |
|
"magenta" | "m" | [1 0 1] |
|
"yellow" | "y" | [1 1 0] |
|
"black" | "k" | [0 0 0] |
|
"white" | "w" | [1 1 1] |
|
线条样式，指定为本表中所列选项之一。
| 线型 | 描述 | 生成的线条 |
|---|---|---|
"-" | 实线 |
|
"--" | 虚线 |
|
":" | 点线 |
|
"-." | 虚线 |
|
"none" | 无 | 无 |
等高线宽度，以点为单位的正标量。1 磅等于 1/72 英寸。
等高线标签，指定为以下值之一：
"on"— 在等高线旁显示等高线高程。"off"— 请勿标注等高线。
