dem_height_frame_residual — DEM geodesy op

• 数据种类:signal × signal × signal → table

• 调用: import fullseye as fs; fs.ledger.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1)(要直接调用实现,import demops; demops.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1);从台账取用则 opsdem.get("dem_height_frame_residual"))

用法

> 该算子的说明尚无译文,以下照原文给出。

`h - H - N の残差 —— 高さの取り違えを**静かにさせない**検出器(table`)。

楕円体高・標高・ジオイド高は 1 つの恒等式で結ばれている(`h = H + N`)。

3 つそろった点でその残差を測れば、**どれかが別の基準・別のモデル・別の版で

作られている**ことが数値で出る。測量成果どうしなら残差は cm 級に収まり、

楕円体高をそのまま標高として使っていれば残差は `-N`(日本付近で −30〜−40 m)

に張り付く。

Args:

h_ellipsoidal_m: 楕円体高 [m] (GNSS の返り)。配列可。

h_orthometric_m: 同じ点の標高 [m] (地図・水準測量)。

geoid_height_m: 同じ点のジオイド高 [m]。

tol_m: 「合っている」とみなす閾値 [m]。既定 0.10 m。

Returns:

``{"residual_m": (n,), "rms_m", "max_abs_m", "median_m", "n",

"n_over_tol", "tol_m", "fraction_over_tol"}``。

閉じた式で検査できること: 恒等式どおりに作った 3 つ組では残差は 0 になる

(実測 rms 1.2e-14 m。丸めの分だけ厳密な 0 ではない)。標高の列に楕円体高を

そのまま入れると残差は −N に張り付く —— 取り違えの量がそのまま出る。

ValueError: 長さの食い違い、非有限、負の *tol_m*。

详细使用指南

• dem_terrain_analysis 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者・年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• poc_geodetic_benchmarks_real — py -3.11 examples/poc_geodetic_benchmarks_real.py

类型可衔接的下一个算子(可接受 table 作为输入)

—

同类别(geodesy)

dem_geodetic_to_ecef · dem_ecef_to_geodetic · dem_geocentric_grid · dem_earth_curvature_drop · dem_cell_size_webmercator · dem_geodetic_slope · dem_geoid_height · dem_height_frame_convert


*Provenance: demops.py — DEM 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.