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

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.

2.5 KiB Raw Permalink Blame History