Fluid Properties Requirements Traceability Matrix
This template follows INL template TEM-214, "IT System Requirements Traceability Matrix."
This document serves as an addendum to Framework Requirements Traceability Matrix and captures information for Requirement Traceability Matrix (RTM) specific to the Fluid Properties module.
Introduction
Minimum System Requirements
In general, the following is required for MOOSE-based development:
A POSIX compliant Unix-like operating system. This includes any modern Linux-based operating system (e.g., Ubuntu, Fedora, Rocky, etc.), or a Macintosh machine running either of the last two MacOS releases.
| Hardware | Information |
|---|---|
| CPU Architecture | x86_64, ARM (Apple Silicon) |
| Memory | 8 GB (16 GBs for debug compilation) |
| Disk Space | 30GB |
| Libraries | Version / Information |
|---|---|
| GCC | 9.0.0 - 13.3.1 |
| LLVM/Clang | 14.0.6 - 19 |
| Intel (ICC/ICX) | Not supported at this time |
| Python | 3.10 - 3.13 |
| Python Packages | packaging pyaml jinja2 |
System Purpose
The MOOSE Fluid Properties module provides uniform interfaces to numerous physical properties of fluids and a library of fluid objects based on these interfaces. This module is intended to be used by a variety of MOOSE-based applications involving the simulation of fluid flow.
System Scope
The scope of the Fluid Properties module includes properties of both liquids and gases, as well as two-phase liquid-vapor properties. Additionally, the module includes some generic capability for defining a fluid's equation of state from user-defined functions or tabular data from files.
Assumptions and Dependencies
The Fluid Properties module is developed using MOOSE and can itself be based on various MOOSE modules, as such the RTM for the Fluid Properties module is dependent upon the files listed at the beginning of this document.
Pre-test Instructions/Environment/Setup
Ideally all testing should be performed on a clean test machine following one of the supported configurations setup by the test system engineer. Testing may be performed on local workstations and cluster systems containing supported operating systems.
The repository should be clean prior to building and testing. When using "git" this can be done by doing a force clean in the main repository and each one of the submodules:
git clean -xfd
git submodule foreach 'git clean -xfd'
All tests must pass in accordance with the type of test being performed. This list can be found in the Software Test Plan.
Changelog Issue Revisions
Errors in changelog references can sometimes occur as a result of typos or conversion errors. If any need to be noted by the development team, they will be noted here.
The changelog for all code residing in the MOOSE repository is located in the MOOSE RTM.
System Requirements Traceability
Functional Requirements
- fluid_properties: Auxkernels
- 6.1.1The system shall compute specific enthalpy from pressure and temperature
Specification(s): specific_enthalpy_aux
Design: SpecificEnthalpyAux
Issue(s): #19225
Collection(s): FUNCTIONAL
Type(s): Exodiff
- 6.1.2The system shall compute stagnation pressure from specific volume, specific internal energy, and velocit
Specification(s): stagnation_pressure_aux
Design: StagnationPressureAux
Issue(s): #19225
Collection(s): FUNCTIONAL
Type(s): Exodiff
- 6.1.3The system shall compute stagnation temperature from specific volume, specific internal energy, and velocity
Specification(s): stagnation_temperature_aux
Design: StagnationTemperatureAux
Issue(s): #19225
Collection(s): FUNCTIONAL
Type(s): Exodiff
- 6.1.4The system shall compute fluid density from pressure and temperature.
Specification(s): fluid_density_aux
Design: FluidDensityAux
Issue(s): #17546
Collection(s): FUNCTIONAL
Type(s): Exodiff
- fluid_properties: Brine
- 6.2.1The system shall compute properties of brine
Specification(s): brine
Design: BrineFluidProperties
Issue(s): #6972
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.2.2The system shall compute properties of brine using tabulated water properties
Specification(s): brine_tabulated
Design: BrineFluidProperties
Collection(s): FUNCTIONAL
Type(s): CSVDiff
Prerequisite(s): 6.2.1
- fluid_properties: Calorically Imperfect Gas
- 6.3.1The system shall compute properties for a calorically imperfect but otherwise ideal gas
Specification(s): calorically_imperfect_gas
Design: CaloricallyImperfectGas
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): Exodiff
- fluid_properties: Co2
- 6.4.1The system shall be able to compute fluid properties for carbon dioxide in a gaseous phase.
Specification(s): co2
Design: CO2FluidProperties
Issue(s): #6972
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: External Submodules
- 6.5.1fluid properties from an external submodule for
- spline-based table-lookup air fluid properties,
- vapor carbon dioxide fluid properties,
- spline-based table-lookup Helium fluid properties,
- spline-based table-lookup Nitrogen fluid properties,
- liquid Potassium fluid properties,
- liquid Sodium fluid properties.
Specification(s): fps/air_pT, fps/CO2_pT, fps/helium_pT, fps/nitrogen_pT, fps/potassium_pT, fps/sodium_pT
Design: External Fluid Properties Submodules
Issue(s): #27097
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Fluid Properties
- 6.6.1The system shall report an error if non-ideal gases are used with the ideal gas mixture model.
Specification(s): error_nonideal_gases
Design: IdealGasMixtureFluidProperties
Issue(s): #28335
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Fp Interrogator
- 6.7.1The fluid properties interrogator shall output static-state fluid properties for (p, T) input.
Specification(s): 1ph.p_T
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.2The fluid properties interrogator shall output static-state fluid properties for (p, T) input in JSON format.
Specification(s): 1ph.p_T.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.3The fluid properties interrogator shall output static-state fluid properties for (rho, e) input.
Specification(s): 1ph.rho_e
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.4The fluid properties interrogator shall output static-state fluid properties for (rho, e) input in JSON format.
Specification(s): 1ph.rho_e.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.5The fluid properties interrogator shall output static-state fluid properties for (rho, p) input.
Specification(s): 1ph.rho_p
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.6The fluid properties interrogator shall output static-state fluid properties for (rho, p) input in JSON format.
Specification(s): 1ph.rho_p.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.7The fluid properties interrogator shall output static-state and stagnation-state fluid properties for (rho, rhou, rhoE) input with a single-phase fluid properties object.
Specification(s): 1ph.rho_rhou_rhoE
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.8The fluid properties interrogator shall output static-state and stagnation-state fluid properties for (rho, rhou, rhoE) input with a single-phase fluid properties object in JSON format.
Specification(s): 1ph.rho_rhou_rhoE.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.9The fluid properties interrogator shall output two-phase and static-state, single-phase fluid properties for (p, T) input with a two-phase fluid properties object.
Specification(s): 2ph.p_T
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.10The fluid properties interrogator shall output two-phase and static-state, single-phase fluid properties for (p, T) input with a two-phase fluid properties object in JSON format.
Specification(s): 2ph.p_T.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.11The fluid properties interrogator shall output two-phase and static-state, single-phase fluid properties for (p, T) input with a two-phase NCG fluid properties object when the NCG mass fraction is provided.
Specification(s): 2ph_ncg_p_T
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.12The fluid properties interrogator shall output two-phase and static-state, single-phase fluid properties for (p, T) input with a two-phase NCG fluid properties object when the NCG mass fraction is not provided.
Specification(s): 2ph_ncg_partial_pressure_p_T
Design: FluidPropertiesInterrogator
Issue(s): #28335
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.13The fluid properties interrogator shall output two-phase and static-state, single-phase fluid properties for (p, T) input with a two-phase NCG fluid properties object in JSON format.
Specification(s): 2ph_ncg_p_T.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.14The fluid properties interrogator shall output static-state, single-phase fluid properties for (rho, e) input with a vapor mixture fluid properties object.
Specification(s): vapor_mixture_rho_e
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.15The fluid properties interrogator shall output static-state, single-phase fluid properties for (rho, e) input with a vapor mixture fluid properties object in JSON format.
Specification(s): vapor_mixture_rho_e.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.16The fluid properties interrogator shall output two-phase fluid properties for (p) input with a two-phase fluid properties object.
Specification(s): 2ph_p
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.17The fluid properties interrogator shall output two-phase fluid properties for (p) input with a two-phase fluid properties object in JSON format.
Specification(s): 2ph_p.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.18The fluid properties interrogator shall output two-phase fluid properties for (T) input with a two-phase fluid properties object.
Specification(s): 2ph_T
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.19The fluid properties interrogator shall output two-phase fluid properties for (T) input with a two-phase fluid properties object in JSON format.
Specification(s): 2ph_T.json
Design: FluidPropertiesInterrogator
Issue(s): #13741
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.7.20The fluid properties interrogator shall throw an error if an incompatible fluid properties object is supplied.
Specification(s): err.wrong_fp_type
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.7.21The fluid properties interrogator shall throw an error if an extraneous parameter(s) are supplied.
Specification(s): err.extraneous_parameter
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.7.22The fluid properties interrogator shall throw an error if an no valid input sets were supplied.
Specification(s): err.no_params
Design: FluidPropertiesInterrogator
Issue(s): #12995
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Functions
- 6.8.1The system shall provide a function to compute the hydrostatic pressure distribution.
Specification(s): test
Design: HydrostaticPressureFunction
Issue(s): #31843
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.8.2The system shall provide a function that computes saturation density from a temperature function
- for the liquid phase
- for the vapor phase
Specification(s): test/liquid, test/vapor
Design: SaturationDensityFunction
Issue(s): #21256
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.8.3The system shall provide a function that computes saturation pressure from a temperature function
Specification(s): test
Design: SaturationPressureFunction
Issue(s): #14755
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.8.4The system shall provide a function that computes saturation temperature from a pressure function
Specification(s): test
Design: SaturationTemperatureFunction
Issue(s): #14755
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Ics
- 6.9.1The system shall be able to set an initial condition for density given pressure and temperature as variables
Specification(s): test
Design: RhoFromPressureTemperatureIC
Issue(s): #15524
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.9.2The system shall be able to set an initial condition for density of vapor mixture given pressure and temperature as variables
Specification(s): test
Design: RhoVaporMixtureFromPressureTemperatureIC
Issue(s): #15524
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.9.3The system shall be able to set an initial condition for specific enthalpy given pressure and temperature as variables
Specification(s): test
Design: SpecificEnthalpyFromPressureTemperatureIC
Issue(s): #15561
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Ideal Gas
- 6.10.1The system shall be able to compute the fluid properties of an ideal gas with the specific energy and volume variables.
Specification(s): conservative
Design: IdealGasFluidProperties
Collection(s): FUNCTIONAL
Type(s): Exodiff
- 6.10.2The system shall be able to compute the fluid properties of an ideal gas with the pressure and temperature variables.
Specification(s): primitive
Design: IdealGasFluidProperties
Collection(s): FUNCTIONAL
Type(s): Exodiff
- fluid_properties: Interfaces
- 6.11.1The system should produce a warning when a scalar NaN is produced and user required that the execution would not terminate
Specification(s): quiet_nan_scalar
Design: NaNInterface
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.11.2The system should produce a warning when a vector NaN is produced and user required that the execution would not terminate
Specification(s): quiet_nan_vector
Design: NaNInterface
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.11.3The system should report an error when a NaN is produced by a computation in DEBUG mode, by default
Specification(s): signaling_nan_dbg
Design: NaNInterface
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.11.4The system should not report an error when a NaN is produced by a computation in OPT mode, by default
Specification(s): signaling_nan_opt
Design: NaNInterface
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.11.5The system should be able to return a warning when a fluid property evaluation encounters a NaN.
Specification(s): signaling_nan_warning
Design: NaNInterface
Collection(s): FUNCTIONAL
Type(s): RunApp
- 6.11.6The system should be able to throw an exception when a fluid property evaluation encounters a NaN.
Specification(s): signaling_nan_exception
Design: NaNInterface
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Materials
- 6.12.1The system shall provide an AD material that computes saturation temperature.
Specification(s): test
Design: ADSaturationTemperatureMaterial
Issue(s): #15308
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.12.2The system shall provide an AD material that computes surface tension.
Specification(s): test
Design: ADSurfaceTensionMaterial
Issue(s): #15308
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.12.3The system shall be able to compute material properties from fluid properties
- using a (pressure, temperature) variable set
- using a (pressure, enthalpy) variable set
- using a (specific volume, specific internal energy) variable set
Specification(s): fp_material/pressure_temperature, fp_material/pressure_enthalpy, fp_material/volume_energy
Design: FluidPropertiesMaterialVEFluidPropertiesMaterialPT
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): Exodiff
- 6.12.4The system shall provide a material that computes saturation pressure using automatic differentiation material properties.
Specification(s): ad
Design: SaturationPressureMaterial
Issue(s): #15860
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.12.5The system shall provide a material that computes saturation pressure using non-automatic differentiation material properties.
Specification(s): nonad
Design: SaturationPressureMaterial
Issue(s): #15860
Collection(s): FUNCTIONAL
Type(s): CSVDiff
Prerequisite(s): 6.12.4
- fluid_properties: Methane
- 6.13.1The system shall be able to compute fluid properties for methane in a gaseous phase.
Specification(s): methane
Design: MethaneFluidProperties
Collection(s): FUNCTIONAL
Type(s): Exodiff
- fluid_properties: Saline
- 6.14.1The system shall be able to leverage the Saline submodule to compute composed salt fluid properties
Specification(s): test
Design: SalineMoltenSaltFluidProperties
Issue(s): #22724
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Sodium
- 6.15.1The system shall be able to compute liquid sodium properties and compare exactly to analytical expressions.
Specification(s): exact
Design: Sodium Fluid PropertiesSodium Properties Material
Issue(s): #14798
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.15.2The system shall be able to compute liquid sodium properties given constant thermal conductivity and specific heat values.
Specification(s): constant
Design: Sodium Fluid PropertiesSodium Properties Material
Issue(s): #14798
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Stiffened Gas
- 6.16.1The system shall be able to compute fluid properties with a stiffened gas model using a conservative variable set.
Specification(s): test
Design: StiffenedGasFluidProperties
Collection(s): FUNCTIONAL
Type(s): Exodiff
- fluid_properties: Tabulated
- 6.17.1The system shall be able to generate a tabulation of fluid properties based on pressure and temperature, and use a tabulated interplation of these properties.
Specification(s): tabulated_bicubic
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.17.2The system shall be able to read a tabulation of fluid properties, then compute these fluid properties using (volume, energy) primary variables
- using a regularly spaced interpolation grid
- using a log-spaced specific volume grid and a regularly spaced grid in specific internal energy
- using a linear specific volume grid and a log-spaced grid in specific internal energy
Specification(s): tabulated_v_e_bicubic_from_pT/regular_grids, tabulated_v_e_bicubic_from_pT/log_v, tabulated_v_e_bicubic_from_pT/log_e
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): CSVDiff
Prerequisite(s): 6.17.1
- 6.17.3The system shall be able to output tabulated fluid property data when requested by the user
- for the (pressure, temperature) interpolation grids.
- for the (specific volume, internal energy) conversion grids.
Specification(s): file_writing/pT, file_writing/ve
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): CSVDiff
Prerequisite(s): 6.17.1
- 6.17.4The system shall be able to read a tabulation of fluid properties with a (specific volume, specific internal energy) grid and use this tabulation directly.
Specification(s): tabulated_v_e_bicubic_direct
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONAL
Type(s): CSVDiff
Prerequisite(s): 6.17.3
- 6.17.5The system shall throw an error if
- if the user-specified pressure boundaries are inverted
- if the user-specified temperature boundaries are inverted
- if the user-specified pressure initial guess for variable set inversions is out of bounds
- if the user-specified temperature initial guess for variable set inversions is out of bounds
- if the user only specified one bound for a range of specific internal energy,
- if the user only specified one bound for a range of specific volume.
Specification(s): exceptions/bad_pressure_bounds, exceptions/bad_temperature_bounds, exceptions/bad_pressure_guess, exceptions/bad_temperature_guess, exceptions/missing_energy_bound, exceptions/missing_specific_volume_bound
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- 6.17.6The system shall be able to
- error if the desired pressure for a fluid property evaluation is outside the user-specified bounds, when prescribed to error in such conditions
- error if the desired temperature for a fluid property evaluation is outside the user-specified bounds, when prescribed to error in such conditions
- declare the solution invalid if the desired pressure for a fluid property evaluation is outside the user-specified bounds, when prescribed to do so in such conditions
- declare the solution invalid if the desired temperature for a fluid property evaluation is outside the user-specified bounds, when prescribed to do so in such conditions
- count the number of occurrences if the desired pressure for a fluid property evaluation is outside the user-specified bounds, when prescribed to do so in such conditions,
- count the number of occurrences if the desired temperature for a fluid property evaluation is outside the user-specified bounds, when prescribed to do so in such conditions,
- ignore if the desired pressure for a fluid property evaluation is outside the user-specified bounds, when prescribed to ignore in such conditions
- ignore if the desired temperature for a fluid property evaluation is outside the user-specified bounds, when prescribed to ignore in such conditions
Specification(s): out_of_bounds/error_pressure_out_of_bounds, out_of_bounds/error_temperature_out_of_bounds, out_of_bounds/invalid_pressure_out_of_bounds, out_of_bounds/invalid_temperature_out_of_bounds, out_of_bounds/warn_pressure_out_of_bounds, out_of_bounds/warn_temperature_out_of_bounds, out_of_bounds/ignore_pressure_out_of_bounds, out_of_bounds/ignore_temperature_out_of_bounds
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunAppRunException
- 6.17.7The system shall return a warning if
- the user specifies a grid size when reading the interpolation grid from file,
- the user specifies a grid extent when reading the interpolation grid from file,
- the user specifies that the grid is logarithmic when reading the interpolation grid from file.
Specification(s): warnings/num_grids_ve, warnings/min_max_ve, warnings/log_ve
Design: TabulatedFluidProperties
Issue(s): #20101
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Temperature Pressure Function
- 6.18.1The system shall be able to compute functionalized fluid properties.
Specification(s): exact
Design: TemperaturePressureFunctionFluidProperties
Issue(s): #21505
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.18.2The system shall be able to compute fluid properties defined through functions of pressure and temperature.
Specification(s): example
Design: TemperaturePressureFunctionFluidProperties
Issue(s): #21505
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Two Phase Fluid Properties Independent
- 6.19.1The system shall be able to mix two independent single-phase fluid properties to form a basic two-phase model.
Specification(s): test
Design: TwoPhaseFluidPropertiesIndependent
Issue(s): #11641
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.19.2The system shall be able to not error on unimplemented two-phase fluid properties routines if the user requested so.
Specification(s): no_error_on_unimplemented
Design: TwoPhaseFluidPropertiesIndependent
Issue(s): #11641
Collection(s): FUNCTIONAL
Type(s): RunApp
Prerequisite(s): 6.19.1
- 6.19.3The system shall report an error if 2-phase property interfaces are called on a class designed to handle two single-phase fluid properties.
Specification(s): error:error_on_unimplemented
Design: TwoPhaseFluidPropertiesIndependent
Issue(s): #11641
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Two Phase Ncg Partial Pressure
- 6.20.1The system shall be able to compute properties from a two-phase with non-condensable gas user object.
Specification(s): test
Design: TwoPhaseNCGPartialPressureFunction
Issue(s): #28335
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- 6.20.2The system shall report an error if an incorrect number of arguments are provided when computing properties from a two-phase with non-condensable gas user object.
Specification(s): error_wrong_number_of_args
Design: TwoPhaseNCGPartialPressureFunction
Issue(s): #28335
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
- fluid_properties: Water
- 6.21.1The system shall be able to compute the fluid properties of water and steam following the IAPWS-IF97 formulations.
Specification(s): water
Design: Water97FluidProperties
Collection(s): FUNCTIONAL
Type(s): CSVDiff
- fluid_properties: Brinefluidpropertiestest.Unit Tests
- 6.22.1The system shall include the pressure and temperature derivatives of the water density and enthalpy in the brine density and enthalpy computed with forward-mode automatic differentiation, regardless of which brine property methods were called before.
Specification(s): ad_derivatives_after_value_call
Design: BrineFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Co2Fluidpropertiestest.Unit Tests
- 6.23.1The system shall compute derivatives of the CO2 density, internal energy and enthalpy with respect to pressure and temperature, and an isobaric heat capacity equal to the temperature derivative of the enthalpy, near the critical point where the nonanalytic terms of the Span and Wagner equation of state are significant.
Specification(s): derivatives_near_critical
Design: CO2FluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Caloricallyimperfectgastest.Unit Tests
- 6.24.1The system shall compute the derivatives of the speed of sound of a calorically imperfect gas with respect to specific volume and internal energy when the specific heat ratio varies with temperature.
Specification(s): sound_speed_varying_gamma
Design: CaloricallyImperfectGas
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.24.2The system shall evaluate the temperature and entropy of a calorically imperfect gas at the bounds of its tabulated temperature range, and return values clamped to those bounds outside of it when out-of-bounds errors are disabled.
Specification(s): lookup_table_bounds
Design: CaloricallyImperfectGas
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.24.3The system shall compute finite derivatives of the pressure from enthalpy and entropy of a calorically imperfect gas at zero entropy, and of its isobaric heat capacity and viscosity at the maximum tabulated temperature.
Specification(s): derivatives_at_edge_states
Design: CaloricallyImperfectGas
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Hydrogenfluidpropertiestest.Unit Tests
- 6.25.1The system shall compute derivatives of the hydrogen density, internal energy and enthalpy with respect to pressure and temperature, and an isobaric heat capacity equal to the temperature derivative of the enthalpy, near the critical point.
Specification(s): derivatives_near_critical
Design: HydrogenFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Idealgasfluidpropertiestest.Unit Tests
- 6.26.1The system shall compute the Gibbs free energy of an ideal gas consistently with its enthalpy and entropy, including a nonzero reference internal energy.
Specification(s): gibbs_free_energy
Design: IdealGasFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.26.2The system shall return a finite speed of sound and finite derivatives of it for an ideal gas state with negative temperature, consistently between the methods with and without derivatives.
Specification(s): sound_speed_nonphysical_state
Design: IdealGasFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Idealgasmixturefluidpropertiestest.Unit Tests
- 6.27.1The system shall compute the derivatives of the temperature and pressure from the specific volume and internal energy, of the internal energy from the pressure and density, and of the sound speed from the pressure and temperature of an ideal gas mixture with respect to their arguments and the mass fractions with automatic differentiation, in agreement with finite differences.
Specification(s): ad_derivatives
Design: IdealGasMixtureFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.27.2The system shall continue to compute the specific heat ratio of an ideal gas mixture without pressure and temperature arguments when all components have constant specific heats, and shall report an error when a component has temperature-dependent specific heats.
Specification(s): deprecated_specific_heat_ratio
Design: IdealGasMixtureFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.27.3The system shall compute the derivatives of the temperature and pressure from the specific volume and internal energy, of the internal energy from the pressure and density, and of the sound speed from the pressure and temperature of a mixture of ideal gases from NASA 7-coefficient polynomials with respect to their arguments and the mass fractions with automatic differentiation, in agreement with finite differences.
Specification(s): nasa7_ad_derivatives
Design: IdealGasMixtureFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.27.4The system shall compute the density, specific internal energy, isobaric and isochoric specific heats, and sound speed of a mixture of ideal gases from NASA 7-coefficient polynomials, reproducing Cantera values, and the temperature and pressure from its specific volume and internal energy.
Specification(s): nasa7_cantera
Design: IdealGasMixtureFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.27.5The system shall compute the temperature of mixtures of ideal gases from NASA 7-coefficient polynomials, alone or with an ideal gas of constant specific heats, from their specific volume and internal energy, from half the highest lower end to 1.5 times the lowest upper end of the temperature ranges of the data of their components, and where the internal energy is close to zero.
Specification(s): nasa7_inversion
Design: IdealGasMixtureFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Idealrealgasmixturefluidpropertiestest.Unit Tests
- 6.28.1The system shall compute the isobaric heat capacity of an ideal-real gas mixture whose primary component enthalpy depends on specific volume.
Specification(s): cp_volume_dependent_enthalpy
Design: IdealRealGasMixtureFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.28.2The system shall compute the same viscosity and thermal conductivity of an ideal-real gas mixture with and without derivatives when a secondary component internal energy depends on specific volume.
Specification(s): transport_volume_dependent_secondary
Design: IdealRealGasMixtureFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.28.3The system shall compute derivatives of the pressure, internal energy and entropy of an ideal-real gas mixture of three components with respect to temperature, specific volume and the secondary mass fractions.
Specification(s): three_components
Design: IdealRealGasMixtureFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Methanefluidpropertiestest.Unit Tests
- 6.29.1The system shall compute derivatives of the methane density, internal energy and enthalpy with respect to pressure and temperature, and an isobaric heat capacity equal to the temperature derivative of the enthalpy, near the critical point where the Gaussian terms of the Setzmann and Wagner equation of state are significant.
Specification(s): derivatives_near_critical
Design: MethaneFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Nasa7Idealgasfluidpropertiestest.Unit Tests
- 6.30.1The system shall compute the density, specific internal energy, specific enthalpy, specific entropy, isobaric and isochoric specific heats, and sound speed of an ideal gas from NASA 7-coefficient polynomials, reproducing Cantera values below and above the temperature where the two polynomials meet and at a pressure other than the reference pressure.
Specification(s): cantera
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.2The system shall compute the same state of an ideal gas from NASA 7-coefficient polynomials with the (pressure, temperature), (temperature, specific volume), and (pressure, density) variable sets, and satisfy the definition of enthalpy, the Mayer relation, the ideal-gas sound speed, and the relations between the temperature and pressure derivatives of enthalpy, internal energy, and entropy and the specific heats and specific volume.
Specification(s): consistency
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.3The system shall compute the derivatives of the properties of an ideal gas from NASA 7-coefficient polynomials with respect to their arguments, with real and automatic differentiation arguments, in agreement with finite differences.
Specification(s): derivatives
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.4The system shall extrapolate NASA 7-coefficient polynomials outside the temperature range of their data and count each such evaluation, including the evaluation of a temperature found by inverting the internal energy, as a solution warning, and shall flag a non-positive or not-a-number temperature as an invalid solution.
Specification(s): out_of_range
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.5The system shall compute the temperature of an ideal gas from NASA 7-coefficient polynomials from its specific volume and internal energy and from its pressure and enthalpy by Newton iteration, together with the properties that depend on these variable sets, consistently with the properties from pressure and temperature, and within the mismatch of the two polynomials at the temperature where they meet.
Specification(s): inverses
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.6The system shall compute the temperature of an ideal gas from NASA 7-coefficient polynomials whose specific internal energy, which includes the enthalpy of formation, is close to zero.
Specification(s): energy_near_zero
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.7The system shall compute the temperature of each built-in NASA 7-coefficient ideal gas from its specific internal energy and from its specific enthalpy from half the lower end to 1.5 times the upper end of the temperature range of its data.
Specification(s): inverse_range
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.30.8The system shall compute the derivatives of the properties of an ideal gas from NASA 7-coefficient polynomials from the (specific volume, internal energy), (pressure, enthalpy), (enthalpy, entropy), and (specific volume, enthalpy) variable sets, with real and automatic differentiation arguments, in agreement with finite differences.
Specification(s): inverse_derivatives
Design: NASA7IdealGasFluidProperties
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Nasa7Polynomialstest.Unit Tests
- 6.31.1The system shall evaluate the standard-state heat capacity, enthalpy, and entropy of H2, O2, H2O, CH4, CO, CO2, and N2 from the GRI-Mech 3.0 NASA 7-coefficient polynomials, reproducing the values computed by Cantera
- below the temperature where the low- and high-temperature polynomials meet,
- at that temperature, where the low-temperature polynomial applies, and
- above that temperature.
Specification(s): cantera/below_midpoint, cantera/at_midpoint, cantera/above_midpoint
Design: Utilities for the Fluid Properties Module
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.31.2The system shall provide the molar masses of the built-in NASA 7-coefficient species, matching the values Cantera computes for GRI-Mech 3.0.
Specification(s): molar_mass
Design: Utilities for the Fluid Properties Module
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.31.3The system shall compute NASA 7-coefficient enthalpies and entropies whose temperature derivatives, obtained by automatic differentiation, equal the heat capacity and the heat capacity divided by temperature, respectively.
Specification(s): consistent_derivatives
Design: Utilities for the Fluid Properties Module
Issue(s): #34116
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Naclfluidpropertiestest.Unit Tests
- 6.32.1The system shall compute the isochoric heat capacity of halite from its isobaric heat capacity, thermal expansion coefficient and isothermal compressibility.
Specification(s): cv
Design: NaClFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Simplefluidpropertiestest.Unit Tests
- 6.33.1The system shall compute derivatives of the internal energy of a simple fluid with respect to pressure and density when the product of the thermal expansion coefficient and the bulk modulus is small.
Specification(s): energy_derivatives_low_expansion_modulus_product
Design: SimpleFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Stiffenedgastwophasefluidpropertiestest.Unit Tests
- 6.34.1The system shall use the latent heat of fusion of water as the default latent heat of fusion of the two-phase stiffened gas fluid properties.
Specification(s): default_latent_heat_of_fusion
Design: StiffenedGasTwoPhaseFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Tabulatedbicubicfluidpropertiestest.Unit Tests
- 6.35.1The system shall compute the Gibbs free energy from a tabulation in specific volume and internal energy that does not interpolate temperature.
Specification(s): gibbs_without_temperature_column
Design: TabulatedBicubicFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.35.2The system shall replace NaN pressures and temperatures from the inversion of tabulated properties in specific volume and internal energy with a bound of the tabulated range at every specific volume, including the midpoint of the specific volume range.
Specification(s): check_nans_midpoint
Design: TabulatedBicubicFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- fluid_properties: Temperaturepressurefunctionfluidpropertiestest.Unit Tests
- 6.36.1The system shall compute isobaric and isochoric heat capacities from temperature and pressure functions that satisfy cp - cv = T alpha^2 / (rho kappa_T), with alpha the thermal expansion coefficient and kappa_T the isothermal compressibility.
Specification(s): heat_capacity_difference
Design: TemperaturePressureFunctionFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest
- 6.36.2The system shall compute finite derivatives of the heat capacities and internal energy defined from temperature and pressure functions at zero pressure and zero internal energy.
Specification(s): derivatives_at_zero_arguments
Design: TemperaturePressureFunctionFluidProperties
Issue(s): #34070
Collection(s): FUNCTIONAL
Type(s): GoogleTest