feat: add reactor control persistence and tests

src/reactor_sim/turbine.py

@@ -0,0 +1,69 @@
+"""Steam generator and turbine performance models."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import logging
+
+from . import constants
+from typing import Optional
+
+from .state import CoolantLoopState, TurbineState
+from .consumer import ElectricalConsumer
+
+LOGGER = logging.getLogger(__name__)
+
+
+@dataclass
+class SteamGenerator:
+    drum_volume_m3: float = 200.0
+
+    def steam_enthalpy(self, loop: CoolantLoopState) -> float:
+        base = 2_700.0  # kJ/kg saturated steam
+        quality_adjustment = 500.0 * loop.steam_quality
+        return base + quality_adjustment
+
+
+@dataclass
+class Turbine:
+    generator_efficiency: float = constants.GENERATOR_EFFICIENCY
+    mechanical_efficiency: float = constants.STEAM_TURBINE_EFFICIENCY
+
+    def step(
+        self,
+        loop: CoolantLoopState,
+        state: TurbineState,
+        consumer: Optional[ElectricalConsumer] = None,
+    ) -> None:
+        enthalpy = 2_700.0 + loop.steam_quality * 600.0
+        mass_flow = loop.mass_flow_rate * 0.6
+        shaft_power_mw = (enthalpy * mass_flow / 1_000.0) * self.mechanical_efficiency / 1_000.0
+        electrical = shaft_power_mw * self.generator_efficiency
+        if consumer:
+            load_demand = consumer.request_power()
+            supplied = min(electrical, load_demand)
+            consumer.update_power_received(supplied)
+            LOGGER.debug(
+                "Consumer %s demand %.1f -> supplied %.1f MW",
+                consumer.name,
+                load_demand,
+                supplied,
+            )
+        else:
+            load_demand = 0.0
+            supplied = 0.0
+        condenser_temp = max(305.0, loop.temperature_in - 20.0)
+        state.steam_enthalpy = enthalpy
+        state.shaft_power_mw = shaft_power_mw
+        state.electrical_output_mw = electrical
+        state.condenser_temperature = condenser_temp
+        state.load_demand_mw = load_demand
+        state.load_supplied_mw = supplied
+        LOGGER.debug(
+            "Turbine output: shaft=%.1fMW electrical=%.1fMW condenser=%.1fK load %.1f/%.1f",
+            shaft_power_mw,
+            electrical,
+            condenser_temp,
+            supplied,
+            load_demand,
+        )