Thermal Hydraulics Failure Analysis Report
Introduction
The Failure Analysis Report (FAR) for the Thermal Hydraulics module describes the system functional and non-functional requirements that describe the expected interactions that the software shall provide.
Dependencies
The Thermal Hydraulics module is developed using MOOSE and can itself be based on various MOOSE modules, as such the FAR for the Thermal Hydraulics module is dependent upon the following documents.
- Framework Failure Analysis Report
- Fluid Properties Failure Analysis Report
- Heat Conduction Failure Analysis Report
- Navier Stokes Failure Analysis Report
- Misc Failure Analysis Report
- Ray Tracing Failure Analysis Report
- Reconstructed Discontinuous Galerkin Failure Analysis Report
- Solid Properties Failure Analysis Report
Failure Analysis Requirements
The following is a complete list for all the requirements related to failure analysis for the Thermal Hydraulics module.
- thermal_hydraulics: Actions
- 21.1.2The system shall report an error for the coupled heat transfer action if the mesh is not aligned with the x, y, or z axis.
Specification(s): misaligned
Design: CoupledHeatTransferAction
Issue(s): #21818
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Closures
- 21.4.2
Specification(s): enumeration_option
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.4.3
Specification(s): err:missing_f_1phase
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.4.4
Specification(s): enumeration_option
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Components
- 21.5.1
Specification(s): err:nonexisting_component
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.2
Specification(s): err:setup_status
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.3The system shall report an error if the FreeBoundary component is used.
Specification(s): free_boundary
Design: FreeBoundary
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.4The system shall report an error if the GateValve component is used.
Specification(s): gate_valve
Design: GateValve
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.5The system shall report an error if the SolidWall component is used.
Specification(s): solid_wall
Design: SolidWall
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.6The system shall report an error if the JunctionOneToOne component is used.
Specification(s): junction_one_to_one
Design: JunctionOneToOne
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.7The system shall report an error if the HeatGeneration component is used.
Specification(s): heat_generation
Design: HeatGeneration
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.8The system shall report an error if the HeatSourceVolumetric component is used.
Specification(s): heat_source_volumetric
Design: HeatSourceVolumetric
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.9The system shall report an error if the PrescribedReactorPower component is used.
Specification(s): prescribed_reactor_power
Design: PrescribedReactorPower
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.13The system shall report an error for FileMeshComponent when the file is not readable.
Specification(s): file_not_readable
Design: FileMeshComponent
Issue(s): #22354
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.17
Specification(s): err:wrong_fp
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.21
Specification(s): err:connecting_to_non_existent_component
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.22
Specification(s): err:old_connection_format
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.23
Specification(s): err:incorrect_connection_format
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.32
Specification(s): err:not_2_connections
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.33
Specification(s): err:not_parallel
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.34
Specification(s): warn:slope_reconstruction_used
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.35
Specification(s): err:2nd_order
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.38
Specification(s): err:no_hs
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.39
Specification(s): err:wrong_block_name
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.45
Specification(s): err:no_hs
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.46
Specification(s): err:wrong_block_name
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.47
Specification(s): err:wrong_power_comp
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.49
Specification(s): err:nonexistent_flow_channel
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.50
Specification(s): err:not_a_flow_channel
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.54The system shall report an error for HeatStructure2DCoupler when
- the provided heat structure boundary does not exist.
- the types of the coupled heat structures do not match.
- the types of either coupled heat structure is invalid.
- the boundary meshes are not aligned.
Specification(s): error_reporting/missing_boundary, error_reporting/type_mismatch, error_reporting/invalid_hs_type, error_reporting/mesh_mismatch
Design: HeatStructure2DCoupler
Issue(s): #19851
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.56The system shall report an error for HeatStructure2DRadiationCouplerRZ when
- the provided heat structure boundary does not exist.
- the type of either coupled heat structure is invalid.
- the boundary meshes are not aligned.
Specification(s): error_reporting/missing_boundary, error_reporting/invalid_hs_type, error_reporting/mesh_not_aligned
Design: HeatStructure2DRadiationCouplerRZ
Issue(s): #21688
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.63
Specification(s): err:missing_axial_regions_parameter
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.64
Specification(s): err:incorrect_size_axial_regions_parameter
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.65
Specification(s): err:no_2nd_order_with_trap
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.66
Specification(s): err:no_T_ic
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.67
Specification(s): err:incorrect_size_of_n_part_elems
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.68
Specification(s): err:incorrect_size_of_widths
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.69
Specification(s): err:incorrect_size_of_materials
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.73
Specification(s): err:2d_mesh
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.76
Specification(s): err:mixed_heat_modes
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.91The system shall throw an error if the flow channel component is not of type 'FlowChannelBase'.
Specification(s): err:not_a_pipe
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.92The system shall throw an error if the heat structure component is not of type 'HeatStructureBase'.
Specification(s): err:not_a_hs
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.93The system shall throw an error if the provided heat structure side is invalid.
Specification(s): err:wrong_hs_side
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.94The system shall throw an error if the heat structure and flow channel components don't have the same number of axial elements.
Specification(s): err:elems_mismatch
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.95The system shall throw an error if the heat structure and flow channel components don't have the same length.
Specification(s): err:length_mismatch
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.96The system shall throw an error if the center of the elements of the flow channel component don't align with the centers of the specified heat structure side.
Specification(s): err:wrong_position
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.97The system shall throw an error if the coupled flow channel and heat structure components don't have the same orientation.
Specification(s): err:wrong_orientation
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.98The system shall throw an error if the flow channel is coupled to the inner side of a heat structure that has a zero inner radius.
Specification(s): err:zero_p_hs_radius
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.99The system shall throw an error if the heat transfer coefficient is not specified with simple closures.
Specification(s): err:missing_hw
Design: HeatTransferFromHeatStructure1Phase
Issue(s): #19754
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.107The system shall throw an error if a flow channel connected to a HeatTransferFromHeatStructure3D1Phase component is not a FlowChannel1Phase.
Specification(s): err:not_a_pipe
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.108The system shall throw an error if a flow channel connected to a HeatTransferFromHeatStructure3D1Phase component is not aligned with the x-, y-, or z- axis.
Specification(s): err:fch_orientation
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.109The system shall throw an error if the heat structure connected to a HeatTransferFromHeatStructure3D1Phase component is not a HeatStructureFromFile3D component.
Specification(s): err:not_3d_hs
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.110The system shall throw an error if the heat structure boundary connected to a HeatTransferFromHeatStructure3D1Phase component doesn't exist.
Specification(s): err:non_existent_boundary
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.111The system shall throw an error if the flow channels connected to a HeatTransferFromHeatStructure3D1Phase component are not aligned with the same axis.
Specification(s): err:differently_aligned_channels
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.112The system shall throw an error if the flow channels connected to a HeatTransferFromHeatStructure3D1Phase component don't have the same lnumber of elements.
Specification(s): err:different_n_elems
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.113The system shall throw an error if the flow channels connected to a HeatTransferFromHeatStructure3D1Phase component don't have the same length.
Specification(s): err:different_lengths
Design: HeatTransferFromHeatStructure3D1Phase
Issue(s): #19831
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.118
Specification(s): err:no_phf
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.130
Specification(s): err:no_bnd
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.140
Specification(s): phy:h_rhou_3eqn
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.159
Specification(s): err.missing_ics
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.160
Specification(s): err.non_parallel_channels
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.174
Specification(s): err:no_connected_components
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.179The system shall throw an error if ShaftConnectedCompressor1Phase is not connected to a shaft component.
Specification(s): err:not_connected_to_shaft
Design: ShaftConnectedCompressor1Phase
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.180The system shall throw an error if the initial shaft speed is not provided and the application is not restarting.
Specification(s): err:no_initial_speed
Design: ShaftConnectedMotor
Issue(s): #19833
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.181The system shall throw an error if ShaftConnectedMotor is not connected to a shaft component.
Specification(s): err:not_connected_to_shaft
Design: ShaftConnectedMotor
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.190The system shall throw an error if ShaftConnectedPump1Phase is not connected to a shaft component.
Specification(s): err:not_connected_to_shaft
Design: ShaftConnectedPump1Phase
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.196The system shall throw an error if ShaftConnectedTurbine1Phase is not connected to a shaft component.
Specification(s): err:not_connected_to_shaft
Design: ShaftConnectedTurbine1Phase
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.203The system shall report an error if the SupersonicInlet component is used.
Specification(s): not_implemented
Design: SupersonicInlet
Issue(s): #20383
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.209The system shall throw an error if initial conditions for the VolumeJunction1Phase component are missing.
Specification(s): err.missing_ics
Design: VolumeJunction1Phase
Issue(s): #19771
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.5.210The system shall throw an error if the parameter "A_ref" is specifed and the paramter "K" is not specified.
Specification(s): err.missing_K
Design: VolumeJunction1Phase
Issue(s): #19771
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Controls
- 21.6.3
Specification(s): err.negative_tau
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.6.5
Specification(s): non_existent_control_data
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.6.14
Specification(s): throw_error
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.6.19The system shall report an error when an unit trip condition does not evaluate as boolean value.
Specification(s): err:not_boolean
Design: UnitTripControl
Issue(s): #619
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Functions
- 21.7.2
Specification(s): error_inconsistent_number_of_points
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.7.3
Specification(s): error_points_nonascending_order
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.7.4
Specification(s): error_self_reference
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Interfaces
- 21.8.5The system shall report an error for the discrete line segment interface
- if an invalid axial coordinate is provided.
Specification(s): error_reporting/compute_axial_coordinate_invalid_axial_coord
Design: DiscreteLineSegmentInterface
Issue(s): #21818
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Materials
- 21.10.3
Specification(s): ad_err.n_hw_sources
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.10.4
Specification(s): ad_err.n_phf_sources
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.10.16
Specification(s): err.n_hw_sources
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.10.17
Specification(s): err.n_phf_sources
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Misc
- 21.11.7The system shall report an error when a block is non found in the restart ExodusII file
Specification(s): non_existent_block
Design: SolutionIC
Issue(s): #20526
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
Prerequisite(s): 21.11.521.11.821.11.1021.11.1221.11.1421.11.1621.11.18
- thermal_hydraulics: Postprocessors
- 21.13.4The system should report an error when users set subdomain-restricted RZ-symmtrical THM-specific objects on RZ-subdomains.
Specification(s): err:rz_domain
Design: RZSymmetry
Issue(s): #215
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.13.6The system should error out when users set boundary-restricted RZ-symmtrical THM-specific objects on RZ-subdomains.
Specification(s): err:rz_domain
Design: RZSymmetry
Issue(s): #215
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 21.13.19
Specification(s): non_existent_par_name
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- thermal_hydraulics: Vectorpostprocessors
- 21.18.3The system shall report an error if a non-existent material property is requested for the block material property sampler vector post-processor.
Specification(s): error_on_nonexistent_matprop
Design: Sampler1DReal
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException