feat(nonlinear-static-newton-raphson): step 12 - execution-closure-and-evidence-docs

2026-08-28 21:08:58 +09:00
parent d275e844f2
commit bf9487efc2
6 changed files with 317 additions and 11 deletions
@@ -346,3 +346,30 @@ gate와 family RMS gate를 모두 유지해야 한다. Reference family 전체
 MITC4 verification report 및 comparator schema는 새 정책에 맞춰 다시 생성해야 하지만
 reference artifact, HDF5 schema, element formulation과 blocking/warning 분류는 변경하지
 않는다.
+
+### ADR-023: Nonlinear Static은 prepared dispatch와 accepted-frame evidence로 분리한다
+
+**결정**: CLI는 하나의 `.inp` operand만 받고 input lexical sibling
+`<stem>_results.h5`와 `<stem>_log.txt`를 유도한다. `--output`은 지원하지 않는다.
+`PrepareAnalysisInput()`이 syntax/semantic map을 한 번만 수행하고, prepared Domain의
+procedure identity가 linear static 또는 separate nonlinear full-Newton procedure를 선택한다.
+Nonlinear procedure는 trial/committed state, unsymmetric tangent solver와 iteration log를
+독립적으로 소유하며 log close 뒤에만 schema-v1 HDF5 writer가 accepted frames를 atomic publish한다.
+
+schema-v1 `/global/equilibrium`의 six values는 global origin `[0,0,0]`에서 current `X+u`
+force arm과 spatial physical nodal moments를 쓴 applied-plus-constrained-reaction balance
+error다. Accepted free generalized residual과 constrained-reaction resultant는 distinct
+projections이며 result dataset을 서로 대체하지 않는다. Nonlinear reference portfolio는 fine
+primary `shellNL-meshfine`, coarse companion `shellNL`, linear control `shell`을 분리한다.
+External U is blocking, UR is warning-only, local RF/RM is review-only, and RM3/stress is excluded;
+the factor-one internal global force/moment balance and accepted free residual remain blocking.
+
+**이유**: Input parse, linear lifecycle, nonlinear trial state와 writer finalization을 한
+procedure에 섞으면 output lifetime과 failure atomicity를 검증할 수 없다. Applied-plus-reaction
+balance, constrained reaction과 free residual을 구분하면 nonzero prescribed translation/rotation
+case에서도 force arm, mask와 rotation-coordinate conversion의 의미가 보존된다.
+
+**트레이드오프**: Nonlinear path는 linear procedure보다 state/backend/writer 수가 늘고 fine
+reference run 시간이 길다. 대신 HDF5 authoritative output, immutable CSV artifact와 external
+solver internal-algorithm non-equivalence 원칙을 유지하며 local support-force distribution을
+blocking tolerance로 위장하지 않는다.