add documents

2026-10-18 15:06:44 +09:00
parent 945d899b2f
commit 43867d0b3d
22 changed files with 913 additions and 10 deletions
@@ -0,0 +1,63 @@
+# 구현과 검증 상태
+
+## 기준 시점
+
+2026-10-18 저장소 HEAD `945d899` 기준이다. 아래 통과 수치는 각 검증 당시 기록의 범위이며
+후속 source에서 새로 실행한 결과로 승계하지 않는다.
+현재 용도는 개인 연구용 로컬 실행이며 장기 목표는 외부 사용자 배포다. 배포 형태·지원 환경·
+dependency 재배포 조건은 확정되지 않았다.
+
+## 구현과 실제 근거
+
+| 영역 | 구현된 범위 | 확보된 검증과 한계 |
+| --- | --- | --- |
+| B33·MITC4 선형 정적 | 입력 → solve → 복구 → HDF5 | 2026-10-18 정식 정적 모델 실행·비교 범위에 포함. 일반 곡선 beam·광범위 distorted/curved shell 정확도를 뜻하지 않는다. |
+| MITC4 비선형 정적·압력 | Full Newton·trial/commit·정적 follower pressure | ShellNL 정식 기본 모델의 U blocking·UR warning·내부 평형 통과 기록. RF/RM은 review-only. Fine·추가 fine·pressure의 정식 자료가 없고 추가 fine 비교기 연결도 없다. |
+| Shell frequency | Lumped mass·실제 FEAST·null/finite 공간·전체 반환 pair 검증 | 2026-09-10 첫 구현의 417개 통과와 Value 10개 모드별 5% 기록. 최신 통합본의 frequency 수치 실행을 완료한 근거로 승계하지 않는다. |
+| Shell HHT | Nodal-lumped-kinetic·reduced-coordinate·fixed-null·schema2 | 과거 C09와 C08a 7-grid, baseline 원본 U 비교 기록. 최신 전체 회귀·C08b finer-grid·최신 원본 비교·전체 물리 판정은 미완료. 중단을 수치 실패나 통과로 세지 않는다. |
+| Hex8 | Mean-volume 강성·reference row-sum mass·정적/고유치/HHT·high+low | 2026-10-13 관련 C++ 91개·Python 96개와 보존 결과 5개 비교 기록. 2026-10-18에는 정적 2개를 재실행. 최신 고유치·동적 전체 검증은 별도다. |
+| DS4 thermal | 5 온도점·consistent capacity·BE·flux/reaction·원자적 출력 | 당시 추가 139개 검사 기록. 기존 NT11은 diagnostic 불일치이며 새 필수 외부 reference 검증은 미완료. 최신 통합본의 전체 열 수치 실행도 미완료다. |
+| 공통 구조·빌드 | Typed procedure/capability/outcome·private backend·Native/CMake | 2026-10-18 두 경로 전체 target build·공개 header 111개 독립 compile·runtime DLL 7개 대조 기록. 물리 기능 전체 검증과 구분한다. |
+| 성능 | MKL 행렬 연산·제한된 불변 cache·Hex8 SIMD·shell 산술 최적화 | 세 모델의 목표 달성은 미완료. 단일 개발 표본과 복원된 후보의 통과를 최종 성능으로 승계하지 않는다. |
+
+2026-10-18 통합 기록은 두 빌드 경로에서 unit 849·integration 72·reference 43, 총 964개
+등록 identity가 일치한다고 보고한다. 사용자 지시로 정적·공통 631개(unit 555·integration 35·
+reference 41)만 직접 실행과 CTest에서 검증했으며 failure/error/skip은 0이었다.
+Python 합성·정책 145개도 통과했다. 보존된 비정적 333개는 당시 미검증이다.
+
+정식 정적 5모델은 beam·shell·shellNL·Hex8 linear/nonlinear static이다.
+Fresh Refactor·통합 Native·통합 CMake 실행물에서 같은 scratch 입력과 경로로 15회 실행했고
+등록 비교·보고서 검증·schema/identity/field parity를 포함한 50단계가 exit 0이었다.
+이는 선택된 정적 근거이며 source 전체의 수치 동등성이나 전체 green 선언이 아니다.
+근거 보관 위치는 `.build/merge-verification/refactor-integration-final-20261018-01/`다.
+해당 보관물이 없는 checkout에서는 실행물을 확보한 것으로 간주하지 않는다.
+
+## 남은 작업과 의존 순서
+
+사용자가 확인한 후속 범위는 남은 동해석·고유치·열해석 검증, 성능 개선과 미해결 이슈 처리다.
+이 목록은 특정 기능의 자동 실행 지시나 장시간 작업·외부 solver 실행 승인으로 해석하지 않는다.
+
+1. 정식 fine·추가 fine·pressure·새 thermal 기준자료의 제공 여부와 source/frame/hash 계약을
+   확정한다. 추가 fine는 자료뿐 아니라 전용 case identity와 comparator 연결이 필요하다.
+2. 현재 source·compiler·build tree를 묶어 비정적 수치 검증을 수행한다. Shell HHT 시간수렴·
+   원본 비교, solid dynamics, frequency, transient thermal을 선택된 정적 근거와 구분한다.
+   자료가 필요한 외부 비교는 정식 자료 확보 뒤 수행한다.
+3. Eigen partial-BC 정적 평형 충돌과 thermal 외부 불일치의 영향을 각각 판정한다.
+   기준 완화·질량 변경·원본 보정으로 해결하지 않는다.
+4. 같은 물리·허용치·출력·정밀도를 보존한 상태에서 성능 회귀 원인을 조사하고 최종 source의
+   Release 시간과 수치 결과를 다시 측정한다. 검증되지 않은 가속을 완료로 기록하지 않는다.
+
+위 순서는 자료·물리 판정·측정의 의존 관계다. 동해석·고유치·열해석 사이의 상세 우선순위와
+새 기능 추가 순서는 사용자가 별도로 정하지 않았다.
+
+## 성능 목표
+
+| 모델 | 목표 초 | 과거 단일 baseline 초 |
+| --- | ---: | ---: |
+| hexa_nonlinearstatic | 2 | 10.914924 |
+| hexa_dynnonlinear | 100 | 402.069447 |
+| shellNL-dyn-meshfine | 100 | 6372.325621 |
+
+Hex8 동적 개발 표본 117.7986225초는 native 0과 U 비교 통과였으나 100초 목표를 넘었다.
+Refactor 당시 ShellNL elapsed 회귀 Native +86.52%·CMake +120.91%는 과거 단일 기록이며
+원인·변산이 미확정이다. 최종 통합 source의 새 Release 성능 측정은 미완료다.