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 패밀리 가이드
• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL 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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.