modify documents

docs/contracts.md

@@ -51,14 +51,14 @@ contact·MPC·비탄성·혼합 beam/shell model은 현재 공개 subset이 아
 | 입력 | 소비자가 지켜야 할 의미 |
 | --- | --- |
 | `*NODE` | Part 안의 `label,x,y,z`; label은 양의 정수, 좌표는 finite |
-| `*ELEMENT, TYPE=B33|S4|S4R, ELSET=...` | B33은 2개, shell은 서로 다른 4개 node label; source type과 내부 정식화 구별 |
+| `*ELEMENT, TYPE=..., ELSET=...` | 구조 B33은 2개, S4/S4R은 4개 node label; 열전달 DS4는 4개. Source type과 내부 정식화 구별 |
 | `*NSET`·`*ELSET` | 허용 scope의 label 나열 또는 `GENERATE`; assembly set은 명시 instance에 결속 |
 | `*INSTANCE, NAME=..., PART=...` | 기존 part의 identity instance; transform data 미지원 |
 | `*ELASTIC` | 상수 등방 `E,nu`; `E>0`, `-1<nu<0.5`, finite |
 | `*SHELL SECTION, ELSET=..., MATERIAL=...` | 양의 finite thickness와 optional 양의 integration-point 정수; centered homogeneous section |
 | `*BEAM GENERAL SECTION, ELSET=..., MATERIAL=..., SECTION=GENERAL` | 첫 row `A,I11,I12,I22,J`, 둘째 row `n1x,n1y,n1z`; 현재 `I12=0`만 허용, 탄성은 연결 material에서 읽음 |
 | `*SECTION POINTS` | 바로 앞 beam section의 `x1,x2` row 목록; 입력 순서의 stress recovery 위치, duplicate/nonfinite 거부 |
-| `*BOUNDARY` | `target,first,last[,value]`, DOF 1~6; 생략 value는 0. Procedure별 추가 제한 적용 |
+| `*BOUNDARY` | `target,first,last[,value]`; 구조 DOF 1~6, 열전달의 공개 지정온도는 DOF 11/15. 생략 value는 0. Procedure별 추가 제한 적용 |
 | `*CLOAD` | `target,dof,magnitude`; 같은 resolved node/DOF는 source 순서로 합산. Procedure별 허용 DOF 적용 |
 
 중복 label, 해소되지 않은 target, 모호한 set, 잘못된 section/material 조합과 nonfinite
@@ -74,7 +74,7 @@ contact·MPC·비탄성·혼합 beam/shell model은 현재 공개 subset이 아
 | 비선형 정적 | MITC4 shell, `NLGEOM=YES`, full Newton. Static control data에 따른 accepted increment 이력, 유한회전과 해당 하중 의미 |
 | 선형 frequency | MITC4 shell, 원형상 무응력, `NLGEOM=NO`, homogeneous BC, 활성 material의 양의 density. 요청 mode N개와 내부 검증 결과 |
 | HHT dynamic | MITC4 shell, `NLGEOM=YES`, `*DYNAMIC, DIRECT`, 양의 density, 고정 h/T. 초기 frame 포함 전체 이력. 현재 시간수렴 미해결로 기능 검증 완료 상태는 아님 |
-| 열전달 | 계획 단계. DS4·열 입력·온도/flux dataset을 현재 공개 지원으로 소비하면 안 됨 |
+| 열전달 | 단일 uncoupled DS4, Q4×two-P2·5개 온도점, consistent C·Backward Euler. 구현·내부 검증 완료, 새 필수 reference 비교 대기 |
 
 정적 `*STATIC`은 parameter 없이 `initial_increment,time_period,minimum_increment,maximum_increment`
 한 row를 받으며 값은 finite positive여야 한다. Source increment 값이 물리 시간을 의미하는 것은 아니다. Linear와
@@ -103,6 +103,14 @@ STEP의 INC 기본값은 100이다. 계수는 `alpha=-0.05,beta=0.275625,gamma=0
 global force만 지원한다. 초기 q/v는 0이고 전체 STEP 하중이 `0+`부터 적용된다.
 비영 초기조건, damping, amplitude, follower/distributed load와 공개 계수 변경은 현재 미지원이다.
 
+열전달의 상수 `*CONDUCTIVITY`·`*DENSITY`·`*SPECIFIC HEAT`, 초기온도·일정한 지정온도·
+절점 열률, 마지막 실제 delta 및 thermal HDF5는
+[STH 입력·결과 계약](shell-transient-heat-transfer/PRD.md)을 따른다. 구조의 물성·DOF·
+displacement schema를 thermal에 적용하지 않는다. NT11/13/15는 bottom/mid/top이고
+내부 station 지정 BC·edge 열입력·열-구조 연성은 현재 공개 subset이 아니다.
+최초 raw 온도 frame에는 flux/반력 dataset이 없으며 완료 frame에서 각각 24개 trace와
+constrained full residual을 저장한다. Flux와 반력 열률은 같은 observable이 아니다.
+
 출력 요청의 no-op 허용은 procedure마다 다르다. 특히 HHT는 data 없는 PREPRINT의 네
 NO flag, RESTART WRITE/FREQUENCY=0, OUTPUT FIELD 또는 HISTORY/VARIABLE=PRESELECT/
 FREQUENCY=1 조합만 허용하며 OUTPUT의 FREQUENCY 생략은 1이다. Child NODE/ELEMENT
@@ -121,8 +129,9 @@ Reader는 metadata의 feature identity와 version, 해당 형식에 정의된 pr
 | 비선형 정적 | schema 1, `feature_id=nonlinear-static-newton-raphson`, `analysis_procedure=nonlinear-static-full-newton`, `/steps/Step-1/accepted_frames`와 `/steps/Step-1/frames/<n>/` |
 | Frequency | schema 0에 `feature_id=mitc4-shell-feast-eigen2`, `analysis_procedure=linear-frequency`, `eigen_schema_version=1` 추가 |
 | HHT | `feature_id=hht-implicit-dynamics`, `analysis_procedure=hht-implicit-dynamics`, schema 1, 전체 accepted frame과 `/steps/Step-1/frames/<n>/` |
+| Shell 열전달 | 식별·thermal model·frame·temperature/flux/reaction의 별도 계약은 [Feature PRD](shell-transient-heat-transfer/PRD.md)의 HDF5 정의를 따른다 |
 
-`Step-1`은 storage slot이다. Frequency는 `/steps/Step-1`의 `source_step_name`, HHT는
+`Step-1`은 storage slot이다. Frequency는 `/steps/Step-1`의 `source_step_name`, HHT와 열전달은
 `/metadata`의 `source_step_name`에서 원래 이름을 읽는다. 기존 선형·비선형 static은
 canonical `step_name=Step-1`만 저장하므로 원래 source 이름이 HDF5에 별도로 있다고
 가정하지 않는다. Float64와 fixed-width integer는 little-endian,
@@ -130,7 +139,7 @@ canonical `step_name=Step-1`만 저장하므로 원래 source 이름이 HDF5에
 Source 입력 identity는 실제 읽은 byte의 identity를 포함한다.
 
 `/model/nodes`와 `/model/elements`의 source instance/label과 internal ID를 사용해
-결과 row를 연결한다. Internal row 번호를 원본 label로 취급하지 않는다. Nodal
+결과 row를 연결한다. Internal row 번호를 원본 label로 취급하지 않는다. 구조해석의 nodal
 displacement와 constraint mask의 6성분 순서는 `[UX,UY,UZ,URX,URY,URZ]`다. Reaction,
 가속도 등 다른 dataset에는 각각의 component 이름이 있으므로 이 이름을 재사용하지 않고
 단위·좌표·location·component attribute를 함께 읽는다. `/model/nodal_constraint_mask`의
@@ -154,6 +163,11 @@ Nodal `acceleration`과 `algorithmic_acceleration`, `angular_acceleration`,
 `generalized_reaction`과 공간 `reaction`은 구별된 dataset이다. Accepted frame과 source
 identity로 접근하고 failed trial이나 time 기반 nearest-neighbor matching을 사용하지 않는다.
 
+열전달은 구조해석의 6성분 dataset을 재사용하지 않는다. 5개 section point 온도와
+thermal constraint mask, heat flux의 좌표·위치, reaction heat rate의 부호·초기 frame 규칙은
+[열전달 결과 계약](shell-transient-heat-transfer/PRD.md)을 따른다. Flux 적분과 full-residual
+reaction을 같은 복구량으로 해석하지 않는다.
+
 ## 외부 비교
 
 Comparison은 필요한 instance·entity·location·component·step/frame을 일대일 대응한다.