egm96geoid

已移除了返回引用向量的 egm96geoid 函数的语法。请改用返回地理栅格引用对象的语法。与引用向量相比，引用对象具有以下几个优点。

下表展示了 egm96geoid 函数中返回引用向量的语法，以及如何修改代码以改用返回引用对象的语法。

[N,refvec] = egm96geoid(samplefactor);

[~,globalR] = egm96geoid;
latlim = globalR.LatitudeLimits;
lonlim = globalR.LongitudeLimits;
globalSize = globalR.RasterSize;
rasterSize = 1 + ceil((globalSize-1)/samplefactor);
R = georefpostings(latlim,lonlim,rasterSize);
N = egm96geoid(R);

[N,refvec] = egm96geoid(samplefactor,latlim,lonlim);

[~, globalR] = egm96geoid;
spacing = samplefactor ...
    * globalR.SampleSpacingInLatitude;
R = georefpostings(latlim,lonlim,spacing,spacing);
N = egm96geoid(R);

egm96geoid 函数中那些返回引用向量的语法会显示一条警告，提示这些语法将在未来的版本中被移除。

egm96geoid 函数中返回引用向量的语法将在未来的版本中被移除。

返回基于 EGM96 且以地理栅格参考对象为基准的大地水准面高度。您可以指定 GeographicCellsReference 或 GeographicPostingsReference 对象，或者返回整个球体上以 15 分钟为间隔的大地水准面高度及参考对象。

通过指定以度为单位的纬度和经度，返回 EGM96 标准下的大地水准面高度。例如，求纬度为 42.3601 度、经度为-71.589 度的地点的大地水准面高度：

N = egm96geoid(42.3601,-71.589);

在之前的版本中，egm96geoid 是通过 WW15MGH.GRD（一个从互联网上下载的文件）来获取大地水准面高度的。从 R2019b 版本开始，Mapping Toolbox™ 中已包含基于 EGM96 大地水准面高度网格，且 egm96geoid 不再从 WW15MGH.GRD 中读取数据。

因此，egm96geoid 函数的性能得到了提升。例如，当您返回整个大地水准面高度网格时，这段代码的速度提升了约 15 倍：

function timingTest
N = egm96geoid(1);
end

大致的执行时间为：

该代码是在配备 3.6 GHz Intel^® Xeon^® W-2133 CPU 的 Windows^® 10 测试系统上，使用 timeit 函数进行计时的：

timeit(@timingTest)