Shifted Boundary Method Failure Analysis Report

Introduction

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

Dependencies

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

Framework Failure Analysis Report

Failure Analysis Requirements

The following is a complete list for all the requirements related to failure analysis for the Shifted Boundary Method module.

shifted_boundary_method: Distance Calc
18.2.2
The system shall throw an error
1. if ElementCentroidToSurfaceDistanceAux is applied to a nodal variable.
2. if ShortestDistanceToSurface receives a function whose type is not ParsedFunction or UnsignedDistanceToSurfaceMesh.
3. if the embedding mesh dimension does not match the SBM surface mesh dimension plus one.
4. if the SBM surface mesh contains element types other than EDGE2 or TRI3.
5. if the SBM surface mesh is distributed, since SBMSurfaceMeshBuilder requires a replicated mesh for its In-Out test.
6. if an UnsignedDistanceToSurfaceMesh function is paired with an SBMSurfaceMeshBuilder that was configured without a KDTree.
Specification(s): error_test/nodal_variable, error_test/unsupported_surface_function, error_test/dim_mismatch, error_test/unsupported_element_type, error_test/distributed_surface_mesh, error_test/unsigned_distance_without_kd_tree
Design: UnsignedDistanceToSurfaceMesh ShortestDistanceToSurface
Issue(s): #31937
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException


[nodal_variable]
  type = 'RunException'
  input = '2D_distance_refine.i'
  cli_args = 'AuxVariables/distance/order=FIRST AuxVariables/distance/family=LAGRANGE'
  expect_err = 'This AuxKernel only supports Elemental fields'
  mesh_mode = REPLICATED
  recover = false
  detail = 'if ElementCentroidToSurfaceDistanceAux is applied to a nodal variable.'
[]


[unsupported_surface_function]
  type = 'RunException'
  input = '2D_distance_refine.i'
  cli_args = 'Functions/const_fun/type=ConstantFunction Functions/const_fun/value=1.0 UserObjects/distance_to_surface/surfaces=const_fun'
  expect_err = 'SBM distance helpers only support ParsedFunction or UnsignedDistanceToSurfaceMesh'
  mesh_mode = REPLICATED
  recover = false
  detail = 'if ShortestDistanceToSurface receives a function whose type is not ParsedFunction or UnsignedDistanceToSurfaceMesh.'
[]


[dim_mismatch]
  type = 'RunException'
  input = '2D_distance_refine.i'
  cli_args = 'Mesh/boundary_mesh/file=quad_surface.msh'
  expect_err = 'does not match the expected mesh dimension'
  mesh_mode = REPLICATED
  recover = false
  detail = 'if the embedding mesh dimension does not match the SBM surface mesh dimension plus one.'
[]


[unsupported_element_type]
  type = 'RunException'
  input = '3D_distance_refine.i'
  cli_args = 'Mesh/boundary_mesh/file=quad_surface.msh'
  expect_err = 'Unsupported element type in SBMSurfaceMeshBuilder'
  mesh_mode = REPLICATED
  recover = false
  detail = 'if the SBM surface mesh contains element types other than EDGE2 or TRI3.'
[]


[distributed_surface_mesh]
  type = 'RunException'
  input = '2D_distance_refine.i'
  cli_args = 'Mesh/parallel_type=DISTRIBUTED'
  expect_err = 'mesh is distributed'
  recover = false
  detail = 'if the SBM surface mesh is distributed, since SBMSurfaceMeshBuilder requires a replicated mesh for its In-Out test.'
[]


[unsigned_distance_without_kd_tree]
  type = 'RunException'
  input = '2D_distance_refine.i'
  cli_args = 'UserObjects/TreeBuilder/build_kd_tree=false'
  expect_err = "requires SBMSurfaceMeshBuilder"
  mesh_mode = REPLICATED
  recover = false
  detail = 'if an UnsignedDistanceToSurfaceMesh function is paired with an SBMSurfaceMeshBuilder that was configured without a KDTree.'
[]

Introduction
Dependencies
Failure Analysis Requirements