InputEnums
The InputEnums package defines a set of enumeration classes used to specify valid options for physical models in OpenSTREAM. These enums help ensure consistency and clarity when selecting model configurations, making the simulation setup more robust and less error-prone.
Typical examples include choosing between void fraction models, interfacial transfer options, or flow regime assumptions, each represented by a clearly defined enum.
- class InputEnums.LOCRELVEL
LOCRELVEL Enumeration of local relative velocity models
This class defines the available
Inputs.Model.LOCRELVELmodels for calculating the local relative velocity between liquid and vapor phases, used by the two-fluid solver.Models:
AREAMEAN — Difference between area-averaged phase velocities (Walter [2024])
SCALED — Scaled difference using user-defined
Inputs.Model.RELVELCST(Walter [2024])DRIFT — Uses drift velocity as the local relative velocity (Walter [2024])
SIMPLE — Simplified assumptions for bubbly and annular flow regime (Walter [2024])
- class InputEnums.NEARWALLRELAX
NEARWALLRELAX Enumeration of near-wall energy transfer time relaxation models
This class defines the available
Inputs.Model.NEARWALLRELAXmodels for calculating the near-wall energy transfer time relaxation, used in mixture solver.Models:
QUALITY — Simple model relating relaxation time to equilibrium quality using user-defined
Inputs.Model.NEARWALLRELAXXandInputs.Model.NEARWALLRELAXTVOID — Physical model based on local phase volumetric fraction using user-defined
Inputs.Model.NEARWALLRELAXCOEFFILM — Model applicable to annular two-phase flow
- class InputEnums.INTNU
INTNU Enumeration of interfacial Nusselt number models
This class defines the available
Inputs.Model.INTNUmodels for calculating the interfacial Nusselt number, used by the two-fluid solver.Models:
CONSTANT — Assumes a constant Nusselt number using user-defined
Inputs.Model.INTNUVCSTandInputs.Model.INTNULCSTfor the dispersed gas and liquid phases, respectivelyRANZMARSHALL — Ranz-Marshall correlation-based model (Ranz and Marshall [1952]) using user-defined
Inputs.Model.RANZMARSHALLVCSTandInputs.Model.RANZMARSHALLLCSTfor the dispersed gas and liquid phases, respectivelyRELAXATION — Time relaxation-based model (Walter [2024])
- class InputEnums.NEARWALLH
NEARWALLH Enumeration of near-wall equilibrium enthalpy models
This class defines the available
Inputs.Model.NEARWALLHmodels for setting the near-wall enthalpy to mixture enthalpy ratio, used by the mixture solvers.Models:
RATIO — Constant near-wall enthalpy to mixture enthalpy ratio using user-defined
Inputs.Model.NEARWALLHRATIOFILM — Mass flux-dependent input for annular two-phase flow
- class InputEnums.MOMENTBASE
MOMENTBASE Enumeration of base film momentum conservation models
This class defines the available
Inputs.Model.MOMENTBASEmodels for solving the base film momentum conservation equation, used to compute the base film velocity in the four-field solver.Models:
ALGEBRAIC — Simple algebraic model (Adamsson and Le Corre [2014], Equations 21 or 23)
EQUILIBRIUM — Equilibrium model
EQUILIBRIUMS — Simplified equilibrium model based on force balance (\(F_{\mathrm{wall}} + F_{\mathrm{vapor}} = 0\))
FULL — Full non-equilibrium model (Le Corre [2022])
FULLNOP — Full non-equilibrium model excluding pressure terms (gravity and buoyancy)
- class InputEnums.THINFILMFRIC
THINFILMFRIC Enumeration of thin film friction models
This class defines the available
Inputs.Model.THINFILMFRICmodels for calculating wall friction under thin film conditions, used by the three-field and four-field solvers.Models:
LAMINAR — Laminar flow model (\(16/\mathrm{Re}_{film}\))
TURBULENT — Turbulent flow model
- class InputEnums.WAVEBASEINT
WAVEBASEINT Enumeration of wave to base film interfacial momentum transfer models
This class defines the available
Inputs.Model.WAVEBASEINTmodels for calculating the interfacial momentum transfer between wave and base film regions, used by the four-field solver.Models:
VAPORSHEAR — Vapor shear across wave area (consistent with Le Corre [2022], Eq. 46).
VAPORSHEARDROPMASS — Also includes drop deposition momentum transfer, ensuring consistency between wave and base film velocities for thin films.
- class InputEnums.OAF
OAF Enumeration of onset of annular flow models
This class defines the available
Inputs.Model.OAFmodels for predicting the onset of annular flow, used by the three-field and four-field solvers.Models:
- class InputEnums.OAFENTRAINED
OAFENTRAINED Enumeration of entrained drop models at onset of annular flow
This class defines the available
Inputs.Model.OAFENTRAINEDmodels for splitting the droplet and film mass flow rates at the onset of annular flow, used by the three-field and four-field solvers.Models:
RATIO — Ratio of droplet to liquid mass flow rates using user-defined
Inputs.Model.OAFDROPRATIOEQUILIBRIUM — Equilibrium assumption model (\(M_{\mathrm{ent}} = M_{\mathrm{dep}}\)) (Adamsson and Le Corre [2011], Equations 15 and 16)
- class InputEnums.DEPOSITION
DEPOSITION Enumeration of droplet deposition models
This class defines the available
Inputs.Model.DEPOSITIONmodels for calculating the droplet deposition mass flux, used by the three-field and four-field solvers.NOTE: Entrainment and deposition correlations are coupled. It is recommended to use the same model for both entrainment and deposition mass flux to ensure consistency.
Models:
- class InputEnums.THERMALRELAX
THERMALRELAX Enumeration of HRM time relaxation models
This class defines the available
Inputs.Model.THERMALRELAXmodels for calculating relaxation times in the HRM model, used whenInputs.Model.THERMALNONEQis set to HRM.Models:
QUALITY — Simple model relating relaxation time to equilibrium quality using user-defined
Inputs.Model.TRELAXX,Inputs.Model.TRELAXTCONDandInputs.Model.TRELAXTEVAPVOID — Physical model based on phase volumetric fraction using user-defined
Inputs.Model.TRELAXCONDCOEFandInputs.Model.TRELAXEVAPCOEF
- class InputEnums.SPMTM
SPMTM Enumeration of single-phase wall momentum transfer models
This class defines the available
Inputs.Model.SPMTMmodels for calculating the single-phase wall momentum transfer (liquid or gas), used by the mixture solver.Models:
BLASIUS — Blasius wall momentum transfer model (\(f = C(1) Re^{C(2)} + C(3)\)) using user-defined
Inputs.Model.FRICTIONcoefficients
- class InputEnums.INTAREA
INTAREA Enumeration of volumetric interfacial area calculation models
This class defines the available
Inputs.Model.INTAREAmodels for calculating the volumetric interfacial area, used by the two-fluid solver.Models:
DISPGAS2DISPLIQ — Transition from spherical bubbles to spherical droplets (Walter [2024])
- class InputEnums.EQSTROUHAL
EQSTROUHAL Enumeration of wave equilibrium Strouhal number models
This class defines the available
Inputs.Model.EQSTROUHALmodels for calculating the wave equilibrium Strouhal number, used by the four-field solver.Models:
RISO — Based on RISO dataset (Le Corre [2022])
SAWAI — Based on SAWAI dataset (Le Corre [2022])
MFVAL — MFVAL model (under development)
CUSTOM — Custom model using user-defined
Inputs.Model.EQSTROUHALCOEFCSTFRQ — Custom constant frequency using user-defined
Inputs.Model.CSTWAVEFREQ
- class InputEnums.MFBT
MFBT Enumeration of Minimum Film Boiling Transition (MFBT) models
This class defines the available
Inputs.Model.MFBTmodels for evaluating the Minimum Film Boiling Transition, used by the mixture field.Models:
NONE — No MFBT transition applied
CONSTANT — Constant deviation from the saturation temperature using user-defined
Inputs.Model.DTMFB
- class InputEnums.TPFM
TPFM Enumeration of two-phase wall friction multiplier models
This class defines the available
Inputs.Model.TPFMmodels for calculating the two-phase wall friction multiplier used by the mixture solver.Models:
HOMOGENEOUS — Assumes no slip between phases; both phases move at the same velocity
SLIP — Accounts for velocity differences (slip) between liquid and vapor phases using user-defined
Inputs.Model.SLIPEPRI — Empirical model developed by the Electric Power Research Institute (EPRI) (Reddy and others [1982])
- class InputEnums.MOMENTFILM
MOMENTFILM Enumeration of film momentum conservation models
This class defines the available
Inputs.Model.MOMENTFILMmodels for solving the momentum conservation equation for the liquid film, used to compute film velocity in the three-field solver.Models:
ALGEBRAIC — Simple algebraic model
EQUILIBRIUM — Equilibrium model
EQUILIBRIUMS — Simplified equilibrium model based on force balance (\(F_{\mathrm{wall}} + F_{\mathrm{vapor}} = 0\))
FULL — Full non-equilibrium momentum model (Le Corre et al. [2025])
- class InputEnums.ENTRAINMENT
ENTRAINMENT Enumeration of droplet entrainment models
This class defines the available
Inputs.Model.ENTRAINMENTmodels for calculating the droplet entrainment mass flux, used by the three-field and four-field solvers.NOTE: Entrainment and deposition correlations are coupled. It is recommended to use the same model for both entrainment and deposition mass flux to ensure consistency.
Models:
NONE — No entrainment
GOVAN — Hewitt and Govan correlation (Hewitt and Govan [1990])
OKAWA2003 — Okawa et al. correlation (Okawa et al. [2003])
OKAWA2004 — Okawa et al. correlation (Okawa et al. [2004])
OKAWA2004MOD — Modified Okawa (2004) model from (Adamsson and Le Corre [2011])
OKAWAGEN — Generic Okawa-based model using user-defined
Inputs.Model.OKAWACOEFS
- class InputEnums.MOMENTGAS
MOMENTGAS Enumeration of gas momentum conservation models
This class defines the available
Inputs.Model.MOMENTGASmodels for solving the momentum conservation equation for the gas phase, used to compute gas velocity in the two-fluid solver.Models:
MIXTURE — Uses the same gas velocity as in the mixture model
SLIP — Slip ratio model (gas/liquid velocity) using% user-defined
Inputs.Model.SLIPFULL — Full non-equilibrium momentum model (Le Corre et al. [2025], Walter [2024])
- class InputEnums.VOID
VOID Enumeration of void fraction models
This class defines the available
Inputs.Model.VOIDmodels to calculate the void fraction in the mixture solver.Models:
HOMOGENEOUS — Assumes vapor and liquid phases move at the same velocity.
SLIP — Assumes a slip ratio between vapor and liquid phases using user-defined
Inputs.Model.SLIP.BESTION — Drift-flux model developed by Bestion (Bestion [1990]).
EPRI — Drift-flux model developed by the Electric Power Research Institute (EPRI) (Lellouche and Zolotar [1982]).
- class InputEnums.OAFFILMSPLIT
OAFFILMSPLIT Enumeration of film mass flow ratio models at onset of annular flow
This class defines the available
Inputs.Model.OAFFILMSPLITmodels for splitting the base film and wave mass flow rates at the onset of annular flow, used by the four-field solver.Models:
RATIO — Ratio of base film to film mass flow rates using user-defined
Inputs.Model.OAFBASERATIOEQUILIBRIUM — Equilibrium model (film thickness = equilibrium film thickness) (Le Corre [2022])
- class InputEnums.MOMENTDROP
MOMENTDROP Enumeration of droplet momentum conservation models
This class defines the available
Inputs.Model.MOMENTDROPmodels for solving the droplet momentum conservation equation, used to compute droplet velocity in the three-field and four-field solvers.Models:
ALGEBRAIC — Simple algebraic model consistent with mixture solver
SLIP — Slip ratio model (droplet/gas velocity)
EQUILIBRIUM — Equilibrium model
EQUILIBRIUMS — Simplified equilibrium model based on force balance (\(F_{\mathrm{drag}} + F_{\mathrm{gravity}} + F_{\mathrm{buoyancy}} = 0\))
FULL — Full non-equilibrium momentum model (Le Corre et al. [2025])
- class InputEnums.INTLENGTH
INTLENGTH Enumeration of interfacial length scale models
This class defines the available
Inputs.Model.INTLENGTHmodels for calculating the interfacial length scale, used by the two-fluid solver.Models:
CONSTANT — Assumes a constant interfacial length scale using user-defined
Inputs.Model.INTLENGTHVCSTandInputs.Model.INTLENGTHLCSTfor the dispersed gas and liquid phases, respectively
- class InputEnums.WAVEFREQUENCY
WAVEFREQUENCY Enumeration of wave number density transport models
This class defines the available
Inputs.Model.WAVEFREQUENCYmodels for solving the wave number density (or wave frequency) transport equation, used in the four-field solver.Models:
EQUILIBRIUM — Assumes instantaneous equilibrium between wave generation and dissipation.
RELAXATION — Full transport model including time relaxation effects set by user-defined RELAXTW (Le Corre [2022])
- class InputEnums.INTTRANSH
INTTRANSH Enumeration of interfacial enthalpy transfer models
This class defines the available
Inputs.Model.INTTRANSHmodels for calculating the phase enthalpy associated with interfacial mass transfer, used by the mixture and two-fluid solvers.Models:
BULK — Uses bulk phase enthalpy
SATURATED — Uses saturated phase enthalpy
- class InputEnums.VAPORFRIC
VAPORFRIC Enumeration of vapor to film interfacial friction models
This class defines the available
Inputs.Model.VAPORFRICmodels for calculating the vapor-to-film interfacial friction coefficient used by the three-field and four-field solvers.Models:
CONSTANT — Uses a fixed, friction coefficient using user-defined
Inputs.Model.VAPORFRICCSTWALLIS — Wallis model based on void fraction (Wallis [1969]).
WALLISTHICK — Wallis model based on film thickness (Adamsson and Le Corre [2011], Equation 35).
SOLVER_DEPENDENT — Friction model determined by the solver configuration.
- class InputEnums.BTHTM
BTHTM Enumeration of post-boiling transition wall heat transfer models
This class defines the available
Inputs.Model.BTHTMmodels for calculating the post-boiling transition wall heat transfer, used by the mixture solver.Models:
VAPOR — Wall heat transfer to the vapor phase only, based on single-phase heat transfer model selected in
Inputs.Model.SPHTM
- class InputEnums.TPKM
TPKM Enumeration of two-phase local loss multiplier models
This class defines the available
Inputs.Model.TPKMmodels for calculating the two-phase local loss multiplier used by the mixture modelModels:
HOMOGENEOUS — Assumes no slip between phases; both phases move at the same velocity.
SLIP — Accounts for velocity differences (slip) between liquid and vapor phases using user-defined
Inputs.Model.SLIP.ROMIE — Romie model; behaves like the homogeneous model when a homogeneous void fraction model is applied.
- class InputEnums.DEPENHANCEMENT
DEPENHANCEMENT Enumeration of droplet deposition enhancement models
This class defines the available
Inputs.Model.DEPENHANCEMENTmodels for calculating local droplet deposition enhancement, used by the three-field and four-field solvers.Models:
NONE — No enhancement applied
WINDECKER — Model adapted from Windecker [1999], as documented in Le Corre [2024], using user defined
Inputs.Model.KTUNING
- class InputEnums.THERMALNONEQ
THERMALNONEQ Enumeration of thermal non-equilibrium models
This class defines the available
Inputs.Model.THERMALNONEQmodels for calculating phase thermal non-equilibrium effects, used by the mixture solver.Models:
- class InputEnums.FLUIDPROPERTIES
FLUIDPROPERTIES Enumeration of fluid property calculation assumptions
This class defines the available
Inputs.Model.PROPERTIESassumptions to calculate fluid properties, applicable to all solvers.Models:
SATURATED — Properties based on saturated conditions at system pressure
PSYSTEM — Properties based on system pressure and local phase enthalpy
- class InputEnums.MOMENTWAVE
MOMENTWAVE Enumeration of film momentum conservation models
This class defines the available
Inputs.Model.MOMENTWAVEmodels for solving the momentum conservation equation for the wave field, used to compute wave velocity in the four-field solver.Models:
- class InputEnums.MOMENTLIQUID
MOMENTLIQUID Enumeration of liquid momentum conservation models
This class defines the available
Inputs.Model.MOMENTLIQUIDmodels for solving the momentum conservation equation for the liquid phase, used to compute liquid velocity in the two-fluid solver.Models:
MIXTURE — Uses the same velocity as in the mixture model
SLIP — Slip ratio model (gas/liquid velocity) using user-defined
Inputs.Model.SLIPFULL — Full non-equilibrium momentum model (Le Corre et al. [2025], Walter [2024])
- class InputEnums.BASEEQTHICK
BASEEQTHICK Enumeration of base film equilibrium thickness models
This class defines the available
Inputs.Model.BASEEQTHICKmodels for calculating the equilibrium base film thickness, used by the four-field solver.Models:
RISO — Based on RISO dataset (Le Corre [2022])
COEFS — Generalized RISO model using user-defined
Inputs.Model.BASEEQTHICKCOEFYPLUS — Based on dimensionless wall distance (y+) using user-defined
Inputs.Model.BASEYPLUSMFVAL — MFVAL model (under development)
- class InputEnums.BTMTM
BTMTM Enumeration of post-boiling transition wall momentum transfer models
This class defines the available
Inputs.Model.BTMTMmodels for calculating the post-boiling transition wall momentum transfer, used by the mixture solver.Models:
TPFM — Wall momentum transfer based on two-phase friction multiplier, using multiplier selected in
Inputs.Model.TPFMVAPOR — Wall momentum transfer based on vapor phase only, using single-phase momentum transfer model selected in
Inputs.Model.SPMTM
- class InputEnums.CBT
CBT Enumeration of Critical Boiling Transition (CBT) models
This class defines the available
Inputs.Model.CBTmodels for evaluating the Critical Boiling Transition, used by the mixture field.Models:
- class InputEnums.TPHTM
TPHTM Enumeration of two-phase wall heat transfer models
This class defines the available
Inputs.Model.TPHTMmodels for calculating the two-phase wall heat transfer, used by the mixture solver.Models:
THOM — Thom wall heat transfer model (Rohsenow et al. [1998])
- class InputEnums.BUBBLEDRAG
BUBBLEDRAG Enumeration of bubble drag coefficient models
This class defines the available
Inputs.Model.BUBBLEDRAGmodels for calculating the bubble drag coefficient, used by the two-fluid solver.Models:
CONSTANT — Constant drag coefficient using user-defined
Inputs.Model.BUBBLEDRAGCOEFSTOKES — Stokes flow regime model (\(\frac{24}{Re_{p}}\))
VISCOUS — Viscous regime model (Walter [2024])
DISTORTED — Model for distorted bubbles (non-spherical) (Walter [2024])
- class InputEnums.SPHTM
SPHTM Enumeration of single-phase wall heat transfer models
This class defines the available
Inputs.Model.SPHTMmodels for calculating the single-phase wall heat transfer (liquid or gas), used by the mixture solver.Models:
DITTUSBOELTER — Dittus-Boelter wall heat transfer model for heating (\(\mathrm{Nu} = 0.023 \cdot \mathrm{Re}^{0.8} \cdot \mathrm{Pr}^{0.4}\)) (Dittus and Boelter [930], McAdams [1942])
DITTUSBOELTERGEN — Generalized Dittus-Boelter wall heat transfer model using user-defined
Inputs.Model.DITTUSBOELTERCOEF
- class InputEnums.DROPDRAG
DROPDRAG Enumeration of droplet drop drag coefficient models
This class defines the available
Inputs.Model.DROPDRAGmodels for calculating the droplet drag coefficient, used by the two-fluid solver.Models:
CONSTANT — Constant drag coefficient using user-defined
Inputs.Model.DROPDRAGCOEFSTOKES — Stokes flow regime model (\(\frac{24}{Re_{p}}\))
VISCOUS — Viscous regime model (Walter [2024])
DISTORTED — Model for distorted (non-spherical) droplets (Walter [2024])