Expand description
§outram-foam-multiphase
OUTRAM-FOAM Phase II — multiphase CFD (bead epic op-2kk). Pure-Rust
translation of OpenFOAM’s multiphase solver family on top of
outram_foam_basic_lib’s finite-volume framework (FvMesh, fields,
fvc/fvm operators). This is the authoritative high-fidelity reference
from which TAMPINES’ 1D reduced-order system-code physics (epic op-dt3)
are derived — 1D models must trace back to a validated 3D reference here,
never be invented independently.
⚠️ Unverified until validated — early/scaffold. Everything here is a work-in-progress translation with no human V&V yet. Not for nuclear facility operation, reactor control, safety-critical, or licensing decisions. Independent OUTRAM PARK fork, not the official OpenFOAM software (see the workspace
TRADEMARKS.md).
§Roadmap (per the Phase II architecture; each solver bead has its own DoD:
§theory docs + verification tests + reference-benchmark comparison + uom)
- Stage 1 — Drift Flux (
drift_flux) — mixture continuity/momentum, void-fraction transport, algebraic slip / drift-velocity closures (Zuber-Findlay, terminal velocity, user-defined). Ref OpenFOAMincompressibleDriftFlux. Foundation done (beadop-2kk.1); the mixture momentum + pressure coupling it deliberately leaves out is provided bypimple(see below). - Stage 2 — Euler-Euler two-fluid (
two_fluid) — per-phase continuity + drag closures (Schiller-Naumann, Wen-Yu), 6-equation architecture scaffolded. Ref OpenFOAMmultiphaseEuler. Foundation done (beadop-2kk.2). - Stage 3 — Wall boiling framework (
wall_boiling) — RPI heat-flux partitioning (Kurul & Podowski). Foundation done (beadop-2kk.3). - Stage 4 — CHF models (
chf) — Biasi / W-3 / Bowring correlations + Groeneveld LUT framework. Foundation done (beadop-2kk.4). - Stage 5 — Dryout / post-dryout framework (
dryout) — reserved interfaces + Dougall-Rohsenow worked example. Foundation done (op-2kk.5).
§Pressure-velocity coupling
Two segregated PISO/PIMPLE loops close the momentum + pressure solve the drift-flux and two-fluid foundations deliberately leave out:
pimple— drift-flux mixture PISO/PIMPLE: a Rhie-Chow pressure-correction loop on the single mixture-momentum field, advancingU_m–p–αtogether.two_fluid_pimple— shared-pressure Euler-Euler PISO: two per-phase momentum predictors coupled through one mixture-continuity pressure equation, advancingU_d–U_c–p–α_dtogether.
All modules here are unit-tested foundations, not validated solvers (verification checks — hydrostatic balance, at-rest stability, boundedness — only; benchmark validation is a later human step) — see each module’s “Honest scope”.
§Design rules (workspace CLAUDE.md)
Enum dispatch (no Box<dyn>), no lifetime parameters (Arc, index ids),
uom-typed API boundaries, GPLv3 + OpenFOAM provenance headers on ported
files, Android-buildable (pure-Rust, no system BLAS/GUI).
Modules§
- chf
- Stage 4 — Critical-heat-flux (CHF / DNB / dryout) correlations
(bead
op-2kk.4). - drift_
flux - Stage 1 — Drift-flux mixture model foundation (bead
op-2kk.1). - dryout
- Stage 5 — Dryout & post-dryout framework (bead
op-2kk.5). - heat_
transfer - Interfacial heat-transfer closures for the two-fluid model.
- pimple
- Drift-flux mixture PISO/PIMPLE pressure-velocity coupling — the
foundation of the segregated, incompressible-mixture momentum + pressure
solve that
crate::drift_fluxdeliberately left out (its “Honest scope” note: “No mixture-momentum / pressure coupling.”). This module closes that #1 gap with a real, tested Rhie-Chow pressure-correction loop. - two_
fluid - Stage 2 — Euler-Euler two-fluid model foundation (bead
op-2kk.2). - two_
fluid_ pimple - Two-fluid Euler-Euler phase pressure-velocity coupling — the
two-momentum analogue of the drift-flux PIMPLE loop (
crate::pimple). This closes the #1 gap thecrate::two_fluidfoundation left open (its honest scope: “No phase-momentum / pressure-coupled PIMPLE loop”) with a real, tested shared-pressure Euler-Euler PISO: two per-phase momentum predictors, a single mixture-continuity pressure Poisson equation, and a checkerboard-safefvc::reconstructvelocity/flux correction for each phase. - wall_
boiling - Stage 3 — Wall-boiling framework (bead
op-2kk.3).
Enums§
- Multiphase
Error - Errors produced by the multiphase solvers in this crate.