Dane Sabo cebf8c167a Initial umbrella repo: thesis + FRET pipeline + plant model with first controllers

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>

2026-04-16 16:24:11 -04:00

2.5 KiB

Raw Blame History

plant-model

PWR plant model (point kinetics + lumped thermal-hydraulics) and mode-specific continuous controllers for the HAHACS preliminary example.

Overview

A 10-state coupled neutronics + thermal-hydraulics model in MATLAB:

6 delayed neutron precursor groups (U-235 thermal fission, Keepin)
Lumped fuel, core coolant, and SG/cold-leg thermal nodes
Steam generator heat removal Q_sg(t) as the bounded disturbance input
Doppler and moderator temperature reactivity feedback
External rod reactivity u as the controllable input

State vector: x = [n; C1..C6; T_f; T_c; T_cold] (10 states). See CLAUDE.md for the naming convention.

Quick Start

Open MATLAB in this directory and run:

main

The default scenario runs two simulations of a 100% → 80% SG demand step: once with ctrl_null (plant feedback only) and once with ctrl_operation (proportional rod reactivity on T_avg error), and plots the comparison.

Files

File	Role
`main.m`	Entry point — scenario config and run
`pke_params.m`	Plant parameters and steady-state derivation
`pke_th_rhs.m`	Dynamics `ẋ = f(t, x, plant, Q_sg, u)`
`pke_initial_conditions.m`	Analytic steady-state `x0`
`pke_solver.m`	Closed-loop driver — takes a controller function handle
`plot_pke_results.m`	4-panel results plot
`load_profile.m`	SG heat demand shapes
`controllers/ctrl_null.m`	`u = 0` baseline
`controllers/ctrl_operation.m`	Stabilizing mode: P on `T_avg`

Controllers

Controllers share a single signature:

u = ctrl_<mode>(t, x, plant, ref)

Returns scalar u (external rod reactivity in dk/k). The solver swaps controllers via function handle:

[t, X, U] = pke_solver(plant, Q_sg, @ctrl_operation, ref, tspan);

Additional modes (ctrl_heatup, ctrl_scram, ctrl_shutdown) will land in controllers/ following the same signature.

Running Different Scenarios

Swap Q_sg in main.m:

% Step down to 90% at t = 10s
Q_sg = @(t) plant.P0 * (1.0 - 0.1 * (t >= 10));

% Interpolated time series
t_data = [0, 100, 200, 300];
q_data = [1.0, 0.85, 0.9, 1.0] * plant.P0;
Q_sg = @(t) interp1(t_data, q_data, t, 'linear', 'extrap');

Swap the controller:

[t, X, U] = pke_solver(plant, Q_sg, @ctrl_null, [], tspan);

Change the reference (for modes that use one):

ref.T_avg = plant.T_c0 + 5;   % track 5 C above nominal

Requirements

MATLAB (R2020b or newer, tested on R2025b). Uses ode15s from base MATLAB — no toolboxes required.

2.5 KiB Raw Blame History