docs: redefine phase 1 rebaseline steps

This commit is contained in:
NINI
2026-05-04 12:15:07 +09:00
parent a385235e14
commit 357b4bd893
20 changed files with 1013 additions and 18 deletions
@@ -0,0 +1,57 @@
# Sprint Contract: Results Comparator Foundation
## Objective
Rebuild or verify the minimum Phase 1 results model and Abaqus displacement CSV comparator before using stored reference regressions.
## Required Reading
- /AGENTS.md
- /docs/RESULTS_SCHEMA.md
- /docs/VERIFICATION_PLAN.md
- /docs/NUMERICAL_CONVENTIONS.md
## Scope
- Store minimum result model data for nodes, elements, `U`, and `RF`.
- Preserve step/frame/field structure even if HDF5 writing is deferred.
- Load Abaqus `*_displacements.csv` by node id and component label.
- Compare using absolute and relative tolerances.
## Allowed Files
- `include/`
- `src/`
- `tests/`
- `docs/RESULTS_SCHEMA.md` only for clarifying schema text
- `docs/VERIFICATION_PLAN.md` only for clarifying tolerance/reference text
- `PLAN.md`
- `PROGRESS.md`
## Explicit Non-Goals
- Do not make `S`, `E`, or `SF` mandatory.
- Do not require Abaqus execution.
- Do not rely on CSV row order.
## Tests To Write First
- `U` and `RF` field component labels and basis tests.
- CSV required-header tests.
- Duplicate/missing/non-numeric node row tests.
- Node-id-based comparison tests with absolute and relative tolerance paths.
- Result frame metadata tests for Phase 1 linear static frame 0.
## Reference Artifacts
- `references/quad_02_displacements.csv`
- `references/quad_01_displacements.csv`
## Acceptance Commands
```bash
python scripts/validate_workspace.py
```
## Evaluator Checklist
- Result component order matches docs.
- Comparator maps Abaqus columns to FESA `U` labels exactly.
- `RF` exists as a result field even if Abaqus RF CSV is unavailable.
## Handoff Requirements
- Record comparator readiness and remaining RF artifact decision in `PROGRESS.md` and `PLAN.md`.
## Do Not
- Do not add undocumented CSV formats.