# pwr-hybrid-3-demo

Preliminary example for the HAHACS thesis — a verified hybrid controller for
a small modular PWR startup. Composes three layers into one demonstrable
pipeline:

- **Discrete layer** (`fret-pipeline/`): FRET natural-language requirements
  → LTL → synthesized AIGER controller → state-machine diagram.
- **Continuous layer** (`plant-model/`): 10-state point kinetic equation +
  thermal-hydraulics PWR model with bounded steam-generator heat removal as
  the disturbance input.
- **Research context** (`thesis/`): the HAHACS PhD proposal that motivates
  and formalizes the methodology.

## Layout

```
pwr-hybrid-3-demo/
  CLAUDE.md                AI-facing context and architecture map
  docs/
    architecture.md        How the discrete and continuous layers compose
    figures/               Shared figures for thesis + talks
  fret-pipeline/           FRET → ltlsynt → AIGER → state machine
  plant-model/             PWR point kinetics + thermal-hydraulics
  reachability/            Continuous-mode verification (TBD)
  hardware/                Ovation HIL artifacts (TBD)
  thesis/                  [submodule] PhD proposal
  presentations/
    2026DICE/              [submodule] DICE 2026 abstract
```

## Quickstart

Clone with submodules:

```bash
git clone --recurse-submodules <url>
cd pwr-hybrid-3-demo
```

Run the controller synthesis pipeline:

```bash
cd fret-pipeline
python3 scripts/fret_to_synth.py pwr_hybrid_3.json specs/synthesis_config_v3.json
bash scripts/synthesize.sh specs/synthesis_config_v3.json circuits
python3 scripts/trace_aiger.py circuits/PWR_HYBRID_3_DRC.aag diagrams
dot -Tpng diagrams/PWR_HYBRID_3_DRC_states.dot -o diagrams/PWR_HYBRID_3_DRC_states.png
```

Run the plant model (MATLAB or GNU Octave in `plant-model/`):

```matlab
main
```

## Prerequisites

- Python 3.10+
- [Spot](https://spot.lre.epita.fr/) for `ltlsynt` (`brew install spot`)
- [Graphviz](https://graphviz.org/) for `dot` (`brew install graphviz`)
- MATLAB or GNU Octave for the plant model
- LaTeX (via `latexmk`) for the thesis submodule

## Further reading

- `CLAUDE.md` — orientation for AI agents working in this repo
- `docs/architecture.md` — how the layers compose
- `thesis/CLAUDE.md` — the thesis project structure
- `fret-pipeline/README.md` — FRET naming conventions and pipeline details
- `plant-model/README.md` — scenario setup and model equations