60 lines
2.5 KiB
Markdown
60 lines
2.5 KiB
Markdown
# 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.
|