# 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`, `quad_02_reactionforces.csv` | Abaqus/CAE Learning Edition 2024 source input; `TYPE=S4`; displacement and RF/RM CSV files each have 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`, `quad_02_reactionforces.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` |

## Reaction CSV Format

`*_reactionforces.csv` and `*_reactions.csv` files use Abaqus-exported nodal reaction columns:

```text
Node Label, RF-RF1, RF-RF2, RF-RF3, RM-RM1, RM-RM2, RM-RM3
```

Mapping to FESA:

| CSV Column | FESA Component |
|---|---|
| `Node Label` | node id |
| `RF-RF1` | `RFX` |
| `RF-RF2` | `RFY` |
| `RF-RF3` | `RFZ` |
| `RM-RM1` | `RMX` |
| `RM-RM2` | `RMY` |
| `RM-RM3` | `RMZ` |

`quad_02_reactionforces.csv` is onboarded as a stored reaction artifact, but the current FESA node-wise RF comparison does not pass yet. Keep the mismatch visible until the solver/formulation difference is explained or fixed.

## 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.