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>
93 lines
2.5 KiB
Markdown
93 lines
2.5 KiB
Markdown
# 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:
|
|
|
|
```matlab
|
|
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:
|
|
|
|
```matlab
|
|
u = ctrl_<mode>(t, x, plant, ref)
|
|
```
|
|
|
|
Returns scalar `u` (external rod reactivity in `dk/k`). The solver swaps
|
|
controllers via function handle:
|
|
|
|
```matlab
|
|
[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`:
|
|
|
|
```matlab
|
|
% 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:
|
|
|
|
```matlab
|
|
[t, X, U] = pke_solver(plant, Q_sg, @ctrl_null, [], tspan);
|
|
```
|
|
|
|
Change the reference (for modes that use one):
|
|
|
|
```matlab
|
|
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.
|