docs: organize project guidance and module contracts

This commit is contained in:
KOKO\Mimi
2026-09-29 00:34:57 +09:00
parent 73db138566
commit a3502c9b97
50 changed files with 1748 additions and 414 deletions
+16
View File
@@ -0,0 +1,16 @@
# Procedure와 상태 수명
Analysis는 준비된 Domain을 procedure별로 실행하고 equation·backend·trial·commit·recovery를
조정한다. Concrete HDF5 layout이나 vendor handle을 공개 state에 저장하지 않는다.
- AnalysisModel은 Domain의 non-owning view다. State에는 해당 procedure가 실제 사용하는
mutable 해와 recovery만 둔다. 새 procedure를 static lifecycle의 조건문으로 누적하지 않는다.
- Linear static은 Kff factorization 뒤 load assembly, effective RHS, full 해와 residual 복구를
수행한다. Empty free를 singular로 오인하지 않는다.
- Nonlinear/HHT는 trial을 committed state/history와 분리한다. 수렴·finite·recovery 검증을
모두 마친 candidate만 반영하고 실패한 trial의 일부 값이 history에 남지 않게 한다.
- HHT physical a, auxiliary A, 공간 angular acceleration을 구분하고 consistent kinetic
mass·analytic null·부분구속 의미를 유지한다. 시간수렴 실패를 기준 완화로 숨기지 않는다.
- Frequency reduction은 null/finite 공간과 공개 mode 수·내부 검증 수를 구분한다.
- 초기화, nonzero BC, all-constrained, 증분·반복 종료 경계, 실패 보존, temporal convergence,
반복 결정론과 backend failure를 검증한다. 한 reference의 U 일치로 모든 physics를 통과시키지 않는다.