# ROEB-Stress: Plate with Hole — Tier 1 benchmark kit

Small starter pack for external teams who want to understand the benchmark, inspect data layout,
and prepare a submission to the [AIPhysics leaderboard](https://aiphysics.org/leaderboard).

**Tier 1 is not a full training dataset.** It includes the DOE, example meshes, CalculiX parameter docs,
two example solved cases, and official holdout scalar targets.

## Contents

| Path | Description |
|------|-------------|
| `doe/cases.csv` | All 31 FEA cases: hole diameter [mm], VM, Kt, solver metadata |
| `doe/holdout_scalars.csv` | Five official holdout diameters + reference VM/Kt for scoring |
| `simulation/` | **Example STLs, hole-diameter docs, CalculiX guidance, Peterson analytical** |
| `examples/case_hole_6mm_train/` | Solved example at d = 6 mm (yaml + VTU) |
| `examples/case_hole_15mm_train/` | Solved example at d ≈ 15 mm |
| `spec/benchmark.json` | Machine-readable benchmark definition |
| `submit/README.md` | How to package and upload results |

## Benchmark summary

- **Input:** central **hole diameter** [mm] — **parametric geometry** (unique mesh per case)
- **Outputs:** **Kt** (stress concentration factor), **VM** (peak von Mises stress [MPa]); fields **S_Mises**, **S_xx**, **S_yy**, **S_xy**, **U_x**
- **Solver:** CalculiX 2.22, C3D10, 10 MPa applied pressure, 200×50×5 mm plate

## Quick start

1. Read `simulation/HOW_HOLE_DIAMETER_WORKS.md` — **start here if re-running FEA**
2. Inspect `simulation/mesh/` STLs and example VTUs in `examples/`
3. Sweep hole diameters from `doe/cases.csv` (or holdouts from `doe/holdout_scalars.csv`)
4. Match output fields per `simulation/postprocessing/README.md`
5. Submit via `/submit` on AIPhysics.org

## License / attribution

Simulation data generated with CalculiX. Benchmark governed by AIPhysics.org consortium terms.
