Dane Sabo fbbaebff9f julia migration: port MATLAB to Julia, delete MATLAB, rename julia-port -> code

Full toolchain port. Numerical equivalence verified against MATLAB:
- main_mode_sweep.jl: every mode's final state matches MATLAB to 3-4 dp
- reach_operation.jl: per-halfspace margins match MATLAB exactly
- barrier_lyapunov.jl: per-halfspace bounds match (best Qbar from sweep
  yields max|dT_c| = 33.228 K either side)
- barrier_compare_OL_CL.jl: OL gamma 1.038e13, CL gamma 1.848e4
  matching the MATLAB result; LQR helps by ~20,000x on every halfspace.

Phase summary:
  Phase 1: pke_solver.jl, plot_pke_results.jl (Plots.jl), main_mode_sweep.jl
  Phase 2: reach_linear.jl, reach_operation.jl, barrier_lyapunov.jl,
           barrier_compare_OL_CL.jl, load_predicates.jl
  Phase 3 (this commit): delete plant-model/ entirely, delete reach
           code from reachability/ keeping predicates.json + docs,
           git mv julia-port/ -> code/, update root README + CLAUDE,
           write code/CLAUDE.md and code/README.md, update reach
           README + WALKTHROUGH file paths, journal preamble note
           that pre-port entries reference MATLAB paths.

Why now: prompt-neutron stiffness in nonlinear reach made it clear we
need TMJets, which is Julia. Already had the Julia plant model
working and matching MATLAB. Two languages = two sources of truth =
two places to drift. One language, one truth.

Manifest.toml gitignored. .mat results gitignored.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-20 21:44:59 -04:00

4.0 KiB

Raw Blame History

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 (code/): 10-state point kinetic equation + thermal-hydraulics PWR model with bounded steam-generator heat removal as the disturbance input. Controllers, linearization, LQR, reach-tube propagator, Lyapunov barrier — all Julia.
Verification artifacts (reachability/): predicate concretizations (single source of truth in predicates.json) and the standalone reach analysis writeup (WALKTHROUGH.md).
Research context (thesis/): the HAHACS PhD proposal.
Lab journal (journal/): chronological invention log in LaTeX.
Predicate explorer app (app/): Pluto.jl notebook bridging FRET predicates and continuous-state halfspaces.

Layout

pwr-hybrid-3-demo/
  CLAUDE.md                AI-facing context and architecture map
  docs/
    architecture.md        How the layers compose
    figures/               Shared figures for thesis + talks
  fret-pipeline/           FRET → ltlsynt → AIGER → state machine
  code/                    Plant model, controllers, reach (all Julia)
  reachability/            predicates.json + WALKTHROUGH.md
  app/                     Pluto.jl predicate explorer
  journal/                 LaTeX lab notebook
  hardware/                Ovation HIL artifacts (TBD)
  claude_memory/           Short AI-context notes
  thesis/                  [submodule] PhD proposal
  presentations/
    2026DICE/              [submodule] DICE 2026 abstract

Quickstart

Clone with submodules:

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

Run the controller synthesis pipeline:

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 and reach analysis:

cd code
julia --project=. -e 'using Pkg; Pkg.instantiate()'    # first time only

julia --project=. scripts/main_mode_sweep.jl           # all 5 DRC modes
julia --project=. scripts/reach_operation.jl           # operation-mode linear reach
julia --project=. scripts/barrier_lyapunov.jl          # Lyapunov barrier
julia --project=. scripts/barrier_compare_OL_CL.jl     # OL vs CL barrier
julia --project=. scripts/reach_heatup_nonlinear.jl    # nonlinear heatup (10s cap)

Open the predicate explorer:

cd app
julia --project=. -e 'using Pluto; Pluto.run()'
# Browser opens; navigate to predicate_explorer.jl

Soundness note: the current reach tubes are over-approximations of the LINEAR model, not sound over-approximations of the nonlinear plant. See reachability/README.md and reachability/WALKTHROUGH.md.

Prerequisites

Julia 1.10+ (via juliaup).
Python 3.10+ (FRET pipeline only).
Spot for ltlsynt (brew install spot).
Graphviz for dot (brew install graphviz).
LaTeX (via latexmk) for the thesis + journal builds.

4.0 KiB Raw Blame History

pwr-hybrid-3-demo

Layout

Quickstart

Prerequisites

Further reading

4.0 KiB

Raw Blame History