# FESA Reference Artifacts

This folder stores Abaqus input files and solved reference result artifacts used to verify FESA.

Abaqus is not run by the repository validation flow. Files here are treated as stored numerical references after they are accepted.

## Initial Accepted Files

| Case | Input | Result Artifact | Notes |
|---|---|---|---|
| `quad_01` | `quad_01.inp` | `quad_01_displacements.csv` | Abaqus/CAE Learning Edition 2024 source input; displacement CSV has 121 nodal rows |
| `quad_02` | `quad_02.inp` | `quad_02_displacements.csv` | Abaqus/CAE Learning Edition 2024 source input; `TYPE=S4`; displacement CSV has 121 nodal rows; original input remains unsupported provenance because it contains Abaqus/CAE scaffolding |
| `quad_02_phase1` | `quad_02_phase1.inp` | `quad_02_displacements.csv` | Normalized Phase 1 parser-compatible derivative of `quad_02.inp`; preserves ids, connectivity, material, shell thickness, fixed boundary set, and concentrated load |

Case-specific notes:
- `quad_02_notes.md`

## Displacement CSV Format

`*_displacements.csv` files use Abaqus-exported nodal displacement columns:

```text
Node Label, U-U1, U-U2, U-U3, UR-UR1, UR-UR2, UR-UR3
```

Mapping to FESA:

| CSV Column | FESA Component |
|---|---|
| `Node Label` | node id |
| `U-U1` | `UX` |
| `U-U2` | `UY` |
| `U-U3` | `UZ` |
| `UR-UR1` | `RX` |
| `UR-UR2` | `RY` |
| `UR-UR3` | `RZ` |

## Compatibility Notes

Stored Abaqus inputs may contain features outside the current FESA Phase 1 parser subset. Preserve the original files and document unsupported features instead of editing them in place.

`quad_01.inp` currently includes `TYPE=S4R`, `Part/Assembly/Instance`, `*Density`, and `NLGEOM=YES`. These are stored for reference provenance and future compatibility work; they are not Phase 1 parser acceptance requirements unless `docs/ABAQUS_INPUT_SUBSET.md` and `docs/ADR.md` are updated.

`quad_02.inp` currently includes `TYPE=S4`, `Part/Assembly/Instance`, `*Density`, restart/output request keywords, and Abaqus/CAE step metadata. `quad_02_phase1.inp` is the accepted Phase 1-compatible derivative input. The original file must continue to be treated as stored provenance, not as parser acceptance.