cebf8c167a
Folds three previously-separate pieces into one preliminary-example repo for the HAHACS thesis: - thesis/ (submodule) → gitea Thesis.git — the PhD proposal - fret-pipeline/ — FRET requirements to AIGER controller (was ~/Documents/fret_processing/; prior single-commit history abandoned per user decision) - plant-model/ — 10-state PKE + lumped T/H PWR model (was ~/Documents/PKE_Playground/; never version-controlled before) - presentations/2026DICE/ (submodule) → gitea 2026DICE.git - reachability/, hardware/ — empty placeholders for Thrust 3 and HIL - docs/architecture.md — how the discrete and continuous layers compose - claude_memory/ — session notes and scratch knowledge pattern Plant model refactored to thesis naming (x, plant, u, ref); pke_th_rhs now takes u as an explicit arg instead of reading rho_ext from the params struct. First two controllers built to the contract u = ctrl_<mode>(t, x, plant, ref): ctrl_null (baseline) and ctrl_operation (stabilizing, proportional on T_avg). Validated under a 100% -> 80% Q_sg step: ctrl_operation reduces steady-state T_avg drift ~47% vs. the unforced plant. Root CLAUDE.md emphasizes that CLAUDE.md files are living documents and that any knowledge not captured before a session ends is lost forever; claude_memory/ holds the session-level notes that haven't stabilized enough to graduate into a CLAUDE.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
72 lines
2.4 KiB
Markdown
72 lines
2.4 KiB
Markdown
# 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
|