knowledge(요구): 분석 608 — 안 쓰는 필터 넷 · 서피스 셋 · 수치지형도 비교 다섯 · 안 부름 여섯 지움 검토 · 약 1,800 줄

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015uTVHFZkNcUa1SR4cNcENM

docs/raw/요구_1103/_분석_608_안쓰는필터서피스지움검토.md

@@ -0,0 +1,149 @@
+# 608 안 쓰는 필터 · 서피스 지움 검토
+
+기준 — `main_laptop_1` 2d69a494b · 줄 번호는 이 판(766 합친 뒤 조금 밀림) · storage · DB 는 2026-11-03 SELECT · 파일 읽기만 · 시험 판정은 코드 읽기(실행 안 함).
+
+## 결론
+
+1. 지워도 되는 것 확인 — 필터 넷(CSF · 격자 최저 · PMF · RANSAC) · 서피스 셋(TIN · NURBS · 점 서피스) + TIN 평활 · 수치지형도 비교 방식 다섯 · 아무도 안 부르는 옛 길 여섯. 기본 길 · 등고선 · 종횡단 · 경로 찾기 · B07 음영 · D · E · 배수 · 서버 Node 묶음 어디도 기대지 않음.
+2. 남길 것 — 필터 넷(업체 분류 · 점진 TIN · 둘의 다듬기 판) · 서피스 둘(DTM · implicit) · DTM 평활(B07 · D03 음영과 수치지형도 확정이 읽음) · 수치지형도 라플라스.
+3. 남은 자료는 CSF 것뿐 — B 14 개 + D 1 개 = 15 프로젝트 · 파일 191 개 2.2 GB · DB 지표면 행 29 개(확정 · 노선 연결 0). 나머지 지울 갈래 자료는 0.
+4. 다시 전처리(765-7)는 DB 행만 거의 지우고 파일 2.2 GB · D 행 1 개는 남김 → 일회 지움 도구 한 번 권함.
+5. 코드 약 1,800 줄 지움 · 시험 2 개 지움 · 13 개 고침 · 14 개 이름만 · 766 합친 뒤 765-7 전에(지형 통째 다시 짓기가 한 번으로 겹침).
+
+## 1. 지울 것 · 남길 것
+
+| 대상 | 판정 | 쓰는 곳 | 기대는 것 | 지우면 바뀌는 것 |
+|---|---|---|---|---|
+| CSF | 지움 | B04 드롭다운(관리자)만 · 기본 길 · 자동 고름 · 확정 기본 · D03 · B05 · B07 · E · 배수 · tools · Node 묶음 안 씀 | 없음 · B07 음영 기본값 글자 「csf」 하나(확정값이 늘 있어 안 탐) · E 사본 = `dtm_classification` | 드롭다운에서 빠짐 · 남은 자료 2.2 GB 는 도구로 |
+| 격자 최저(grid_min_z) | 지움 | 드롭다운만 | 점진 TIN 씨앗은 자기 코드(Grid 안 부름) · `SURFACE_GRID_*` 설정도 Grid 만 | 자료 0 |
+| PMF | 지움 | 드롭다운만 · 시험 없음 | 없음 | 자료 0 |
+| RANSAC | 지움 | API 허용 목록에만 · 화면 · 시험 없음(확인 필요 풀림) | 없음 | 자료 0 |
+| 업체 분류 · 점진 TIN · 둘의 다듬기 판 | 남김 | 766 기본 흐름 · 다듬기 바탕 마스크 | — | — |
+| TIN + Taubin 평활 | 지움 | 드롭다운만 · 표본기 · 경로 찾기 · 등고선의 tin 갈래는 tin 고를 때만 | 등고선 · 표본기 · 경로 찾기 · 3D 모두 안 기댐(점진 TIN · 수치지형도 TIN 은 자기 삼각망) | 등고선 삼각망 굽기 코드 · 시험 둘 같이 빠짐 |
+| NURBS | 지움 | 같음 | 없음 | 설명서 장면 B04_03 이 NURBS 를 골라 확인창을 띄움 → 장면 고침 |
+| 점 서피스(meshfree) | 지움 | 같음 · B04 · B05 3D 의 PLY 읽기 갈래 | 없음 | PLY 읽기 · 쓰기 걷음 |
+| DTM | 남김 | 바탕 · 외곽 · implicit 굳힌 격자 축 · 브라우저 격자 · 경로 비용면 | — | — |
+| DTM 평활 | 남김 | B07 음영(implicit 확정에도 평활 DTM · 641-2 확인) · D03 음영 · 수치지형도 확정(평활 켬) · 표본기 smooth | — | 평활 대상 `dtm,tin` → `dtm` |
+| implicit | 남김 | 확정 표현 | — | — |
+| 수치지형도 라플라스 | 남김 | 자동 · LAS 없는 설계 · 가이드 설계 지형 | — | — |
+| 수치지형도 TIN(도엽선) · TIN 격자 · TPS · ANUDEM형 · 다중해상도 | 지움 | B04 단추 비교만 · 자료 0 | 라플라스가 쓰는 거리 비례 · 라플라스 다듬기는 남김 | B04 단추 여섯 → 하나 |
+| B07 옛 「계획평면도(라이다)」 짓기 · `lidar_source` · `LIDAR_ID` | 지움 | 0(다시 내보내기만) | `_sheet_box` · `_chunk_route` · `hillshade_png` 는 평면도 · D03 이 씀 → 남김 | — |
+| 도면 종류 이름 `plan_lidar`(Schema · TS) | 지움(작음) | 저장 도면 0 | 없음 | — |
+| B04 JSON 점군 GET · ground-stats GET + TS 함수 | 지움 | 화면 · 시험 0 | 이진 점군 길이 같은 표본 | — |
+| `SOURCE_FILTER_LABELS` · `MESH_GRID_SIZE` · `MESH_SMOOTHING_ITERATIONS` | 지움 | 0 | — | `.env` 의 MESH 두 줄은 남아도 무해 |
+| Contour implicit RBF 폴백 | 지움 | dtm 늘 먼저(754-1) → 탈 일 없음(확인 필요 풀림) | — | — |
+| 낡은 글 | 고침 | Ground · Pipeline 머리 「세 필터」 · WF1:69 「없으면 csf」 · B07 음영 기본 「csf」 · Router_Contour:101 폴백 「csf」 · B04 3D 보기 처음값 「csf」 · B05 Schema 설명 · B06 Prebuild:259 설명 · config 씨닝 설명 「CSF 천」 | — | — |
+
+## 2. 남은 자료
+
+| 프로젝트 | 무리 | csf 행(id) | 파일 | 크기 | 지금 확정 |
+|---|---|---|---|---|---|
+| 가이드_임도설계 | B | 2(918 · 919) | 13 | 157 MB | 수치지형도 라플라스 · 라이다 자리 = 업체 분류 implicit |
+| 검증_랩탑메인 · 검증_sub1~8 · 검증_데스크탑메인 · 검증_데스크탑서브 · 엄상준_검증 · 박동철_검증(13) | B | 2 씩 = 26 | 13 씩 | 157 MB 씩 | 업체 분류 · implicit |
+| 검증_sub1_D | D | 1(848 · `B04_PreProcess/lidar/…/dtm_csf.npz`) | 9 | 15.6 MB | 라이다 = 업체 분류(`lidar_meta`) |
+| 제안_점필터서피스 | B | 0 | 0 | — | 업체 분류 + 다듬기 |
+| E 11 개 · 다른 D · 지운 D | — | 0 | 0 | — | E 사본 = `dtm_classification` 1.4 MB |
+| 합 | 15 | 29(terrain_layers 29 같이 지워짐) | 191 | 2,213 MB | 확정 · las_selection · 노선 연결이 csf 를 가리킴 0 |
+
+- 파일 꼴(B 한 개) — models: `dtm_csf` · `_preview` · `_smooth` · `_smooth_preview` · `implicit_csf` · `_grid` · `_preview` · `contour_csf_*` 셋 / processed: `mask_csf.npy` 49 MB · `ground_points_csf` 5.9 MB · `preview_points_csf` 9 MB.
+- TIN · NURBS · 점 서피스 · 격자 최저 · PMF · RANSAC · 수치지형도 다섯 방식 — storage · DB 모두 0.
+- `processed_point_cloud.processing_params` 의 「csf」 글자 — 적기만 하고 읽는 곳 없음 · 그대로.
+
+지운 뒤 만나면:
+- B04 목록 — csf 행이 남아도 드롭다운에 없어 안 보임(오류 없음). 그 행을 API 로 [확정]하면 표본기가 「허용 목록 밖」 → 종횡단 · 추천 실패. 지금 확정 0 이라 일어날 일 없음.
+- `manifest.json` 의 csf 줄 — 설정 지문이 같으면 다시 전처리가 manifest 전부를 DB 로 옮겨 csf 행을 되살림 → 행과 함께 지워야 함.
+- LAS 나중 올리기의 `drop_stale_filters` 는 필터 등록부 기준 → csf 를 등록부에서 지우면 옛 csf 파일을 더는 안 지움.
+
+다시 전처리에 맡기면:
+- 같은 LAS 다시(keep_preprocess) = B04 폴더 · `surface_models` · `processed_point_cloud` 를 통째로 살림 → csf 그대로.
+- 이어 WF1(force 끔) — 766-2 가 설정에 `hole_fill` 을 더해(608 도 표현 값을 빼) 지문이 바뀜 → manifest 새로 → B 28 행은 WF1 저장 때 지워짐.
+- 남는 것 — 파일 2.2 GB(파이프라인은 파일을 안 지움) · sub1_D 행(나중 올리기 저장은 행을 안 지움) · 765-7 에서 빼는 프로젝트의 행.
+- 덤 — 766 뒤 자동 = 다듬기 판만 지음 → 맨 업체 분류 · 맨 점진 TIN 모델 파일도 manifest · DB 에서 빠져 고아(프로젝트당 약 137 MB · 14 개 약 1.9 GB). B04 에서 그 갈래를 고르면 어차피 다시 지음. 바탕 마스크 · 지면점 · 점 미리보기는 다듬기 입력 · 점군 보기라 남김.
+
+지움 도구(일회 · tmp) 규칙:
+1. 대상 = 프로젝트 `B04_PreProcess/{models,processed}` + D `B04_PreProcess/lidar/B04_PreProcess/{models,processed}`.
+2. 지울 이름 — 필터 `csf · grid_min_z · pmf · ransac` · 표현 `tin · nurbs · meshfree` · `sheet_{tin_sheet,tin,biharmonic,anudem,multires}` → 파일 지움 + manifest 줄 지움 + `surface_models` 행 DELETE(terrain_layers CASCADE).
+3. 확정 · `las_selection` · D `lidar_meta` 가 가리키면 그 프로젝트 건너뛰고 보고.
+4. 행 덤프(SELECT → json) 먼저 · 파일 백업 없음(쓰는 곳 0).
+5. 가이드 먼저(복제 원본) · 랩탑 한 곳에서만 · Synology 가 데스크탑 storage 로 옮김 · DB 하나라 바로 반영.
+
+## 3. 고칠 자리
+
+| 파일:줄 | 할 일 | 줄 |
+|---|---|---|
+| `B04_PreProcess_Engine_Filter_CSF.py` · `_Grid.py` · `_PMF.py` · `_RANSAC.py` | 파일 지움 | −379 |
+| `B04_PreProcess_Engine_Ground.py:3 · :19-23 · :33-36` | 넷 빼기 · 머리 글 | −8 |
+| `B04_PreProcess_Schema.py:14-19` · `:108` · `:141` | 허용 목록 = Ground 등록부(`available_filters()`)에서 받기 · JSON 점군 · ground-stats 응답 모델 지움 | −25 |
+| `common_util_surface_sampler.py:29-45` | Literal 에서 필터 넷 · sheet 다섯 빼기 · `SurfaceMethod` = dtm · implicit | −10 |
+| 〃 `:247-262 · :270 · :280-320` | `InterpolatedSurfaceSampler` · tin · nurbs · meshfree 갈래 | −50 |
+| `B05_Profile_Engine_Solver.py:97-140` | tin · nurbs · meshfree 갈래(dtm · 굳힌 격자만) | −30 |
+| `B04_PreProcess_Engine_ModelBuild.py:32-77 · :123-172 · :240-286 · :287` | build_tin · nurbs · meshfree · BUILDERS | −150 |
+| `B04_PreProcess_Engine_ModelContext.py:26-27 · :35-93 · :157-194` | `MODEL_METHODS`(안 씀) · `SOURCE_FILTER_LABELS` · NURBS 맞춤 · PLY 쓰기 | −100 |
+| `B04_PreProcess_Engine_Smooth.py:107-142 · :149` | smooth_tin | −38 |
+| `B04_PreProcess_Engine_Contour.py:142-368 · :418-514` | 삼각망 굽기 · 외곽 맞춤 · 축 · tin · nurbs · RBF 폴백 · meshfree 갈래(regular_grid · 굳힌 격자만 · 516 → 약 210 줄) | −300 |
+| `B04_PreProcess_Engine_Pipeline.py:3 · :90 · :144-150 · :163 · :169 · :199 · :248 · :302` | 표현 둘 · 평활 dtm 만 · 글 | −10 |
+| `B04_PreProcess_Engine.py:612 · :616` | meshfree 갈래 | −2 |
+| `B04_PreProcess_Router_Status.py:191-192` · `_Router_Contour.py:31-37 · :101-105` | ply · tin 빼기 · 폴백 「csf」 | −8 |
+| `B04_PreProcess_Router.py:359-402 · :501-529` | JSON 점군 · ground-stats | −75 |
+| `B04_PreProcess_Engine_SheetMethods.py:21 · :24-31 · :136-505 · :506-513` | 라플라스 · 거리 비례 · 다듬기만 남김 | −380 |
+| `config/config_system_terrain.py:12-13 · :16 · :31 · :33-44 · :52-64 · :91 · :109 · :112 · :128 · :130-133 · :140-141 · :149-153 · :174 · :213-229` | MESH · Grid · CSF · PMF · RANSAC 값 · 기본 목록 넷 · PRECOMPUTE `dtm,implicit` · 평활 `dtm` · TIN · NURBS · meshfree · Taubin 값 · 수치지형도 `laplace` · 설정 사전 | −50 |
+| `B03_FileInput_Service_WF1.py:69` · `B05_Profile_Schema.py:67-69` · `B06_Section_Server_Calc_Prebuild.py:259` | 글 | 0 |
+| `B07_DesignDetail_Engine_Cad_Lidar.py:44 · :106-220` | 옛 도면 짓기(`hillshade_png` 남김) | −115 |
+| `B07_DesignDetail_Router_Support_Basin.py:403 · :441-470 · :478` · `_Router_Support.py:72 · :82` | lidar_source · LIDAR_ID · 다시 내보내기 · 음영 기본 「csf」 → 빈 값 | −37 |
+| `B07_DesignDetail_Schema.py:21 · :67` · `B07_DesignDetail_Api_Fetch.ts:17 · :122` | `plan_lidar` 종류 이름 | −4 |
+| `B04_PreProcess_UI_Filter.ts:21-23` | `SOURCE_FILTERS` 에서 grid_min_z · csf · pmf | −3 |
+| `B04_PreProcess_UI_Page.ts:53 · :58` | `MODEL_METHODS` = dtm · implicit · `SHEET_METHOD_ORDER` = laplace | 0 |
+| `B04_PreProcess_UI_TerrainViewer.ts:4 · :78 · :351 · :376 · :394 · :413-415` | 처음값 csf · tin · meshfree · PLY | −8 |
+| `B04_PreProcess_Api_Fetch.ts:100 · :301-306` | ground-stats 형 · 함수 | −15 |
+| `B05_Profile_UI_Viewer.ts:6 · :456-458` · `_UI_Corridor_Split.ts:57` | PLY 갈래 · 글 | −5 |
+| 합 | | 약 −1,800 |
+
+허용 목록:
+- 필터 — Ground `_FILTERS`(정본) · Schema `_ALLOWED_FILTERS`(+ config `SURFACE_MODEL_SOURCE_FILTERS` 기본 목록) · sampler `SurfaceFilter`(Pydantic 형 · sheet_laplace 포함 · 손 목록 그대로) · UI `SOURCE_FILTERS`(지금 `B04_PreProcess_UI_Filter.ts`). Schema 를 Ground 등록부에서 받게 하면 한 벌 줄음.
+- 표현 — ModelBuild `BUILDERS` · ModelContext `MODEL_METHODS`(안 씀 · 지움) · sampler `SurfaceMethod` · Pipeline `_REPRESENTATIONS` · Router_Contour `MODEL_REPRESENTATIONS` · UI `MODEL_METHODS` · config `SURFACE_MODEL_PRECOMPUTE`.
+
+화면 — B04 [지면 필터] 일곱 → 넷 · [서피스] 다섯 → 둘 · 수치지형도 방식 단추 여섯 → 하나(줄 · 평활 · 라이다 겹쳐 보기 그대로).
+
+시험(29 개 + Node 도우미 1):
+- 지움 2 — `test_b04_contour_raster.py`(195) · `test_b04_contour_equivalence.py`(180 · 없는 프로젝트 f9543035 를 봐 이미 건너뜀).
+- 덜어냄 1 — `test_b04_ground_filters.py` CSF · Grid 경우 넷(약 40 줄) · 분류 · 자동 고름 남김.
+- 고침(허용 목록 · 형 검사에 걸림) 12 — `test_54_22_security`(:91 · :109) · `test_238_1` · `test_443_save_stops`(RouteConfirmRequest csf · tin) · `test_342_2_chain_once` · `test_346_3_route_save` · `test_b05_pipe_clearance_switch`(RouteSolveRequest csf) · `test_763_3_surface_change:131` · `test_763_1_confirmed_terrain:136-143`(깨진 tin → 깨진 implicit) · `test_343_2_persist_keys`(tin_sheet 견본 · csf → laplace · ptd) · `test_sheet_surface`(sheet_tin_sheet → sheet_laplace) · `test_637_lidar:198 · :265`(drop_stale_filters 가 csf 를 지운다는 기대).
+- 깨질 가능성 큼 1 — `test_133_1_analysis_terrain:27`(csf 로 표본기).
+- 이름만(지나도 통과 · 바꾸면 좋음) 14 — `test_273_2` · `test_342_2_confirm_fingerprint` · `test_343_1` · `test_343_3` · `test_344_1` · `test_351_1` · `test_442_2` · `test_624_1` · `test_754_1` · `test_b06_missing_stations` · `test_271_save_same` + `helper_271_save_same.cjs` · `test_511_b4_cross_save_mirror` · `test_b05_extra_stations_supplier`.
+
+정리 후보 1 · 2:
+- 1 높이 읽기 세 벌(표본기 · 경로 찾기 · 등고선) — 763-1 로 implicit 은 셋 다 굳힌 격자 · 남은 몸집은 tin · nurbs · meshfree 갈래 → 608 로 셋 다 같은 두 파일(dtm npz · 굳힌 격자)만 읽음 · 따로 합칠 몫 없음(RBF 폴백만 같이 걷음).
+- 2 등고선 → 격자 두 판(B04 SheetSurface + SheetMethods ↔ common_util terrain_surface + laplace) — 그대로 둘(+ 배수 전용 셋째) · SheetMethods 가 라플라스만 남아 513 → 약 130 줄 · 합치면 B 수치지형도 서피스 값이 바뀜(굽기 방향 흠 고친 판) · 가이드 설계 지형이 수치지형도 → 따로 권함.
+
+## 4. 위험
+
+| 자리 | 위험 | 막음 |
+|---|---|---|
+| 데스크탑 임시 배포(`main_desktop_1` b9a486f29 · 762 앞 · 같은 DB · Synology storage) | csf 행 · 파일 지움 = 영향 없음(확정 업체 분류만 읽음). 데스크탑 B04 드롭다운엔 CSF · TIN 등이 그대로 → 관리자가 누르면 같은 DB · storage 에 되살림 | 전역 깃 싱크까지 데스크탑 B04 갈래 비교 안 함 |
+| 〃 설정 지문 | 새 코드(766 hole_fill · 608 표현 값 뺌)와 옛 코드 지문 다름 → 한 프로젝트를 양쪽이 번갈아 전처리하면 그때마다 통째 다시 짓기 · 행 id 새로 | 데스크탑 쓰는 넷(데스크탑메인 · 데스크탑서브 · 엄상준 · 박동철)은 전역 깃 싱크 전 랩탑에서 다시 전처리 안 함 |
+| 〃 다듬기 이름(765-7 몫 · 같은 자리) | 옛 코드 허용 목록에 `classification_refine` · `ptd_refine` 없음 → 그 넷을 다듬기 판으로 확정하면 데스크탑 종횡단 · 추천이 「허용 목록 밖」 | 765-7 은 그 넷을 전역 깃 싱크 뒤로 |
+| 설정 지문 바뀜 | 다음 전처리 때 모든 프로젝트 DTM · implicit 통째 다시 짓기(수 분) · 지표면 행 id 새로(노선 연결 다시 이음) | 766 과 한 번에 · 765-7 전 |
+| sub8 766 진행 중 | 같은 파일 일곱(Engine · ModelBuild · ModelContext · Pipeline · Quality · UI_Filter · config) 고치는 중 | 766 합친 뒤 시작 |
+| 복제 도구 | B 복제 · 바꿔 넣기 = 원본 행 · 파일 그대로 → 761-3 에서 csf 가 13 개로 퍼진 길 | 지움 도구는 가이드 먼저 |
+| 시험 데이터 | fixtures 골든(`dtm_classification_smooth`) 영향 없음 | — |
+| 사용자 설명서(목록만) | `A05_EduDetail/guide/B04/02_지표면_분석.md:24-31`(필터 · 서피스 선택지와 GRID MIN Z · CSF · PMF 설명 — 이미 점진 TIN · 다듬기 없음) · `04_도엽등고_3D_서피스.md:15 · :28-30`(단추 여섯 · 흐린 단추 = 안 만든 방식) · `_scenes.json:133`(장면 B04_03 이 「NURBS」 고름 → 깨짐) · 그림 `B04_02_analysis_card` · `B04_03_build_confirm` · `B04_08_sheet_surface`(다시 찍기 대상) | 사용자 지시 때 한 번에 |
+
+함께 찾은 것:
+- B 14 개 모두 `implicit_ptd` 행 · 파일은 있고 `dtm_ptd` 없음(manifest ptd = implicit 만) → 이 조합을 확정하면 표본기 「기준 DTM 없음」 · 765-7 다시 전처리 때 사라질 자리.
+- 766 뒤 `drop_stale_filters` 가 다듬기 바탕(분류 · 점진 TIN) 마스크까지 「안 지은 필터」로 지움 → LAS 나중 올리기 뒤 바탕 마스크를 다시 셈(느려질 뿐) · 766 몫.
+
+## 5. 걸음 제안
+
+```
+## 767 안 쓰는 필터 · 서피스 지움 (요구 608 · _분석_608)
+- [ ] 767-1 코드 지움 — 필터 넷 · 표현 셋(+ TIN 평활 · 등고선 삼각망 · implicit RBF 폴백) · 수치지형도 비교 다섯 · 안 부르는 여섯 · 낡은 글 · Schema 허용 목록 = Ground 등록부 · 시험 지움 2 · 고침 13 · 이름 14 · 766 합친 뒤 · 765-7 전
+- [ ] 767-2 일회 지움 도구(tmp) — csf 파일 191 개 2.2 GB · manifest 줄 · surface_models 29 행(행 덤프 먼저 · 확정 · las_selection 가리키면 건너뜀 · 가이드 먼저 · 데스크탑 넷 포함)
+- [ ] 767-3 (고름 2-①) 765-7 뒤 맨 업체 분류 · 맨 점진 TIN 고아 모델 파일 같은 도구로(약 1.9 GB)
+```
+
+## 6. 고를 갈래
+
+1. CSF — ① 지움(권함 · 점진 TIN + 다듬기 · 업체 분류가 대신 · 남은 자료 2.2 GB 가 전부 CSF · 비교는 갈래 넷으로 충분) ② 관리자 비교용으로 CSF 만 남김(약 140 줄 덜 지움 · 자료 그대로).
+2. 남은 자료 — ① 일회 지움 도구(권함 · 파일 · 행 · manifest 한 번에 · 765-7 뒤 돌리면 고아 모델 1.9 GB 까지 한 번에) ② 765-7 에 맡김(B 28 행만 사라짐 · 파일 2.2 GB · D 1 행 · 데스크탑 넷 그대로).
+3. 수치지형도 비교 방식 다섯 — ① 지움(권함 · 자료 0 · 확정은 라플라스 · 약 380 줄) ② B04 단추 비교로 남김.
+4. 정리 후보 2(수치지형도 두 판 합침) — ① 이번엔 안 함(권함 · 가이드 설계 지형 값이 바뀜) ② 같이 함.