dem_height_frame_convert — DEM geodesy op

• Data kinds: signal × signal → signal

• Call: import fullseye as fs; fs.ledger.dem_height_frame_convert(height_m, geoid_height_m, frm='ellipsoidal', to='orthometric') (implementation को सीधे call करना हो तो import demops; demops.dem_height_frame_convert(height_m, geoid_height_m, frm='ellipsoidal', to='orthometric'), registry से लेना हो तो opsdem.get("dem_height_frame_convert"))

उपयोग

ऊँचाई का reference बदलता है: ellipsoidal height h ↔ orthometric height H (H = h - N)। signal।

"ऊँचाई" एक ही शब्द के तहत 2 अलग-अलग चीज़ें प्रचलित हैं, और दोनों बिना exception उठाए maps पर पहुँच जाती हैं। यह op आपको यह लिखने के लिए बाध्य करता है कि आप किससे किसमें बदल रहे हैं —— डिफ़ॉल्ट मौजूद हैं, लेकिन frm और to docstring में नहीं, code में बने रहते हैं।

Args:

height_m: ऊँचाई [m]। Arrays अनुमत।

geoid_height_m: उन्हीं points पर geoid ऊँचाई N [m] —— dem_geoid_height से देखा गया मान।

Scalar या array।

frm / to: "ellipsoidal" (ellipsoidal ऊँचाई) या "orthometric" (orthometric ऊँचाई)।

Returns:

(n,) रूपांतरित ऊँचाइयाँ [m]। यदि frm == to तो मान नहीं बदलते।

बंद सूत्र से क्या जाँचा जा सकता है: H = h - N स्वयं परिभाषा है, इसलिए ground truth एक घटाव से आता है। round-trip (h→H→h) error 5e-13 m या कम मापी गई (5,000 points, ऊँचाई −100 से 4000 m, N ±100 m)। Bit-identical नहीं —— (h - N) + N rounding से 1 ulp खिसक सकता है, और माप में 5,000 में से 273 points ने ऐसा किया। इसीलिए "round trip के बाद मूल पर लौट आता है" को समानता के रूप में नहीं लिखा जाता।

ValueError: अज्ञात frame नाम, लंबाई का बेमेल, non-finite।

उपयोग की विस्तृत guide

• dem_terrain_analysis family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• poc_geodetic_benchmarks_real — py -3.11 examples/poc_geodetic_benchmarks_real.py

वे अगले ops जिनसे type जुड़ता है (signal को input के रूप में लेते हैं)

dem_height_frame_residual

इसी category के (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_residual


*Provenance: demops.py — DEM operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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