docs: simplify MITC4 verification and drilling scope
This commit is contained in:
@@ -6,12 +6,11 @@
|
||||
- title: `Linear Static MITC4 Shell`
|
||||
- status: `approved`
|
||||
- owner_agent: `requirement-agent`
|
||||
- date: `2026-08-11`
|
||||
- date: `2026-08-12`
|
||||
- approval_basis: 사용자와 확정한 선형 정적 범위, `S4`/`S4R` 매핑, 6자유도 외부 계약, drilling 안정화, 자동 director 생성, 결과 및 검증 계약
|
||||
- current_product_state: `requirements-approved-not-implemented`
|
||||
- formulation_alignment: `docs/formulations/mitc4-shell-formulation.md`는 선행 draft이며 이 baseline의 6자유도 및 drilling 계약에 맞춘 후속 개정이 필요함
|
||||
- declared_reference_candidate: 사용자가 `reference/shell/`에 Abaqus `S4R` 모델을 추가했다고 `2026-08-11`에 선언함
|
||||
- reference_inventory_state: 요구조건 작성 시점의 workspace에서는 `reference/shell/`이 관찰되지 않아 exact artifact inventory는 `needs-reference-artifacts`로 유지함
|
||||
- formulation_alignment: `docs/formulations/mitc4-shell-formulation.md`는 이 baseline의 6자유도 및 고정 drilling 안정화 계약과 정렬함
|
||||
- reference_inventory_state: `reference/shell/`의 S4와 `reference/shellR/`의 S4R input/displacement CSV를 기존 경로와 이름 그대로 사용함
|
||||
|
||||
## Purpose
|
||||
|
||||
@@ -51,7 +50,7 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- Abaqus source element type `S4`와 `S4R`의 동일한 FESA MITC4 매핑
|
||||
- 절점당 전역 자유도 `[UX, UY, UZ, URX, URY, URZ]`
|
||||
- 3개 병진과 director 접평면 회전 2개로 구성된 물리 MITC4 kernel
|
||||
- 비물리 local drilling 회전 1개에 대한 작은 scale-aware 수치 안정화
|
||||
- 비물리 local drilling 회전 1개에 대한 고정 수치 안정화
|
||||
- 막, 굽힘, 횡전단 및 이들의 coupling
|
||||
- 단일층, 균질 등방성 선형 탄성
|
||||
- element set별 일정한 양의 두께와 하나의 material을 갖는 `*SHELL SECTION`
|
||||
@@ -60,7 +59,7 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- DOF 1~6의 nodal `*BOUNDARY`와 nodal `*CLOAD`
|
||||
- deterministic assembly와 기존 linear-static partition/factorization/substitution lifecycle
|
||||
- HDF5 nodal displacement/reaction, shell generalized strain/resultant, in-plane stress, residual 및 energy output
|
||||
- element invariant, patch, locking, distortion, curved-shell, reference 및 physics verification
|
||||
- element invariant, patch, 현재 S4/S4R displacement reference 및 physics verification
|
||||
|
||||
## Out Of Scope
|
||||
|
||||
@@ -115,9 +114,9 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- **FESA-REQ-LSMITC4-011** — The initial nodal director shall be a dimensionless unit vector in the positive thickness direction; scalar thickness shall remain a separate property and shall not be encoded in the director magnitude.
|
||||
- **FESA-REQ-LSMITC4-012** — The positive element normal candidate shall be derived deterministically from the source node order and midsurface covariant tangent cross product.
|
||||
- **FESA-REQ-LSMITC4-013** — At a smooth shared node, consistently oriented incident element normal candidates shall be combined by deterministic area-weighted averaging and normalized to form the common nodal director.
|
||||
- **FESA-REQ-LSMITC4-014** — Zero/near-zero normal candidates, a zero/near-zero averaged director, opposing incident orientations, and a fold sharper than the approved smooth-patch criterion shall fail model validation.
|
||||
- **FESA-REQ-LSMITC4-014** — Nonfinite or zero normal candidates, a nonfinite or zero averaged director, and opposing incident orientations shall fail model validation; this feature does not introduce a calibrated smooth-patch angle.
|
||||
- **FESA-REQ-LSMITC4-015** — A physical fold or hinge shall be represented with duplicated source nodes so each smooth shell patch owns a separate director; the solver shall not silently average a discontinuous director field.
|
||||
- **FESA-REQ-LSMITC4-016** — Element geometry validation shall reject duplicate nodes, self-intersection, nonfinite coordinates, degenerate area, and nonpositive or near-singular Jacobians at every formulation-required Gauss and tying location.
|
||||
- **FESA-REQ-LSMITC4-016** — Element geometry validation shall reject duplicate nodes, self-intersection, nonfinite coordinates, zero area, and nonpositive or nonfinite Jacobians at every formulation-required Gauss and tying location; this feature does not introduce calibrated distortion or warp thresholds.
|
||||
- **FESA-REQ-LSMITC4-017** — The solver shall support nodal `*BOUNDARY` targets resolved by source node label or node set for global DOFs 1 through 6, including existing zero and nonzero prescribed-displacement semantics.
|
||||
- **FESA-REQ-LSMITC4-018** — The solver shall support nodal `*CLOAD` forces on DOFs 1 through 3 and nodal moments on DOFs 4 through 6 after deterministic aggregation in global coordinates.
|
||||
- **FESA-REQ-LSMITC4-019** — The aggregated nodal moment component parallel to the approved nodal director shall be rejected as `unsupported-drilling-load`; a drilling-direction moment shall not be carried only by numerical stabilization.
|
||||
@@ -140,10 +139,10 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
|
||||
- **FESA-REQ-LSMITC4-031** — The physical MITC4 kernel shall use three translations and two director-tangent rotations per node and shall not treat the drilling rotation as a physical strain variable.
|
||||
- **FESA-REQ-LSMITC4-032** — The six-DOF element embedding shall transform global nodal rotations into two director-tangent components and one director-parallel drilling component using deterministic right-handed orthonormal frames.
|
||||
- **FESA-REQ-LSMITC4-033** — The drilling contribution shall be symmetric, positive, scale-aware, sufficiently small to remain numerical, and sufficient to remove the nonphysical drilling null modes of otherwise valid models.
|
||||
- **FESA-REQ-LSMITC4-034** — The drilling scale shall be derived from dimensionally compatible physical rotational stiffness; the implementation shall not apply `10^-3 * min(all Kii)` across mixed translational and rotational diagonal entries without an approved dimensional derivation.
|
||||
- **FESA-REQ-LSMITC4-035** — Drilling stabilization shall not contribute to physical membrane, bending or transverse-shear generalized strain/resultant or section-point stress; its energy shall be recovered separately.
|
||||
- **FESA-REQ-LSMITC4-036** — Exact drilling reference scale, dimensionless coefficient and acceptable artificial-energy ratio shall be approved through Research and Numerical Review before Implementation Planning; no implementation-selected default may close this decision silently.
|
||||
- **FESA-REQ-LSMITC4-033** — The drilling contribution shall be a symmetric positive numerical stabilization of the four director-parallel coordinates and shall not define a physical drilling strain or load channel.
|
||||
- **FESA-REQ-LSMITC4-034** — Let `R+` be the finite strictly positive diagonal entries of the physical local stiffness belonging only to the eight director-tangent rotational DOFs. The element shall use `k_ref=min(R+)`, `k_d=10^-3*k_ref`, `K_drill_local=k_d I4`, and the documented drilling transformation `T_d`; translational diagonals shall never enter `R+`.
|
||||
- **FESA-REQ-LSMITC4-035** — Drilling stabilization shall not contribute to physical membrane, bending or transverse-shear generalized strain/resultant, section-point stress, or separately reported result quantities.
|
||||
- **FESA-REQ-LSMITC4-036** — An otherwise accepted element with no finite strictly positive entry in `R+` shall fail numerical validation deterministically; coefficient sweeps, plateau selection, conditioning calibration, artificial-energy ratios, and drilling-specific result datasets are outside this feature.
|
||||
- **FESA-REQ-LSMITC4-037** — Source `S4R` shall not select reduced integration or Abaqus hourglass control; all accepted `S4` and `S4R` inputs shall use the single quadrature and MITC tying contract approved by the FESA formulation.
|
||||
- **FESA-REQ-LSMITC4-038** — The stabilized element shall retain exactly six physical rigid-body modes within the approved normalized tolerance, preserve stiffness symmetry and coordinate-transformation energy, and have positive energy for every accepted non-rigid physical deformation mode.
|
||||
|
||||
@@ -156,7 +155,7 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- **FESA-REQ-LSMITC4-043** — The same shell locations shall output local section resultant components `[N11,N22,N12,M11,M22,M12,Q13,Q23]`, where `N` and `Q` have dimension `force/length` and `M` has dimension `force` as moment resultant per unit edge length.
|
||||
- **FESA-REQ-LSMITC4-044** — Each required shell location shall output local in-plane stress `[S11,S22,S12]` at bottom, middle and top section positions with dimension `force/length^2`; `S33` shall be documented as the plane-stress assumption and `S13/S23` point stress shall not be emitted.
|
||||
- **FESA-REQ-LSMITC4-045** — Result rows shall identify source element, integration/tying or recovery location, natural coordinates, section position, local frame/director and component order without averaging mismatched locations.
|
||||
- **FESA-REQ-LSMITC4-046** — The output shall include free-DOF residual evidence, total force/moment equilibrium metrics, physical strain energy and drilling stabilization energy with dimension `force*length` and deterministic aggregation order.
|
||||
- **FESA-REQ-LSMITC4-046** — The output shall include free-DOF residual evidence, total force/moment equilibrium metrics and physical shell strain energy with dimension `force*length` and deterministic aggregation order; no drilling-specific stiffness, ratio or energy dataset is required.
|
||||
- **FESA-REQ-LSMITC4-047** — Abaqus output requests shall neither suppress nor expand the mandatory HDF5 quantity inventory; any deterministic FESA CSV projection shall remain a debugging/review view rather than official solver output.
|
||||
- **FESA-REQ-LSMITC4-048** — Nonfinite recovery values, inconsistent component/location inventory or failure to finalize required HDF5 rows shall fail the analysis without committing a partial successful state.
|
||||
|
||||
@@ -166,10 +165,10 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- **FESA-REQ-LSMITC4-050** — Element invariant tests shall cover frame orthonormality/handedness, Jacobian sign, stiffness symmetry, coordinate-transformation energy invariance, six physical rigid modes, deformation-mode positivity and deterministic repeatability.
|
||||
- **FESA-REQ-LSMITC4-051** — Normalized algebraic acceptance shall use `1e-12` for symmetry, frame orthonormality and transformation-energy invariance and `1e-10` for rigid-mode action, linear-system residual and global equilibrium unless Numerical Review approves and documents an evidence-backed scale-aware replacement before Implementation Planning.
|
||||
- **FESA-REQ-LSMITC4-052** — Patch verification shall independently cover constant membrane strain/stress, pure bending, transverse shear and twist, including sign and component-order checks for generalized strain, resultant and recovered in-plane stress.
|
||||
- **FESA-REQ-LSMITC4-053** — Locking/convergence verification shall include thin- and thick-shell or plate sequences over documented thickness ratios and mesh refinements and shall demonstrate the approved MITC4 transverse-shear behavior rather than judge one displacement on one mesh.
|
||||
- **FESA-REQ-LSMITC4-054** — Geometry verification shall include planar, smoothly curved, distorted and warped valid elements plus negative tests for degenerate, inverted, self-intersecting, opposing-normal and sharp-fold topologies.
|
||||
- **FESA-REQ-LSMITC4-055** — Curved-shell verification shall include at least one nodal-load-compatible pinched-cylinder, hemispherical-shell or equivalently justified benchmark; Scordelis-Lo may be included only with documented equivalent nodal loading inside the approved input subset.
|
||||
- **FESA-REQ-LSMITC4-056** — Drilling verification shall vary the approved stabilization coefficient around its nominal value, confirm stable equation rank, report physical displacement/resultant sensitivity and enforce the approved drilling-to-physical energy warning criterion.
|
||||
- **FESA-REQ-LSMITC4-053** — The implementation shall pass the formulation-defined element invariants and patch/manufactured tests plus the two declared S4/S4R displacement reference cases; an expanded locking, distortion or curved-shell benchmark portfolio is not an implementation-completion gate for this feature.
|
||||
- **FESA-REQ-LSMITC4-054** — Geometry validation tests shall cover the exact accepted/rejected conditions defined by the formulation and I/O contract; `NR-O03` smooth-director calibration and `NR-O04` distortion/warp threshold sweeps are not required tests.
|
||||
- **FESA-REQ-LSMITC4-055** — Additional pinched-cylinder, hemispherical-shell, Scordelis-Lo or mesh-convergence studies may be added later as nonblocking research or release evidence, but are not required for Implementation Planning or feature completion.
|
||||
- **FESA-REQ-LSMITC4-056** — Drilling verification shall check the fixed formula in Requirement 034, symmetry, positivity, deterministic assembly, removal of the four nonphysical local drilling null modes, and exclusion from physical recovery; coefficient sweeps and drilling-energy checks are not required.
|
||||
- **FESA-REQ-LSMITC4-057** — Physics verification shall check load/reaction balance, global moment balance, displacement direction, symmetry, energy positivity, result sign and consistency between assembled residual and recovered shell resultants.
|
||||
|
||||
## Verification Quantities
|
||||
@@ -180,31 +179,29 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
|
||||
- shell_section_resultant: required, local `N/M/Q` eight components at documented locations
|
||||
- stress: required, local bottom/middle/top `[S11,S22,S12]`; Abaqus equality comparison N/A
|
||||
- residual: required, free-DOF and normalized global equilibrium evidence
|
||||
- energy: required, separate physical strain and drilling stabilization energies
|
||||
- energy: required for the physical shell strain energy; drilling-specific energy output is not required
|
||||
- modes_and_invariants: required, six physical rigid modes, symmetry, transformation invariance and positive deformation energy
|
||||
|
||||
## Tolerance Policy
|
||||
|
||||
- **FESA-REQ-LSMITC4-058** — Abaqus reference pass/fail shall apply only to matched global `U1/U2/U3` rows using `tolerance_c = absolute_floor_c + relative_coefficient_c * reference_scale_c`.
|
||||
- **FESA-REQ-LSMITC4-058** — Abaqus reference pass/fail shall apply only to matched global `U1/U2/U3` rows using `tolerance_c = 1e-9 + 1e-6 * reference_scale_c`, exactly reusing the approved B33 displacement rule.
|
||||
- **FESA-REQ-LSMITC4-059** — `reference_scale_c` shall be computed only from finite Abaqus values in the same model, step/frame, quantity and component group; reference values shall not be zero-clamped and row-specific relative denominators shall not replace the group scale.
|
||||
- **FESA-REQ-LSMITC4-060** — MITC4 displacement absolute floors and relative coefficients shall not silently inherit the B33 numerical values; Reference Model shall propose dimensioned floors and coefficients from benchmark evidence and Numerical Review shall approve them before reference comparison implementation.
|
||||
- **FESA-REQ-LSMITC4-061** — Global `UR1/UR2/UR3` rows shall be compared and fully reported but shall not affect pass/fail; errors beyond the approved large-error threshold shall emit deterministic nonblocking warnings and remain visible in known limitations.
|
||||
- **FESA-REQ-LSMITC4-062** — The UR large-error threshold and drilling-energy warning ratio are `needs-downstream-decision` owned jointly by Reference Model and Numerical Review and shall be fixed before Implementation Planning.
|
||||
- **FESA-REQ-LSMITC4-060** — The `1e-9` absolute floor is expressed in the model's user-consistent length unit for U; no additional MITC4 tolerance calibration is required.
|
||||
- **FESA-REQ-LSMITC4-061** — Global `UR1/UR2/UR3` rows shall use the same component-scale formula as Requirement 058 and shall be fully reported; an exceedance emits a deterministic nonblocking warning and never changes pass/fail.
|
||||
- **FESA-REQ-LSMITC4-062** — The `1e-9` UR floor is dimensionless. No separate UR large-error or drilling-energy threshold is required.
|
||||
- **FESA-REQ-LSMITC4-063** — Missing, extra, duplicate, nonfinite, schema-mismatched or source-identity-mismatched rows shall fail artifact/schema validation before numeric tolerance evaluation for both U and UR inventories.
|
||||
- **FESA-REQ-LSMITC4-064** — The comparison report shall record each U/UR row decision, maximum absolute error, component-scale normalized error, RMS error, vector-norm error and worst source row/component; nonblocking UR warnings shall not be omitted from an otherwise passing report.
|
||||
|
||||
## Reference Artifact Requirements
|
||||
|
||||
The user-declared first candidate is `reference/shell/` and is said to contain an Abaqus
|
||||
`S4R` model. At requirements-authoring time that directory was not visible in the shared
|
||||
workspace, so no exact filename, schema, units, generator, step/frame or row inventory is
|
||||
asserted here. The bundle shall remain read-only when it becomes observable.
|
||||
The approved lightweight inventory uses the existing S4 and S4R paths below. These files
|
||||
remain read-only; their names are identities, not canonical/legacy-policy decisions.
|
||||
|
||||
- **FESA-REQ-LSMITC4-065** — Reference Model shall inventory `reference/shell/` without creating, renaming, rewriting or repairing files and shall classify a missing/unobservable candidate as `needs-reference-artifacts` rather than fabricate its content.
|
||||
- **FESA-REQ-LSMITC4-066** — A usable new reference bundle shall contain `model.inp` and `<model-id>_displacements.csv`, or shall receive an explicitly approved legacy-alias contract that records its exact existing filenames without rename; `metadata.json` is optional and its absence shall not make the bundle unusable.
|
||||
- **FESA-REQ-LSMITC4-067** — The approved Reference Model Contract shall record Abaqus generator/version, creation provenance, source element type, model/step/frame identity, user unit system, global coordinate convention, section/material/thickness data, CSV schema and tolerance policy; if `metadata.json` exists, it shall be inventoried read-only and checked against that contract and the stored artifacts.
|
||||
- **FESA-REQ-LSMITC4-068** — Artifact validation shall confirm an approved single `*STEP, *STATIC` model, expected `S4` or `S4R` source type, supported keyword subset, unique finite displacement rows and exact source-node/component identity before comparison.
|
||||
- **FESA-REQ-LSMITC4-069** — End-to-end mapping evidence shall cover at least one `S4` input and at least one `S4R` input; the declared `reference/shell/` S4R model may satisfy only the S4R side after inventory validation, so separate S4 evidence remains required.
|
||||
- **FESA-REQ-LSMITC4-065** — The S4 case shall use `reference/shell/shell.inp` and `reference/shell/shell displacements.csv` without creating, renaming, rewriting or repairing either file.
|
||||
- **FESA-REQ-LSMITC4-066** — The S4R case shall use `reference/shellR/shellR.inp` and `reference/shellR/shellR displacements.csv` without creating, renaming, rewriting or repairing either file.
|
||||
- **FESA-REQ-LSMITC4-067** — Reference readiness requires only the declared input and required displacement CSV, FESA `results.h5`, deterministic source-node/component mapping, and Requirements 058-063 tolerance/precheck rules. README, `metadata.json`, canonical naming, provenance, Abaqus version, duplicated model semantics, and a schema version are not required gates; a present `metadata.json` is optional read-only context.
|
||||
- **FESA-REQ-LSMITC4-068** — Artifact validation shall require unique finite displacement rows and deterministic source-node/component identity before comparison; it shall not attempt to establish Abaqus internal formulation equivalence.
|
||||
- **FESA-REQ-LSMITC4-069** — The two declared cases satisfy the required source-label coverage: `reference/shell/` covers S4 and `reference/shellR/` covers S4R. No expanded reference portfolio is required for this feature.
|
||||
- **FESA-REQ-LSMITC4-070** — Reference verification shall compare FESA HDF5 global nodal displacement rows directly against Abaqus displacement CSV rows by model, step/frame, source node and component identity; a FESA-generated CSV view shall not become the authoritative comparison source.
|
||||
- **FESA-REQ-LSMITC4-071** — Abaqus reaction, stress, strain and shell force/moment output may be retained as review evidence if present but shall not change the approved `U1/U2/U3` pass/fail boundary or become an undeclared equality gate.
|
||||
- **FESA-REQ-LSMITC4-072** — FESA agents shall not execute Abaqus or another reference solver and shall not generate, modify, restore or normalize reference artifacts during requirements, research, formulation, implementation or verification unless a later phase explicitly authorizes that operation.
|
||||
@@ -221,72 +218,61 @@ without gaps or overlap.
|
||||
| `002-004` | `S4`/`S4R` mapping and identity | input/model | User approval | must | Parser/semantic/HDF5 metadata tests | Both source types map to one MITC4 path and preserve distinct source metadata and four-node identity | Exact element/type identity | I/O Definition; Implementation Planning | approved |
|
||||
| `005` | Six global nodal DOFs | model | User approval; project DOF convention | must | DofManager and HDF5 schema tests | Exact component order and no distributed equation ownership | Exact ordering | Formulation; I/O Definition; Implementation Planning | approved |
|
||||
| `006-010` | Isotropic material and single-layer section | input/model | User approval | must | Parser, mapping and validation tests | Valid `E,nu,t` resolve once per element; excluded section/material meanings fail | Exact inequalities; finite values | Research; I/O Definition; Implementation Planning | approved |
|
||||
| `011-016` | Initial director and geometry validity | geometry | User approval; MITC director kinematics | must | Geometry/unit/property-based tests | Deterministic unit directors for smooth valid meshes; every invalid topology fails | Smooth-angle and scale-aware Jacobian thresholds: Research + Numerical Review | Research; Formulation; Numerical Review; I/O Definition | approved-with-downstream-decision |
|
||||
| `017-020` | Boundary and nodal-load subset | input/load | User approval | must | Parser/semantic/load tests | Global BC/CLOAD works; director-parallel moment and distributed loads fail | Drilling projection threshold: Numerical Review + I/O Definition | Formulation; I/O Definition; Implementation Planning | approved-with-downstream-decision |
|
||||
| `011-016` | Initial director and geometry validity | geometry | User approval; MITC director kinematics | must | Geometry/unit/property-based tests | Deterministic unit directors for supported valid meshes; explicitly invalid mappings fail | Exact formulation/I/O predicates; no `NR-O03`/`NR-O04` calibration gate | Formulation; I/O Definition; Implementation Planning | approved |
|
||||
| `017-020` | Boundary and nodal-load subset | input/load | User approval | must | Parser/semantic/load tests | Global BC/CLOAD works; director-parallel moment and distributed loads fail | Exact-zero/projection rule from Formulation and I/O | Formulation; I/O Definition; Implementation Planning | approved |
|
||||
| `021-023` | Parser subset, wrappers and no-op policy | input | User approval; ADR-003/013/018 | must | Parser diagnostic and semantic identity tests | Only approved meanings affect Domain; excluded meanings fail closed | Exact keyword/diagnostic inventory | I/O Definition; Implementation Planning | approved |
|
||||
| `024-030` | Ownership, deterministic assembly and linear-static execution | architecture/execution | PRD; ADR-004/007/008/009/016/017 | must | Unit, orchestration and repeated-thread-count tests | Ownership boundaries, event order, residual reaction and deterministic bytes/rows match | `1e-12` deterministic numeric target where applicable | Numerical Review; Implementation Planning | approved |
|
||||
| `031-038` | 5-DOF physics embedded in 6-DOF with drilling stabilization | numerical boundary | User approval; MITC literature and thesis 6-DOF discussion | must | Formulation review, element invariant, rank and energy tests | Physical outputs exclude drilling; stable system retains six physical rigid modes | Scale/coefficient/energy ratio: Research + Numerical Review | Research; Formulation; Numerical Review | approved-with-downstream-decision |
|
||||
| `031-038` | 5-DOF physics embedded in 6-DOF with fixed drilling stabilization | numerical boundary | User approval; MITC literature and thesis 6-DOF discussion | must | Formulation review, invariant and rank tests | Exact `10^-3` positive rotational-diagonal rule; physical outputs exclude drilling | Fixed by Requirements 033-036 | Formulation; Numerical Review; Implementation Planning | approved |
|
||||
| `039-048` | Mandatory HDF5 output and failure atomicity | output | User approval; ADR-005/016/018 | must | Recovery, schema, identity, nonfinite and atomicity tests | Every quantity/location/unit/identity exists; failure commits no partial success | Exact component/location inventory; I/O Definition owns schema | Formulation; I/O Definition; Implementation Planning | approved |
|
||||
| `049-057` | TDD, invariants, patch, locking, geometry, curved shell and physics | verification | User approval; shell benchmark evidence; project process | must | CTest evidence, analytical/patch/convergence reports and physics review | Every verification family has passing evidence before release | `1e-12` symmetry/frame; `1e-10` rigid/residual; convergence targets by Numerical Review | Research; Numerical Review; Reference Model; Implementation Planning | approved-with-downstream-decision |
|
||||
| `058-060` | Translational displacement pass/fail tolerance | tolerance | User approval | must | Comparator unit/integration tests and report review | Every matched U row uses the approved mixed tolerance without clamp/omission | Floors/coefficient: Reference Model + Numerical Review | Reference Model; Reference Verification | approved-with-downstream-decision |
|
||||
| `061-062` | Rotational warning and drilling-energy warning | tolerance/warning | User approval | must | Comparator/diagnostic tests and report review | UR never changes pass/fail; large error and energy ratio produce deterministic visible warnings | Thresholds: Reference Model + Numerical Review | Numerical Review; Reference Model; Reference Verification | approved-with-downstream-decision |
|
||||
| `049-057` | TDD, invariants, patch, declared references and physics | verification | User approval; shell formulation evidence; project process | must | CTest evidence, analytical/patch tests, two reference cases and physics review | Required tests pass; removed calibration/portfolio checks are not reintroduced | `1e-12` symmetry/frame; `1e-10` rigid/residual | Numerical Review; Implementation Planning | approved |
|
||||
| `058-060` | Translational displacement pass/fail tolerance | tolerance | User approval; B33 baseline | must | Comparator unit/integration tests and report review | Every matched U row uses `1e-9 + 1e-6*reference_scale_c` without clamp/omission | Fixed by Requirements 058-060 | Reference Verification | approved |
|
||||
| `061-062` | Rotational warning-only comparison | tolerance/warning | User approval; B33 baseline | must | Comparator/diagnostic tests and report review | UR never changes pass/fail; same mixed-tolerance exceedance emits a deterministic warning | Fixed by Requirements 061-062 | Reference Verification | approved |
|
||||
| `063-064` | Row/schema failure and report completeness | reference verification | User approval; ADR-005/014/018 | must | Negative comparator and report-schema tests | Invalid inventory fails before numeric comparison; all U/UR metrics remain visible | No ignored invalid rows | I/O Definition; Reference Verification | approved |
|
||||
| `065-068` | `reference/shell` inventory and artifact validity | reference | User declaration; project artifact policy | must | Read-only inventory and schema/provenance review | Candidate becomes usable only after exact files, S4R type, provenance and row schema are validated | Current state `needs-reference-artifacts` | Reference Model | needs-reference-artifacts |
|
||||
| `069-071` | S4/S4R coverage and displacement-only comparison | reference | User approval | must | Portfolio coverage and HDF5-to-CSV comparison | At least one model per source type; only U is blocking and UR is warning-only | Requirements `058-064` | Reference Model; Reference Verification; Physics Evaluation | approved-with-downstream-decision |
|
||||
| `065-068` | Exact S4/S4R reference-case inventory and row validity | reference | User declaration; ADR-019 | must | Read-only inventory and source-row/component precheck | Four declared paths exist; required rows are unique, finite and deterministically mapped | Requirements `058-063` | Reference Model; Reference Verification | approved |
|
||||
| `069-071` | S4/S4R coverage and displacement-only comparison | reference | User approval | must | HDF5-to-CSV comparison | Declared S4/S4R cases; only U blocks and UR only warns | Requirements `058-064` | Reference Verification; Physics Evaluation | approved |
|
||||
| `072` | Reference solver/artifact immutability | governance | User/project policy; ADR-010 | must | Process audit and Git diff | No unapproved execution or artifact mutation | Exact zero mutations | All downstream agents | approved |
|
||||
|
||||
## Open Questions and Required Downstream Decisions
|
||||
|
||||
No additional user scope decision is pending. The following technical values must remain visible
|
||||
and be approved by their named downstream owners before Implementation Planning:
|
||||
|
||||
1. Research and Numerical Review shall define a dimensionally consistent drilling reference stiffness, dimensionless coefficient range and nominal value.
|
||||
2. Numerical Review shall approve the maximum drilling-to-physical strain-energy warning ratio and the displacement/resultant sensitivity criterion for coefficient variation.
|
||||
3. Research and Numerical Review shall define the smooth-patch director angle criterion and scale-aware degenerate/Jacobian thresholds without an arbitrary `max(1, ...)` clamp.
|
||||
4. Reference Model and Numerical Review shall define MITC4 U component absolute floors and relative coefficients in the approved mixed-tolerance form.
|
||||
5. Reference Model and Numerical Review shall define the nonblocking UR large-error threshold and reporting severity.
|
||||
6. Formulation shall fix quadrature, tying-point interpolation, shear correction, local axes, sign conventions and recovery locations consistent with this baseline.
|
||||
7. `reference/shell/` shall be re-inventoried when visible. Until then its exact filenames, units, provenance and CSV schema are not established evidence.
|
||||
8. Separate `S4` end-to-end evidence remains required even if the declared `S4R` candidate is valid.
|
||||
9. The existing formulation draft's 5-DOF-only and no-drilling statements conflict with this approved baseline and shall be revised during the Formulation gate, not patched silently during implementation.
|
||||
No user or numerical calibration decision remains before Implementation Planning. Formulation
|
||||
shall retain exact quadrature, tying interpolation, local-axis, sign and recovery definitions.
|
||||
Future geometric-nonlinear execution remains separately unauthorized even though its residual
|
||||
and tangent derivation may remain in the formulation document.
|
||||
|
||||
## Downstream Handoff
|
||||
|
||||
### Research Agent
|
||||
|
||||
- Establish source-backed MITC4 linear kinematics, tying, quadrature, shear correction and benchmark applicability.
|
||||
- Research dimensionally consistent 6-DOF drilling stabilization alternatives and sensitivity/energy criteria; distinguish the thesis's printed `10^-3 min(Kii)` rule from a FESA-approved scale-aware rule.
|
||||
- Research nodal-director generation, smooth-patch angle handling and distorted/warped geometry limits.
|
||||
- Identify nodal-load-compatible flat, locking, distorted and curved-shell benchmark families.
|
||||
- Record the thesis drilling rule and the approved dimensional restriction to positive physical rotational diagonals; do not reopen coefficient calibration.
|
||||
- Preserve nodal-director and geometry evidence as implementation guidance without creating `NR-O03`/`NR-O04` calibration gates.
|
||||
|
||||
### Formulation Agent
|
||||
|
||||
- Revise `docs/formulations/mitc4-shell-formulation.md` to align with global 6-DOF input/output and a physical 5-DOF MITC4 kernel plus numerical drilling embedding.
|
||||
- Keep current-product equations strictly linear static; retain geometric-nonlinear residual/tangent only as clearly separated future formulation.
|
||||
- Define local frames, transformations, generalized component order, quadrature/tying, stress/resultant recovery, energy split and consistent units/signs.
|
||||
- Define local frames, transformations, generalized component order, quadrature/tying, stress/resultant recovery and consistent units/signs.
|
||||
- Do not introduce distributed-load product support or make `S4R` select reduced integration.
|
||||
|
||||
### Numerical Review Agent
|
||||
|
||||
- Independently review the revised formulation for rigid modes, rank, symmetry, invariance, locking, distortion, Jacobian/director validation and drilling contamination.
|
||||
- Approve every downstream numerical threshold listed above before Implementation Planning.
|
||||
- Require coefficient sensitivity and artificial-energy evidence rather than accepting a small coefficient by assertion.
|
||||
- Independently review the revised formulation for dimensions, rigid modes, rank, symmetry, invariance, Jacobian/director handling and separation of fixed drilling stabilization from physical recovery.
|
||||
- Treat drilling calibration/energy-ratio checks and `NR-O03`/`NR-O04` as removed scope, not missing evidence.
|
||||
|
||||
### I/O Definition Agent
|
||||
|
||||
- Define the exact Abaqus keyword/data subset for `S4`, `S4R`, single-layer `*SHELL SECTION`, material, BC and CLOAD semantics.
|
||||
- Define source identity, auto-director metadata, unsupported-drilling-load projection, diagnostics and exact HDF5 dataset/row schemas.
|
||||
- Define source identity, auto-director data, unsupported-drilling-load projection, diagnostics and exact HDF5 dataset/row schemas without drilling-specific result datasets.
|
||||
- Preserve source element type separately from FESA formulation and define bottom/middle/top stress location identity.
|
||||
|
||||
### Reference Model Agent
|
||||
|
||||
- Re-inventory the user-declared `reference/shell/` candidate read-only and report exact files, S4R identity, provenance, units, step/frame and CSV row schema or `needs-reference-artifacts`.
|
||||
- Do not rename or repair noncanonical files; propose an explicit legacy alias only if retaining them is justified.
|
||||
- Prepare coverage for both S4 and S4R, flat/thin/thick/distorted/curved response and the approved displacement-only blocking comparison.
|
||||
- Propose evidence-backed U tolerance coefficients/floors and UR warning thresholds for Numerical Review approval.
|
||||
- Record the exact existing S4 and S4R input/displacement CSV paths from Requirements 065-066 and keep them read-only.
|
||||
- Define only the HDF5-to-CSV source-node/component projection and the already approved B33 mixed tolerance; do not add bundle administration or portfolio gates.
|
||||
|
||||
### Implementation Planning Agent
|
||||
|
||||
- Do not start until Research, revised Formulation, Numerical Review, I/O and Reference Model contracts have resolved every named downstream decision.
|
||||
- Do not start until Research, revised Formulation, Numerical Review, I/O and lightweight Reference Model inventory are mutually consistent.
|
||||
- Trace every `must` requirement to RED/GREEN/VERIFY tests and preserve current solver ownership, deterministic assembly and failure-atomic HDF5 boundaries.
|
||||
- Include independent tests for source-type mapping, auto directors, drilling rank/energy/sensitivity, all recovery quantities, schema failures and U-versus-UR comparison behavior.
|
||||
- Use the project Harness skill to propose self-contained implementation Steps for user approval, then write only the approved phase-planning files; do not execute Harness without a separate explicit request.
|
||||
- Include tests for source-type mapping, auto directors, fixed drilling rank/separation, required recovery quantities, row failures and U-versus-UR comparison behavior; exclude coefficient sweeps, drilling energy and `NR-O03`/`NR-O04`.
|
||||
|
||||
Reference in New Issue
Block a user