83c5cb8500
Records the journal scaffold + retroactive-entries + Julia migration
+ Pluto app work, with \apass{} markers for content that should be
expanded in a later A-pass. Keeps the discipline going from the
night the journal stood up.
Easter eggs:
- ASCII reactor + primary loop in journal/README.md (subtle, shows
where Q_sg flows in as a disturbance).
- Garden-lyric reference embedded in pke_params.jl docstring
("looks ordinary on the surface but is something else underneath")
— same lyric as the preamble.tex comment, referencing the name
behind Split. Hacker-Split's signature.
- 🦎 in the Pluto notebook header + closer.
Nothing functional, nothing that clutters the substance.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
code
Plant model, controllers, and reach-analysis toolchain for the HAHACS preliminary example. All Julia.
What this is
A 10-state coupled neutronics + thermal-hydraulics model (point kinetic equations + lumped thermal loop) with continuous-mode controllers for each of the DRC modes (shutdown, heatup, operation, scram), plus a hand-rolled linear reach-tube propagator, a Lyapunov-ellipsoid barrier attempt, and scaffolding for TMJets-based nonlinear reach.
Ported from MATLAB on 2026-04-20 once the reach experiments made it
clear that Julia's stack (OrdinaryDiffEq, MatrixEquations,
ReachabilityAnalysis, LazySets, @taylorize) was the right tool
for everything we need going forward. The MATLAB originals are in
the git history.
Running
First time:
cd code
julia --project=. -e 'using Pkg; Pkg.instantiate()'
Subsequent:
julia --project=. scripts/main_mode_sweep.jl # all 5 DRC modes, figures
julia --project=. scripts/reach_operation.jl # operation-mode linear reach
julia --project=. scripts/barrier_lyapunov.jl # Lyapunov barrier attempt
julia --project=. scripts/barrier_compare_OL_CL.jl # OL vs CL barrier
julia --project=. scripts/reach_heatup_nonlinear.jl # nonlinear heatup (10s cap)
Figures save to ../docs/figures/. Reach results save to
../reachability/*.mat (gitignored).
Structure
See CLAUDE.md for the architectural overview and ../journal/ for
the invention-log-style narrative of how this code got written.
Dependencies
From Project.toml:
OrdinaryDiffEq— ODE solver, Rodas5 for stiff systems.MatrixEquations—arecfor LQR Riccati,lyapcfor Lyapunov.ReachabilityAnalysis+LazySets— reach sets and set operations.Plots— figures (GR backend by default).JSON— read../reachability/predicates.json.MAT— save results.
Manifest.toml is gitignored; regenerate locally on first
Pkg.instantiate().