dem_height_frame_residual — DEM geodesy op

• Datenarten: signal × signal × signal → table

• Aufruf: import fullseye as fs; fs.ledger.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1) (die Implementierung direkt: import demops; demops.dem_height_frame_residual(h_ellipsoidal_m, h_orthometric_m, geoid_height_m, tol_m=0.1); aus dem Register: opsdem.get("dem_height_frame_residual"))

Verwendung

Residuum h - H - N — ein Detektor, der eine Verwechslung der Höhen nicht stillschweigend durchgehen lässt (table).

Ellipsoidische Höhe, orthometrische Höhe und Geoidhöhe sind durch 1 Identität verbunden (h = H + N). Misst man deren Residuum an Punkten, an denen alle 3 vorliegen, zeigt sich numerisch, dass eine davon mit einem anderen Bezugssystem, einem anderen Modell oder einer anderen Version erstellt wurde. Zwischen Vermessungsergebnissen bleibt das Residuum im cm-Bereich; wird die ellipsoidische Höhe direkt als orthometrische Höhe verwendet, klebt das Residuum an -N (−30 bis −40 m in der Nähe Japans) fest.

Args:

h_ellipsoidal_m: ellipsoidische Höhe [m] (von GNSS geliefert). Arrays erlaubt.

h_orthometric_m: orthometrische Höhe derselben Punkte [m] (Karte, Nivellement).

geoid_height_m: Geoidhöhe derselben Punkte [m].

tol_m: Schwelle [m], ab der Werte als "stimmig" gelten. Standard 0.10 m.

Returns:

{"residual_m": (n,), "rms_m", "max_abs_m", "median_m", "n", "n_over_tol", "tol_m", "fraction_over_tol"}.

Per geschlossener Form prüfbar: bei gemäß der Identität gebildeten 3-Tupeln ist das Residuum 0 (gemessen rms 1.2e-14 m; nur wegen Rundung nicht exakt 0). Trägt man in die Spalte der orthometrischen Höhe die ellipsoidische Höhe direkt ein, klebt das Residuum an −N —— der Betrag der Verwechslung tritt unverändert hervor.

ValueError: Längen passen nicht zusammen, nicht-endliche Werte, negatives *tol_m*.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie dem_terrain_analysis

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_geodetic_benchmarks_real — py -3.11 examples/poc_geodetic_benchmarks_real.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

—

Gleiche Kategorie (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. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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