geodesy op• Data kinds: signal × signal × signal → table
• Call: import fullseye as fs; fs.ledger.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1) (implementation को सीधे call करना हो तो import demops; demops.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1), registry से लेना हो तो opsdem.get("dem_height_frame_residual"))
• GPU: केवल chain के भीतर (allow-list का mechanical GPU path, CuPy)। पड़ोसी stage भी allow-list में हो तभी GPU पर resident रहता है। अकेली call CPU पर चलती है
h - H - N का residual — ऊँचाई की गड़बड़ी को चुप न रहने देने वाला detector (table)।
Ellipsoidal ऊँचाई, orthometric ऊँचाई और geoid ऊँचाई 1 identity (h = H + N) से जुड़ी हैं। जिन points पर सभी 3 उपलब्ध हों वहाँ इसका residual मापने से संख्यात्मक रूप से पता चलता है कि उनमें से कोई एक अलग datum, अलग model या अलग संस्करण से बना था। Survey परिणामों के बीच residual cm स्तर पर रहता है; यदि ellipsoidal ऊँचाई को सीधे orthometric ऊँचाई के रूप में उपयोग किया जाए, तो residual -N पर अटक जाता है (Japan के आसपास −30 से −40 m)।
Args:
h_ellipsoidal_m: ellipsoidal ऊँचाई [m] (जैसी GNSS लौटाता है)। Arrays अनुमत।
h_orthometric_m: उन्हीं points की orthometric ऊँचाई [m] (map, levelling)।
geoid_height_m: उन्हीं points की geoid ऊँचाई [m]।
tol_m: मानों को "संगत" मानने का threshold [m]। डिफ़ॉल्ट 0.10 m।
Returns:
{"residual_m": (n,), "rms_m", "max_abs_m", "median_m", "n", "n_over_tol", "tol_m", "fraction_over_tol"}।
बंद सूत्र से जाँचने योग्य: identity के अनुसार बनाए गए 3-tuples के लिए residual 0 है (मापा गया rms 1.2e-14 m; ठीक 0 नहीं केवल rounding के कारण)। यदि ellipsoidal ऊँचाइयाँ सीधे orthometric-height column में डाल दी जाएँ, तो residual −N पर अटक जाता है —— गड़बड़ी का आकार ज्यों-का-त्यों दिखता है।
ValueError: लंबाई का बेमेल, non-finite मान, ऋणात्मक *tol_m*।
• dem_terrain_analysis family guide
• 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 में दिए गए हैं।
• poc_geodetic_benchmarks_real — py -3.11 examples/poc_geodetic_benchmarks_real.py
table को input के रूप में लेते हैं)—
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 operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.