docs: use S4-only MITC4 reference gate
This commit is contained in:
KOKO\Mimi
@@ -10,10 +10,10 @@
|
||||
- source_commits: requirements/research/formulation policy revision `73df844`
|
||||
- status: `approved-for-implementation-planning`
|
||||
- owner_agent: `io-definition-agent`
|
||||
- date: `2026-08-12`
|
||||
- date: `2026-08-13`
|
||||
- authoritative_output: `results.h5`
|
||||
- hdf5_schema_version: `0`
|
||||
- reference_cases: read-only S4 at `reference/shell/`; read-only S4R at `reference/shellR/`
|
||||
- reference_cases: sole acceptance case is read-only full-integration S4 at `reference/shell/`; S4R is covered by non-reference source-mapping/kernel/metadata tests
|
||||
- implementation_planning_authorized: `true`
|
||||
|
||||
This document defines the approved semantic input and output contract for the
|
||||
@@ -23,14 +23,15 @@ comparison-tool C++ APIs and does not claim full Abaqus compatibility or Abaqus
|
||||
|
||||
The user approved the following I/O-specific decisions on `2026-08-12`:
|
||||
|
||||
1. `S4` and `S4R` reference artifacts remain separate even though both source types
|
||||
map to one internal `FESA-MITC4` formulation.
|
||||
1. `S4` and `S4R` source types map to one internal full-integration `FESA-MITC4`
|
||||
formulation, while only S4 is an Abaqus acceptance reference.
|
||||
2. The optional positive integer on a `*SHELL SECTION` thickness row is accepted
|
||||
without a warning and has no semantic effect on FESA quadrature. FESA always uses
|
||||
the formulation's `2 x 2 x 2` rule.
|
||||
3. The existing `reference/shell/` S4 and `reference/shellR/` S4R input/displacement
|
||||
files are retained under their current names without mutation. No canonical or
|
||||
legacy-alias classification is required.
|
||||
3. The existing `reference/shell/` S4 input/displacement files are the sole declared
|
||||
acceptance pair and remain under their current names without mutation. Existing
|
||||
`reference/shellR/` files are untouched optional evidence and are not consumed by
|
||||
acceptance comparison. No canonical or legacy-alias classification is required.
|
||||
4. HDF5 schema version `0` is extended additively with MITC4-specific datasets while
|
||||
retaining the existing common metadata, nodal-result, diagnostic, CLI, and
|
||||
failure-atomicity conventions.
|
||||
@@ -440,15 +441,12 @@ Authoritative comparison reads `results.h5` and read-only Abaqus CSV artifacts.
|
||||
A deterministic FESA CSV projection is a debugging/review view only; it is neither
|
||||
solver output nor a reference artifact.
|
||||
|
||||
### 7.1 S4/S4R case separation
|
||||
### 7.1 Full-integration reference boundary
|
||||
|
||||
- S4 and S4R use their existing distinct input and displacement CSV paths.
|
||||
- FESA maps both source types to `FESA-MITC4`, but Abaqus S4 and S4R values are not
|
||||
expected to equal each other on a finite mesh.
|
||||
- Reference comparison always compares one FESA run with Abaqus rows generated from
|
||||
the same source model/type.
|
||||
- FESA maps S4 and S4R source types to the same full `2 x 2 x 2` FESA-MITC4 path.
|
||||
- Reference comparison consumes only the declared S4 input/displacement pair.
|
||||
- Equality of FESA internal numerical rows after changing only source type is a
|
||||
separate implementation test, not an Abaqus S4-versus-S4R comparison.
|
||||
separate implementation test; it does not consume or compare Abaqus S4R rows.
|
||||
|
||||
### 7.2 Declared S4 case
|
||||
|
||||
@@ -463,23 +461,18 @@ The files must not be renamed, rewritten, zero-clamped, normalized, or repaired.
|
||||
The reaction and stress CSV files in the same directory are optional review evidence
|
||||
and are not comparison inputs.
|
||||
|
||||
### 7.3 Declared S4R case
|
||||
### 7.3 S4R non-reference coverage
|
||||
|
||||
The blocking S4R case uses:
|
||||
|
||||
| role | exact path | SHA-256 | observed inventory |
|
||||
| --- | --- | --- | --- |
|
||||
| input | `reference/shellR/shellR.inp` | `1325940FB42B78961CF25E84379BF2693846FAD22473E7688AC5456B37B18CB4` | `TYPE=S4R`; declared comparison input |
|
||||
| displacement | `reference/shellR/shellR displacements.csv` | `8887ACC5ED007CB97583A9FDC1150B48B9297E269A5BA8EBA6C1A5F6306E98CB` | 49 finite data rows; U and UR columns |
|
||||
|
||||
These files follow the same immutability rule. The reaction and stress CSV files in
|
||||
the directory are optional review evidence and are not comparison inputs. No README,
|
||||
No file under `reference/shellR/` is required or consumed by this acceptance
|
||||
comparison. S4R source support is verified by parser mapping, S4/S4R common-kernel
|
||||
and deterministic-assembly equivalence, plus preserved HDF5 source-type metadata.
|
||||
Any existing S4R artifacts remain immutable optional inspection evidence. No README,
|
||||
`metadata.json`, canonical name, legacy alias, provenance record, or duplicated model
|
||||
description is required for either case.
|
||||
description is required.
|
||||
|
||||
### 7.4 Displacement header mapping
|
||||
|
||||
After trimming header whitespace, both declared displacement CSVs use:
|
||||
After trimming header whitespace, the declared S4 displacement CSV uses:
|
||||
|
||||
| CSV column | comparison field/component | FESA HDF5 source |
|
||||
| --- | --- | --- |
|
||||
@@ -604,7 +597,7 @@ warning behavior.
|
||||
| HDF5 model | exact paths, dtypes, shapes, IDs, source types, directors, sections, and finite values | output, exit 6 |
|
||||
| HDF5 results | every mandatory row/location/component exists in stable order and is finite | output, exit 6 |
|
||||
| S4 case | exact declared input/displacement paths and unique finite U/UR rows | reference precheck |
|
||||
| S4R case | exact declared input/displacement paths and unique finite U/UR rows | reference precheck |
|
||||
| S4R source support | parser/common-kernel/deterministic-assembly/HDF5 metadata tests; no Abaqus artifact consumption | implementation verification |
|
||||
| comparison | exact normalized row-set; U blocking; UR warning-only; approved tolerance | reference verification |
|
||||
|
||||
No successful parser/HDF5 implementation, numerical solution, reference comparison,
|
||||
@@ -623,7 +616,7 @@ physics review, or release status follows from approval of this document alone.
|
||||
| `039-048` | additive HDF5 v0 paths, mandatory quantities, location identity, atomic output | Reference Model and Implementation Planning |
|
||||
| `049-057` | diagnostic/schema hooks and required verification-metric/physical-energy evidence | Numerical Review and planning |
|
||||
| `058-064` | normalized U/UR rows, exact B33 tolerance, blocking/warning behavior, report inventory | Reference Verification |
|
||||
| `065-072` | exact current S4/S4R paths, immutability and displacement-only gate | Reference Model |
|
||||
| `065-072` | exact current S4 paths, S4R reference non-consumption, immutability and displacement-only gate | Reference Model |
|
||||
|
||||
## 11. Open Issues and Downstream Handoff
|
||||
|
||||
|
||||
Reference in New Issue
Block a user