/** * 클라이언트 사이드 3D 좌표 변환 투영 * * Python advanced_tuner_v2.py 와 동일한 알고리즘: * R_b2w = Rz(-yaw) * Rx(pitch) * Ry(roll) * R_align = [[1,0,0],[0,0,-1],[0,1,0]] * R_w2c = R_align @ R_b2w.T * * 좌표계: EPSG:5186 TM [East(m), North(m), Up(m)] * Python swap_xy=ON 과 동일: easting=X, northing=Y * sensorH 기본값 20.25mm = 36 × (9/16), 16:9 동영상 기준 */ import proj4 from 'proj4'; export interface DroneFrameBasic { frame: number; lat: number; lon: number; altitude: number; yaw: number; pitch: number; roll: number; focalLen: number; } /** * 카메라 파라미터 — Python advanced_tuner_v2.py 기본값 기준 * * yaw / pitch / roll 은 모두 SRT 프레임값에 더하는 오프셋 (기본 0). * Python: pitch = radians(meta['pitch'] + spn_pitch.value()) ← spn_pitch 기본 0 * focalLen / sensorW / sensorH 는 Python spn_focal(24) / spn_sensor(36) 기본값. * offX/offY/offZ: 드론 위치 보정 — Python off_x/y/z 동치. */ export interface CameraParams { timeOffsetSec?: number; // 영상↔비행로그 시간동기 보정(초). + = 로그를 뒤로 밀어 참조. // POI 가 진행방향으로 일괄 밀릴 때 조정 — "풀 붙임" 정합의 핵심 값. yawOffset: number; // yaw 오프셋 (degrees, per-frame SRT yaw에 더함) pitch: number; // pitch 오프셋 (degrees, per-frame SRT pitch에 더함, 기본 0) roll: number; // roll 오프셋 (degrees, per-frame SRT roll에 더함, 기본 0) focalLen: number; // 초점거리 (35mm 환산 mm, 기본 24) cx0: number; // 주점 X 오프셋 (정규화) cy0: number; // 주점 Y 오프셋 (정규화) offX: number; // 드론 위치 East 보정 (m, 기본 0) offY: number; // 드론 위치 North 보정 (m, 기본 0) offZ: number; // 드론 위치 Up 보정 (m, 기본 0) geoidOffset: number; // 지오이드고 (m) — 대상 정표고(EL)→타원체고 변환. 드론 abs_alt(타원체고)와 datum 일치용. 대전≈25.8 poiZOffset: number; // POI 전용 표고 보정 (m) — POI/구조물 마커만 들어올림. 측점·중심선엔 미적용. // POI는 실제 표고 데이터가 없어 선로 지면 높이로 가정됨 → 건물/지형이 선로보다 높을 때 보정. sensorW: number; // 센서 폭 (mm, 기본 36) sensorH: number; // 센서 높이 (mm, 기본 20.25 = 36×9/16, 16:9 영상) } /** Python advanced_tuner_v2.py 기본값 */ export const DEFAULT_CAMERA_PARAMS: CameraParams = { timeOffsetSec: 0, yawOffset: 0, pitch: 0, // offset, Python spn_pitch 기본값 0 roll: 0, // offset, Python spn_roll 기본값 0 focalLen: 24, // Python spn_focal 기본값 24 cx0: 0, cy0: 0, offX: 0, offY: 0, offZ: 0, geoidOffset: 25.8, // 대전 KNGeoid18 ≈ 25.8m (정표고 → 타원체고) poiZOffset: 0, // POI 표고 보정 기본 0 (건물 높이/지형차에 맞춰 패널에서 조정) sensorW: 36, // Python spn_sensor 기본값 36 sensorH: 20.25, }; /** 항상 DEFAULT_CAMERA_PARAMS 반환 (Python 방식: SRT 값은 per-frame으로 자동 적용됨) */ export function paramsFromFrame(_frame: DroneFrameBasic): CameraParams { return { ...DEFAULT_CAMERA_PARAMS }; } // EPSG:5186 Korean TM 정의 (Python pyproj와 동일) proj4.defs('EPSG:5186', '+proj=tmerc +lat_0=38 +lon_0=127 +k=1 +x_0=200000 +y_0=600000 +ellps=GRS80 +units=m +no_defs' ); const _toTM = proj4('EPSG:4326', 'EPSG:5186'); /** 위경도 → EPSG:5186 TM [easting(m), northing(m)] */ function latLonToTM(lat: number, lon: number): [number, number] { // proj4: forward(lon, lat) → [easting, northing] const [e, n] = _toTM.forward([lon, lat]); return [e, n]; } function toRad(d: number) { return d * Math.PI / 180; } /** 위경도+표고 → 월드 [East, North, Up] (m). * Python swap_xy=ON 방식: EPSG:5186 TM easting/northing + altitude */ function geoToEnu( lat: number, lon: number, alt: number, _refLat: number, _refLon: number, refAlt: number, ): [number, number, number] { const [e, n] = latLonToTM(lat, lon); return [e, n, alt - refAlt]; } export interface ProjectResult { px: number; // 0~1, 0=왼쪽 (클램프됨) py: number; // 0~1, 0=위 (클램프됨) pxRaw: number; // 클램프 없는 원본 pyRaw: number; dist: number; // 수평 거리 (m) h: number; // 수평각 (degrees) v: number; // 수직각 (degrees) inFov: boolean; } type Vec3 = [number, number, number]; /** 카메라 좌표 (Zc 부호 체크 없음 — 근거리 클리핑은 호출자가 처리) */ export interface CameraCoords { Xc: number; Yc: number; Zc: number; /** 수평(평면) 거리 (m) — 고도차 무시한 동·북 거리. POI 거리필터용. toCameraCoords가 채움. */ distH?: number; /** 진행방향(yaw) 기준 앞쪽 수평거리 (m, +앞). 앞/옆 비등방 거리필터용. */ fwd?: number; /** 진행방향 기준 옆쪽(좌우) 수평거리 (m, 부호=좌우). 필터는 |side| 사용. */ side?: number; } /** 카메라 좌표 → 정규화 픽셀 (Zc > 0 보장 후 호출) */ export function pixelFromCamera( cc: CameraCoords, params: CameraParams, ): { pxRaw: number; pyRaw: number } { const f = params.focalLen; const sW = params.sensorW ?? 36; const sH = params.sensorH ?? 20.25; return { pxRaw: (0.5 + params.cx0) + (cc.Xc / cc.Zc) * (f / sW), pyRaw: (0.5 + params.cy0) + (cc.Yc / cc.Zc) * (f / sH), }; } /** * 역투영 — 화면 정규픽셀(px,py) + 현재 카메라에서 월드 좌표(lat/lon/z)를 복원. * 2D→3D는 깊이가 모호하므로 **슬랜트 거리(range)를 유지**한다. 한 번의 드래그로 * 수평(lat/lon)과 수직(z)이 함께 바뀐다(POI 마우스 보정용). * * px = 0.5 + (Xc/Zc)·(f/sW), py = 0.5 + (Yc/Zc)·(f/sH) 의 역: * 카메라방향 dir ∝ ((px-0.5)·sW/f, (py-0.5)·sH/f, 1) → range로 정규화 → (Xc,Yc,Zc) * rel = R_w2cᵀ·(Xc,Yc,Zc), stEnu = drEnuAdj + rel * z(정표고) = camera.alt + offZ + rel_up − geoid (투영이 다시 geoid를 더함) */ export function worldFromPixel( camera: DroneFrameBasic, px: number, py: number, range: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): { lat: number; lon: number; z: number } { const f = params.focalLen, sW = params.sensorW ?? 36, sH = params.sensorH ?? 20.25; // 1) 카메라 프레임 방향 → range 로 스케일 const dx = ((px - 0.5) - (params.cx0 ?? 0)) * sW / f; const dy = ((py - 0.5) - (params.cy0 ?? 0)) * sH / f; const dz = 1; const len = Math.sqrt(dx * dx + dy * dy + dz * dz); const Xc = dx / len * range, Yc = dy / len * range, Zc = dz / len * range; // 2) rel = R_w2cᵀ · cam. (R_w2c row0=col0(b2w), row1=-col2(b2w), row2=col1(b2w)) const b2w = buildRotation(camera, params); const w2c: [Vec3, Vec3, Vec3] = [ [b2w[0][0], b2w[1][0], b2w[2][0]], [-b2w[0][2], -b2w[1][2], -b2w[2][2]], [b2w[0][1], b2w[1][1], b2w[2][1]], ]; const cam: Vec3 = [Xc, Yc, Zc]; const rel: Vec3 = [ w2c[0][0] * cam[0] + w2c[1][0] * cam[1] + w2c[2][0] * cam[2], w2c[0][1] * cam[0] + w2c[1][1] * cam[1] + w2c[2][1] * cam[2], w2c[0][2] * cam[0] + w2c[1][2] * cam[1] + w2c[2][2] * cam[2], ]; // 3) 월드 ENU. drEnu[0],[1] = 절대 TM easting/northing const refPt = ref ?? { lat: camera.lat, lon: camera.lon, alt: camera.altitude }; const drEnu = geoToEnu(camera.lat, camera.lon, camera.altitude, refPt.lat, refPt.lon, refPt.alt); const E = drEnu[0] + (params.offX ?? 0) + rel[0]; const N = drEnu[1] + (params.offY ?? 0) + rel[1]; const z = camera.altitude + (params.offZ ?? 0) + rel[2] - (params.geoidOffset ?? 0); const [lon, lat] = _toTM.inverse([E, N]); return { lat, lon, z }; } /** * 표고 역산 — POI의 lat/lon은 고정하고, 화면 세로위치(pyTarget)에 맞는 z(정표고)를 구한다. * "POI가 진행방향으로 앞에 밀려 보이는(표고 과대) 슬라이드" 보정용: 드래그로 실제 지면에 * 내려놓으면 그 z가 저장되어 전 거리에서 정렬된다. * * py = 0.5 + cy0 + (Yc/Zc)·(f/sH). Yc,Zc 는 z에 1차(rel_up 가 z에 비례) → * Yc=Yc0+dYc·u, Zc=Zc0+dZc·u (u=z−z0), R=(py−0.5−cy0)·sH/f=Yc/Zc 풀이: * u = (R·Zc0 − Yc0)/(dYc − R·dZc) */ export function solveZForPixelY( camera: DroneFrameBasic, lat: number, lon: number, z0: number, pyTarget: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): number { const cc0 = toCameraCoords(camera, lat, lon, z0, params, ref); const b2w = buildRotation(camera, params); const dXc = b2w[2][0]; // col0 Up 성분 const dYc = -b2w[2][2]; // -col2 Up const dZc = b2w[2][1]; // col1 Up void dXc; const f = params.focalLen, sH = params.sensorH ?? 20.25; const R = (pyTarget - 0.5 - (params.cy0 ?? 0)) * sH / f; const denom = dYc - R * dZc; if (Math.abs(denom) < 1e-9) return z0; return z0 + (R * cc0.Zc - cc0.Yc) / denom; } /** * 화면점 → 지면 좌표(lat/lon). 카메라 광선을 표고 zGround 의 수평면과 교차. * POI 좌표(지오코딩) 오차 보정용: 드래그한 지면 지점의 lat/lon 을 돌려줌(z는 유지). * 가까운/내려보는 프레임(가파른 광선)에서 정확. 먼 프레임(얕은 광선)은 민감 → 부정확. */ export function groundPointFromPixel( camera: DroneFrameBasic, px: number, py: number, zGround: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): { lat: number; lon: number } | null { const f = params.focalLen, sW = params.sensorW ?? 36, sH = params.sensorH ?? 20.25; const dxc = ((px - 0.5) - (params.cx0 ?? 0)) * sW / f; const dyc = ((py - 0.5) - (params.cy0 ?? 0)) * sH / f; const cam: Vec3 = [dxc, dyc, 1]; const b2w = buildRotation(camera, params); const w2c: [Vec3, Vec3, Vec3] = [ [b2w[0][0], b2w[1][0], b2w[2][0]], [-b2w[0][2], -b2w[1][2], -b2w[2][2]], [b2w[0][1], b2w[1][1], b2w[2][1]], ]; // 월드 ENU 방향 dir = R_w2cᵀ · cam const dir: Vec3 = [ w2c[0][0] * cam[0] + w2c[1][0] * cam[1] + w2c[2][0] * cam[2], w2c[0][1] * cam[0] + w2c[1][1] * cam[1] + w2c[2][1] * cam[2], w2c[0][2] * cam[0] + w2c[1][2] * cam[1] + w2c[2][2] * cam[2], ]; if (Math.abs(dir[2]) < 1e-9) return null; // 광선 rel = t·dir, 목표면 rel_up = (zGround+geoid) − droneAlt − offZ const refPt = ref ?? { lat: camera.lat, lon: camera.lon, alt: camera.altitude }; const drEnu = geoToEnu(camera.lat, camera.lon, camera.altitude, refPt.lat, refPt.lon, refPt.alt); const relUpTarget = (zGround + (params.geoidOffset ?? 0)) - camera.altitude - (params.offZ ?? 0); const t = relUpTarget / dir[2]; if (t <= 0) return null; // 카메라 뒤/위 const E = drEnu[0] + (params.offX ?? 0) + t * dir[0]; const N = drEnu[1] + (params.offY ?? 0) + t * dir[1]; const [lon, lat] = _toTM.inverse([E, N]); return { lat, lon }; } // ── 공통 내부 계산 ──────────────────────────────────────────────────────────── function buildRelEnu( camera: DroneFrameBasic, targetLat: number, targetLon: number, targetAlt: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): { relEnu: Vec3; dist: number } { const refPt = ref ?? { lat: camera.lat, lon: camera.lon, alt: camera.altitude }; // 대상 정표고(EL) + 지오이드고 → 타원체고. 드론 abs_alt(타원체고)와 datum 일치. const stEnu = geoToEnu(targetLat, targetLon, targetAlt + (params.geoidOffset ?? 0), refPt.lat, refPt.lon, refPt.alt); const drEnu = geoToEnu(camera.lat, camera.lon, camera.altitude, refPt.lat, refPt.lon, refPt.alt); const drEnuAdj: Vec3 = [ drEnu[0] + (params.offX ?? 0), drEnu[1] + (params.offY ?? 0), drEnu[2] + (params.offZ ?? 0), ]; const relEnu: Vec3 = [stEnu[0] - drEnuAdj[0], stEnu[1] - drEnuAdj[1], stEnu[2] - drEnuAdj[2]]; const dist = Math.sqrt(relEnu[0] ** 2 + relEnu[1] ** 2); return { relEnu, dist }; } function buildRotation(camera: DroneFrameBasic, params: CameraParams): [Vec3, Vec3, Vec3] { const yaw = toRad(camera.yaw + params.yawOffset); const pitch = toRad(camera.pitch + params.pitch); const roll = toRad(camera.roll + params.roll); const cy = Math.cos(yaw), sy = Math.sin(yaw); const cp = Math.cos(pitch), sp = Math.sin(pitch); const cr = Math.cos(roll), sr = Math.sin(roll); return [ [ cy*cr + sy*sp*sr, sy*cp, cy*sr - sy*sp*cr], [-sy*cr + cy*sp*sr, cy*cp, -sy*sr - cy*sp*cr], [ -cp*sr, sp, cp*cr ], ]; } function applyRw2c(b2w: [Vec3, Vec3, Vec3], rel: Vec3): CameraCoords { return { Xc: b2w[0][0]*rel[0] + b2w[1][0]*rel[1] + b2w[2][0]*rel[2], Yc: -(b2w[0][2]*rel[0] + b2w[1][2]*rel[1] + b2w[2][2]*rel[2]), Zc: b2w[0][1]*rel[0] + b2w[1][1]*rel[1] + b2w[2][1]*rel[2], }; } /** * 카메라 좌표만 반환 (Zc 체크 없음). * 선로 중심선 근거리 클리핑(Python 방식)에 사용. */ export function toCameraCoords( camera: DroneFrameBasic, targetLat: number, targetLon: number, targetAlt: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): CameraCoords { const { relEnu, dist } = buildRelEnu(camera, targetLat, targetLon, targetAlt, params, ref); const b2w = buildRotation(camera, params); const cc = applyRw2c(b2w, relEnu); cc.distH = dist; // 수평(평면) 거리 — 고도차 무시 // 진행방향(yaw, 북=0 시계방향) 기준 앞/옆 수평성분. heading=(sinθ[E],cosθ[N]). const yaw = toRad(camera.yaw + params.yawOffset); const sy = Math.sin(yaw), cy = Math.cos(yaw); cc.fwd = relEnu[0] * sy + relEnu[1] * cy; // +앞 cc.side = relEnu[0] * cy - relEnu[1] * sy; // 우(+)/좌(-) return cc; } /** * Python advanced_tuner_v2.py 와 동일한 투영 공식 * * 회전 행렬: * R_b2w = Rz(-yaw) × Rx(pitch) × Ry(roll) * R_align = [[1,0,0],[0,0,-1],[0,1,0]] (body→camera 축 변환) * R_w2c = R_align × R_b2w.T * * 투영: * pts_cam = R_w2c × rel_enu * u_norm = 0.5 + (Xc/Zc) × (f/sensorW) * v_norm = 0.5 + (Yc/Zc) × (f/sensorH) * * 드론 위치 오프셋 (off_x/y/z): 카메라 위치를 ENU 공간에서 보정 */ export function projectPoint( camera: DroneFrameBasic, targetLat: number, targetLon: number, targetAlt: number, params: CameraParams, ref?: { lat: number; lon: number; alt: number }, ): ProjectResult | null { const refPt = ref ?? { lat: camera.lat, lon: camera.lon, alt: camera.altitude }; // 1. 월드 ENU (m) — 대상 정표고 + 지오이드고 → 타원체고 (드론 abs_alt와 datum 일치) const stEnu = geoToEnu(targetLat, targetLon, targetAlt + (params.geoidOffset ?? 0), refPt.lat, refPt.lon, refPt.alt); const drEnu = geoToEnu(camera.lat, camera.lon, camera.altitude, refPt.lat, refPt.lon, refPt.alt); // 드론 위치 보정 적용 (Python: drone_pos = [dx+off_x, dy+off_y, alt+off_z]) const drEnuAdj: Vec3 = [ drEnu[0] + (params.offX ?? 0), drEnu[1] + (params.offY ?? 0), drEnu[2] + (params.offZ ?? 0), ]; const relEnu: Vec3 = [ stEnu[0] - drEnuAdj[0], stEnu[1] - drEnuAdj[1], stEnu[2] - drEnuAdj[2], ]; const dist = Math.sqrt(relEnu[0] ** 2 + relEnu[1] ** 2); // 2. 회전 행렬 (Python 방식: Rz(-yaw)*Rx(pitch)*Ry(roll), 모두 라디안) // Python: yaw=radians(meta['yaw']+off_yaw), pitch=radians(meta['pitch']+off_pitch), ... const yaw = toRad(camera.yaw + params.yawOffset); const pitch = toRad(camera.pitch + params.pitch); // SRT per-frame + offset const roll = toRad(camera.roll + params.roll); // SRT per-frame + offset const cy = Math.cos(yaw), sy = Math.sin(yaw); const cp = Math.cos(pitch), sp = Math.sin(pitch); const cr = Math.cos(roll), sr = Math.sin(roll); // Rz(-yaw): rotation around Z by -yaw // [[cy, sy, 0], [-sy, cy, 0], [0, 0, 1]] // Rx(pitch): rotation around X by pitch // [[1, 0, 0], [0, cp, -sp], [0, sp, cp]] // Ry(roll): rotation around Y by roll // [[cr, 0, sr], [0, 1, 0], [-sr, 0, cr]] // // R_b2w = Rz(-yaw) * Rx(pitch) * Ry(roll) // Computed element by element: const b2w: [Vec3, Vec3, Vec3] = [ [ cy*cr + sy*sp*sr, sy*cp, cy*sr - sy*sp*cr, ], [ -sy*cr + cy*sp*sr, cy*cp, -sy*sr - cy*sp*cr, ], [ -cp*sr, sp, cp*cr, ], ]; // R_w2c = R_align @ R_b2w.T (R_align = [[1,0,0],[0,0,-1],[0,1,0]]) // // R_w2c rows are derived from columns of R_b2w: // R_w2c row 0 = col 0 of R_b2w (R_align row 0 = [1,0,0]) // R_w2c row 1 = -(col 2 of R_b2w) (R_align row 1 = [0,0,-1]) // R_w2c row 2 = col 1 of R_b2w (R_align row 2 = [0,1,0]) // // p_cam = R_w2c @ relEnu → access b2w columns (swap first index across rows) const Xc = b2w[0][0]*relEnu[0] + b2w[1][0]*relEnu[1] + b2w[2][0]*relEnu[2]; // col 0 const Yc = -(b2w[0][2]*relEnu[0] + b2w[1][2]*relEnu[1] + b2w[2][2]*relEnu[2]); // -col 2 const Zc = b2w[0][1]*relEnu[0] + b2w[1][1]*relEnu[1] + b2w[2][1]*relEnu[2]; // col 1 if (Zc <= 0) return null; // 3. 핀홀 투영 (Python: u=f_px*(Xc/Zc)+w/2, v=f_px*(Yc/Zc)+h/2) const f = params.focalLen; const sW = params.sensorW ?? 36; const sH = params.sensorH ?? 20.25; const pxRaw = (0.5 + params.cx0) + (Xc / Zc) * (f / sW); const pyRaw = (0.5 + params.cy0) + (Yc / Zc) * (f / sH); return { px: Math.max(0, Math.min(1, pxRaw)), py: Math.max(0, Math.min(1, pyRaw)), pxRaw, pyRaw, dist, h: Math.atan2(Xc, Zc) * (180 / Math.PI), v: Math.atan2(-Yc, Zc) * (180 / Math.PI), inFov: pxRaw >= 0 && pxRaw <= 1 && pyRaw >= 0 && pyRaw <= 1, }; }