add euler beam uel phase

2026-06-11 11:08:44 +09:00
parent 986cc9888e
commit 3f6275201e
11 changed files with 625 additions and 0 deletions
@@ -0,0 +1,59 @@
+# Step 5: test-models
+
+## Read First
+
+- `/AGENTS.md`
+- `/docs/ABAQUS_SUBROUTINE_AGENT_DESIGN.md`
+- `/docs/ARCHITECTURE.md`
+- `/docs/ADR.md`
+- `/.codex/skills/abaqus-subroutine-test-models/SKILL.md`
+- `/docs/requirements/uel-3d-euler-beam.md`
+- `/docs/formulations/uel-3d-euler-beam.md`
+- `/docs/io-definitions/uel-3d-euler-beam.md`
+- `/docs/reference-models/README.md`
+
+## Task
+
+Create `/docs/reference-models/uel-3d-euler-beam.md`.
+
+Design the no-Abaqus test model plan and external reference artifact contract. Include:
+
+- No-Abaqus kernel tests for local stiffness terms, matrix symmetry, rigid-body modes, axial deformation, torsion, bending about both local axes, orientation transform, reversed node order, and invalid inputs.
+- Wrapper or smoke-test strategy that verifies the Abaqus `UEL` array mapping without launching Abaqus.
+- Planned `tests/fortran/manifest.json` entries and source file paths to be created in the next step.
+- Expected production source layout, keeping the Abaqus wrapper thin and calculation logic testable outside Abaqus.
+- External Abaqus `model.inp` reference cases to be created by a user on an Abaqus PC later.
+- Required reference bundle layout under `references/uel-3d-euler-beam/<model-id>/`.
+- Required extracted CSV files, schemas, units, coordinate systems, and tolerances.
+- Required `.msg/.dat/.log/.sta` tail files and metadata provenance.
+
+The model plan may define draft artifact directories and metadata requirements, but must not create fake reference CSVs or claim solver evidence exists.
+
+Do not create or modify Fortran source or tests in this step. The next step owns test file creation and RED evidence.
+
+## Tests To Write First
+
+- None. This is a reference model and test design artifact step.
+
+## Acceptance Criteria
+
+```bash
+python -m unittest discover -s scripts -p "test_*.py"
+python scripts/validate_reference_artifacts.py
+python scripts/validate_workspace.py
+```
+
+The step is complete only when `/docs/reference-models/uel-3d-euler-beam.md` names exact no-Abaqus tests, exact manifest entries, and exact external artifact contracts.
+
+## Validation Notes
+
+- Treat external Abaqus artifacts as future user-provided evidence.
+- Update `/phases/uel-3d-euler-beam/index.json` step 5 with `completed`, `error`, or `blocked` and a concrete summary or reason.
+
+## Forbidden
+
+- Do not add JavaScript/TypeScript/npm fallback.
+- Do not run Abaqus analyses from this project.
+- Do not generate reference CSVs.
+- Do not create Fortran production source.
+- Do not break existing tests.