Heat Transfer Failure Analysis Report

Introduction

The FAR for the Heat Transfer module describes the system functional and non-functional requirements that describe the expected interactions that the software shall provide.

Dependencies

The Heat Transfer module is developed using MOOSE and can itself be based on various MOOSE modules, as such the FAR for the Heat Transfer module is dependent upon the following documents.

Failure Analysis Requirements

The following is a complete list for all the requirements related to failure analysis for the Heat Transfer module.

heat_transfer: Gap Heat Transfer Htonly
7.13.17When the 'check_boundary_restricted' option is set to true, the AuxKernels set up by the ThermalContact system shall generate an error when multiple faces of an element are in one of the contact surfaces.
Specification(s): corner_wrap_err_check_true
Design: GapHeatTransfer
Issue(s): #23058
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
Prerequisite(s): 7.13.16
35
7.13.18If 'quadrature=false' the thermal contact system shall generate an error if the user also sets 'check_boundary_restricted=true'.
Specification(s): corner_wrap_err_quadrature
Design: GapHeatTransfer
Issue(s): #23058
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
Prerequisite(s): 7.13.17
35

heat_transfer: Gap Heat Transfer Mortar
7.14.22We shall be able to generate a meaningful error message if the user does not define the sphere origin when a spherical geometry has been chosen.
Specification(s): large_gap_heat_transfer_test_sphere_mortar_geometry_error
Design: Constraints System ModularGapConductanceConstraint
Issue(s): #13080 #19229
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35

heat_transfer: Gap Heat Transfer Mortar Action
7.15.6We shall be able to inform the user that he or she provided physics parameters for two ways of building gap heat transfer options and error out, to avoid having misleading input files.
Specification(s): modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action_existing_UOs_error
Design: Constraints System ModularGapConductanceConstraint Mortar Gap Heat Transfer Action
Issue(s): #13080 #19229 #20922
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.15.7We shall be able to inform the user that the mortar gap heat transfer action cannot internally build more than one conduction or more than one radiation user object.
Specification(s): modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action_too_many_uos
Design: Constraints System ModularGapConductanceConstraint Mortar Gap Heat Transfer Action
Issue(s): #13080 #19229 #20922
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35

heat_transfer: Generate Radiation Patch
7.17.4The system shall report an error when centroid partitioner is used but centroid_partitioner_direction is not provided.
Specification(s): generate_radiation_patch_centroid_error
Design: PatchSidesetGenerator
Issue(s): #14000
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
31

heat_transfer: Gray Lambert Radiator
7.18.1The system shall check consistency of boundary and emissivity entries.
Specification(s): inconsistent_bnd_eps
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.2The system shall check consistency of boundary and view factor entries.
Specification(s): inconsistent_bnd_view_factors
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.3The system shall check consistency of fixed_boundary_temperatures and fixed_temperature_boundary entries.
Specification(s): inconsistent_iso_temperature
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.4The system shall check consistency of boundary and fixed_temperature_boundary entries.
Specification(s): inconsistent_bnd_iso_bnd
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.5The system shall check consistency of boundary and adiabatic_boundary entries.
Specification(s): inconsistent_bnd_adiabatic_bnd
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.6The system shall check consistency of the view_factors entry shape.
Specification(s): incorrect_view_factor_shape
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.18.7The system shall check consistency of the view_factors entry norm.
Specification(s): bad_rowsum
Design: ConstantViewFactorSurfaceRadiation
Issue(s): #13918
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
8

heat_transfer: Heat Conduction
7.19.8The system shall throw an error if the gap conductance model is used with uniform mesh refinement
Specification(s): gap_conductivity_property_r1_error
Design: ThermalContactAction
Issue(s): #13043
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.19.15The system shall report an error if the number of alpha components does not match the number of T_infinity components.
Specification(s): not_enough_alpha
Design: CoupledConvectiveHeatFluxBC
Issue(s): #11631
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35
7.19.16The system shall report an error if the number of htc components does not match the number of T_infinity components.
Specification(s): not_enough_htc
Design: CoupledConvectiveHeatFluxBC
Issue(s): #11631
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35

heat_transfer: Sideset Heat Transfer
7.38.2The system shall throw an error if the specified boundary does not exist when using the DGDiffusion DGKernel.
Specification(s): 1D_gap_err
Design: SideSetHeatTransferKernel SideSetHeatTransferMaterial
Issue(s): #14519
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35

heat_transfer: Transient Heat
7.41.3The system shall use a lower temperature limit to compute the specific heat
Specification(s): transient_heat_t_limit
Design: HeatConductionTimeDerivative
Issue(s): #26647
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
35


[corner_wrap_err_check_true]
  prereq = corner_wrap
  type = RunException
  input = 'corner_wrap.i'
  cli_args = ThermalContact/thermal_contact/check_boundary_restricted=true
  requirement = "When the 'check_boundary_restricted' option is set to true, the AuxKernels set up by the ThermalContact system shall generate an error when multiple faces of an element are in one of the contact surfaces."
  expect_err = "Boundary restricted auxiliary kernel 'gap_value_thermal_contact_0' has element "
  design = 'source/bcs/GapHeatTransfer.md'
  issues = '#23058'
[]


[corner_wrap_err_quadrature]
  prereq = corner_wrap_err_check_true
  type = RunException
  input = 'corner_wrap.i'
  cli_args = ThermalContact/thermal_contact/quadrature=false
  requirement = "If 'quadrature=false' the thermal contact system shall generate an error if the user also sets 'check_boundary_restricted=true'."
  expect_err = "This parameter cannot be 'false' when 'quadrature=false'"
  design = 'source/bcs/GapHeatTransfer.md'
  issues = '#23058'
[]


[large_gap_heat_transfer_test_sphere_mortar_geometry_error]
  type = RunException
  input = 'large_gap_heat_transfer_test_sphere_mortar_error.i'
  expect_err = 'gap_geometry_type = SPHERE'
  requirement = "We shall be able to generate a meaningful error message if the user does not define the sphere origin when a spherical geometry has been chosen."
[]


[modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action_existing_UOs_error]
  type = RunException
  input = 'modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action_existing_UOs.i'
  cli_args = "MortarGapHeatTransfer/mortar_heat_transfer/primary_emissivity=1.0"
  expect_err = 'The mortar gap heat transfer action requires that the input file defines user objects'
  requirement = 'We shall be able to inform the user that he or she provided physics parameters for two ways of building gap heat transfer options and error out, to avoid having misleading input files.'
[]


[modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action_too_many_uos]
  type = RunException
  input = 'modular_gap_heat_transfer_mortar_displaced_radiation_conduction_action.i'
  cli_args = "MortarGapHeatTransfer/mortar_heat_transfer/gap_flux_options='CONDUCTION RADIATION CONDUCTION'"
  expect_err = 'You cannot choose to have more than one conduction or more than one radiation user'
  requirement = 'We shall be able to inform the user that the mortar gap heat transfer action cannot internally build more than one conduction or more than one radiation user object.'
[]


[./generate_radiation_patch_centroid_error]
  type = RunException
  input = 'generate_radiation_patch.i'
  expect_err = "If using the centroid partitioner you _must_ specify centroid_partitioner_direction!"
  requirement = "The system shall report an error when centroid partitioner is used but centroid_partitioner_direction is not provided."
  design = 'source/meshgenerators/PatchSidesetGenerator.md'
  cli_args = 'Mesh/patch/partitioner=centroid --mesh-only generate_radiation_patch_centroid.e'
  mesh_mode = REPLICATED
  issues = "#14000"
  recover = false
[../]


[./inconsistent_bnd_eps]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/emissivity="1"'
  expect_err = 'The number of entries must match the number of boundary entries.'
  requirement = 'The system shall check consistency of boundary and emissivity entries.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./inconsistent_bnd_view_factors]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/boundary="top bottom"
                UserObjects/gray_lambert/adiabatic_boundary="bottom"
                UserObjects/gray_lambert/fixed_temperature_boundary="top"
                UserObjects/gray_lambert/fixed_boundary_temperatures="550"
                UserObjects/gray_lambert/emissivity="1 1"'
  expect_err = 'Leading dimension of view_factors must be equal to number of side sets.'
  requirement = 'The system shall check consistency of boundary and view factor entries.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./inconsistent_iso_temperature]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/boundary="top bottom"
                UserObjects/gray_lambert/fixed_temperature_boundary="top"
                UserObjects/gray_lambert/emissivity="1 1"
                UserObjects/gray_lambert/view_factors="0.5 0.5 ; 0.5 0.5"'
  expect_err = 'fixed_boundary_temperatures and fixed_temperature_boundary must have the same length.'
  requirement = 'The system shall check consistency of fixed_boundary_temperatures and fixed_temperature_boundary entries.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./inconsistent_bnd_iso_bnd]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/boundary="top bottom"
                UserObjects/gray_lambert/fixed_temperature_boundary="right"
                UserObjects/gray_lambert/fixed_boundary_temperatures="300"
                UserObjects/gray_lambert/emissivity="1 1"
                UserObjects/gray_lambert/view_factors="0.5 0.5 ; 0.5 0.5"'
  expect_err = 'fixed_temperature_boundary must be a subset of boundary.'
  requirement = 'The system shall check consistency of boundary and fixed_temperature_boundary entries.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./inconsistent_bnd_adiabatic_bnd]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/boundary="top bottom"
                UserObjects/gray_lambert/fixed_temperature_boundary="top"
                UserObjects/gray_lambert/fixed_boundary_temperatures="300"
                UserObjects/gray_lambert/emissivity="1 1"
                UserObjects/gray_lambert/view_factors="0.5 0.5 ; 0.5 0.5"'
  expect_err = 'adiabatic_boundary must be a subset of boundary.'
  requirement = 'The system shall check consistency of boundary and adiabatic_boundary entries.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./incorrect_view_factor_shape]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/view_factors="0.25 0.25 0.25 0.25; 0.5 0.5 ; 1 1 1 1; 1 1 1 1"'
  expect_err = 'view_factors must be provided as square array. Row 1 has 2 entries.'
  requirement = 'The system shall check consistency of the view_factors entry shape.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./bad_rowsum]
  type = 'RunException'
  input = 'gray_lambert_cavity.i'
  cli_args = 'UserObjects/gray_lambert/view_factors="0.25 0.25 0.25 0.25; 0.2 0.25 0.25 0.25 ; 0.25 0.25 0.25 0.25; 0.25 0.25 0.25 0.25"'
  expect_err = 'view_factors row 1 sums to 0.95.'
  compiler = '!GCC'
  requirement = 'The system shall check consistency of the view_factors entry norm.'
  design = 'ConstantViewFactorSurfaceRadiation.md'
[../]


[./gap_conductivity_property_r1_error]
  type = RunException
  input = 'gap_conductivity_property.i'
  cli_args = 'Mesh/uniform_refine=1'
  expect_err = 'GapConductance does not work with uniform mesh refinement.'
  requirement = "The system shall throw an error if the gap conductance model is used
                   with uniform mesh refinement"
  design = "/actions/ThermalContactAction.md"
  issues = "#13043"
[../]


[./not_enough_alpha]
  type = RunException
  input = 'coupled_convective_heat_flux_two_phase.i'
  cli_args = "BCs/right/alpha='alpha_liquid'"
  expect_err = '\(BCs/right/alpha\).*?The number of coupled components does not match the number of `T_infinity` components.'
  requirement = 'The system shall report an error if the number of `alpha` components does not match the number of `T_infinity` components.'
[../]


[./not_enough_htc]
  type = RunException
  input = 'coupled_convective_heat_flux_two_phase.i'
  cli_args = "BCs/right/htc='Hw_liquid'"
  expect_err = '\(BCs/right/htc\).*?The number of coupled components does not match the number of `T_infinity` components.'
  requirement = 'The system shall report an error if the number of `htc` components does not match the number of `T_infinity` components.'
[../]


[./1D_gap_err]
  type = RunException
  input = 'gap_thermal_1D.i'
  cli_args = 'DGKernels/dg_diff/exclude_boundary="fake_interface another_fake last_one"'
  expect_err = "DGKernel 'dg_diff' contains the following boundary names that do not exist on the mesh: fake_interface, another_fake, last_one"
  requirement = 'The system shall throw an error if the specified boundary does not exist when using the DGDiffusion DGKernel.'
[../]


[transient_heat_t_limit]
  type = 'RunException'
  input = 'transient_heat_derivatives.i'
  expect_err = 'is below min_T'
  cli_args = 'Materials/constant/min_T=10'
  requirement = 'The system shall use a lower temperature limit to compute the specific heat'
  issues = '#26647'
  design = 'HeatConductionTimeDerivative.md'
[]

Introduction
Dependencies
Failure Analysis Requirements