Skip to main content

Crate outram_foam_multiphase

Crate outram_foam_multiphase 

Source
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 OpenFOAM incompressibleDriftFlux. Foundation done (bead op-2kk.1); the mixture momentum + pressure coupling it deliberately leaves out is provided by pimple (see below).
  • Stage 2 — Euler-Euler two-fluid (two_fluid) — per-phase continuity + drag closures (Schiller-Naumann, Wen-Yu), 6-equation architecture scaffolded. Ref OpenFOAM multiphaseEuler. Foundation done (bead op-2kk.2).
  • Stage 3 — Wall boiling framework (wall_boiling) — RPI heat-flux partitioning (Kurul & Podowski). Foundation done (bead op-2kk.3).
  • Stage 4 — CHF models (chf) — Biasi / W-3 / Bowring correlations + Groeneveld LUT framework. Foundation done (bead op-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, advancing U_m–p–α together.
  • two_fluid_pimple — shared-pressure Euler-Euler PISO: two per-phase momentum predictors coupled through one mixture-continuity pressure equation, advancing U_d–U_c–p–α_d together.

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_flux deliberately 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 the crate::two_fluid foundation 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-safe fvc::reconstruct velocity/flux correction for each phase.
wall_boiling
Stage 3 — Wall-boiling framework (bead op-2kk.3).

Enums§

MultiphaseError
Errors produced by the multiphase solvers in this crate.