# results/

Output artifacts from reach / barrier / validation runs.  All files
in this directory are **gitignored** — they're regenerated by running
the corresponding script.

## What lives here

Named `<analysis>_<variant>.mat` (MATLAB v7 format, read/written via
Julia's MAT.jl for historical convenience — switching to JLD2 is a
deferred item, see `journal/` for context).

Generated by (as of 2026-04-21):

| File | Generated by |
|---|---|
| `reach_operation_result.mat`      | `code/scripts/reach/reach_operation.jl` |
| `reach_heatup_pj_tight_full.mat`  | `code/scripts/reach/reach_heatup_pj_tight_full.jl` |
| `reach_scram_pj_result.mat`       | `code/scripts/reach/reach_scram_pj.jl` |

Consumed by:

- `code/scripts/plot/plot_reach_tubes.jl` — tube overlay figures.
- `app/predicate_explorer.jl` — live per-halfspace margin rendering.

## Why this directory exists

`reachability/` used to hold both source-of-truth specs
(`predicates.json`, README, WALKTHROUGH.md) and ephemeral reach results.
Mixing stable vs.\ regenerated content made it hard to tell which was
which at a glance.  Split: `reachability/` = specs + docs,
`results/` = outputs.