Shifted Boundary Method Failure Analysis Report
Introduction
The Failure Analysis Report (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.
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.2The system shall throw an error
- if ElementCentroidToSurfaceDistanceAux is applied to a nodal variable.
- if ShortestDistanceToSurface receives a function whose type is not ParsedFunction, UnsignedDistanceToSurfaceMesh, or SignedDistanceToSurfaceMesh.
- if the embedding mesh dimension does not match the SBM surface mesh dimension plus one.
- if the SBM surface mesh contains element types other than EDGE2 or TRI3.
- if the SBM surface mesh is distributed, since SBMSurfaceMeshBuilder requires a replicated mesh for its In-Out test.
- if an UnsignedDistanceToSurfaceMesh function is paired with an SBMSurfaceMeshBuilder that was configured without a KDTree.
- if an UnsignedDistanceToSurfaceMesh function has neither a surface builder nor an interface manager.
- if an UnsignedDistanceToSurfaceMesh function has both a surface builder and an interface manager.
- if manager mode does not identify both subdomains forming the interface.
- if interface subdomain IDs are supplied in surface-builder mode.
- if manager mode identifies an interface using the same subdomain twice.
- if a signed distance is requested from a function that is neither a ParsedFunction nor a SignedDistanceToSurfaceMesh.
- if SignedDistanceToSurfaceMesh receives an in-out test user object that does not implement the point-in-surface check interface.
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, error_test/missing_source, error_test/ambiguous_source, error_test/manager_missing_ids, error_test/builder_with_ids, error_test/manager_same_ids, error_test/signed_distance_invalid_strategy, error_test/signed_distance_in_out_test_wrong_type
Design: UnsignedDistanceToSurfaceMeshSignedDistanceToSurfaceMeshShortestDistanceToSurface
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- shifted_boundary_method: Grain Boundary Case
- 18.3.7The system shall throw an error
- if the maximum k-d tree leaf size is nonpositive.
- if a saved surface mesh is not provided for each shifted cohesive zone boundary.
- if one saved surface mesh is reused for multiple shifted cohesive zone boundaries.
- if one explicit subdomain pair is not provided for each surrogate boundary.
- if an explicit interface entry does not contain two subdomain IDs.
- if the two subdomain IDs in an explicit interface entry are not distinct.
- if explicit and automatically generated distance sources are both specified.
- if an explicit subdomain pair is absent from the detected complete interface.
- if partially overlapping interface faces are found in a nonconformal complete interface mesh.
Specification(s): error_tests/invalid_leaf_max_size, error_tests/surface_mesh_count_mismatch, error_tests/duplicate_surface_mesh, error_tests/complete_interface_pair_count, error_tests/complete_interface_pair_size, error_tests/complete_interface_distinct_pair, error_tests/ambiguous_distance_source, error_tests/unknown_manager_pair, error_tests/nonconformal_interface
Design: Grain Boundary Shifted Cohesive Zone Test
Issue(s): #33666
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- shifted_boundary_method: In Out Test
- 18.4.3The system shall reject an InterceptedElementModifier lambda outside the inclusive range from zero to one.
Specification(s): invalid_lambda
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.4The system shall reject a non-positive tolerance for the point-in-polyhedron in-out test.
Specification(s): zero_tolerance
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.8The system shall reject an explicit lambda threshold when intercepted elements are assigned a dedicated subdomain ID.
Specification(s): mark_intercepted_with_lambda
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.15The system shall report an error when mark_intercepted is enabled without specifying the intercepted subdomain ID.
Specification(s): mark_intercepted_missing_id
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.16The system shall report an error when an InterceptedElementModifier is configured with neither an in-out test user object nor a signed distance function.
Specification(s): no_in_out_test
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.17The system shall report an error when an InterceptedElementModifier receives an in-out test user object that does not implement the point-in-surface check interface.
Specification(s): in_out_test_wrong_type
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.4.18The system shall report an error when an InterceptedElementModifier is configured with both an in-out test user object and a signed distance function.
Specification(s): both_geometry_sources
Design: InterceptedElementModifierPointInPolyhedronCheckUOSBMSurfaceMeshBuilder
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- shifted_boundary_method: Shifted Cohesive Zone
- 18.5.19The system shall throw an error
- if a custom constitutive-tangent property has no explicit mathematical definition.
- if explicit tangent-property configuration is used with automatic differentiation enabled.
- if an explicit constitutive-tangent definition is used with automatic differentiation enabled.
Specification(s): tangent_error_tests/custom_tangent_requires_definition, tangent_error_tests/ad_tangent_rejected, tangent_error_tests/ad_tangent_definition_rejected
Design: Shifted Cohesive Zone Physics System
Issue(s): #33666
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.5.21The system shall throw an error
- if explicitly specified volumetric locking correction settings differ between shifted cohesive zone and solid mechanics Physics blocks.
- if unsupported finite-strain cohesive zone kinematics are requested.
- if surface meshes are supplied when automatic distance generation is disabled.
- if the number of shifted cohesive zone displacement variables does not match the mesh dimension.
- if surface watertightness checks are enabled when automatic distance generation is disabled.
- if an interface matching tolerance is supplied without a complete interface mesh.
- if interface subdomain pairs are supplied without a complete interface mesh.
Specification(s): action_error_tests/volumetric_locking_mismatch, action_error_tests/finite_strain_rejected, action_error_tests/surface_meshes_without_generation, action_error_tests/displacement_dimension_mismatch, action_error_tests/watertightness_without_generation, action_error_tests/matching_tolerance_without_complete_mesh, action_error_tests/subdomain_pairs_without_complete_mesh
Design: Shifted Cohesive Zone Physics System
Issue(s): #33666
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- 18.5.22The system shall report an error or warning
- if neither a surface function nor an interface manager is provided as the source of boundary distance data.
- if both surface-function and interface-manager sources of boundary distance data are provided.
- if interface subdomain pairs are provided when boundary distances come from surface functions instead of an interface manager.
- if a boundary is assigned more than once in a boundary distance user object.
- if one surface function is not provided for each configured surrogate boundary.
- if shifted cohesive zone evaluation requests distance data for a boundary on which distance data were not computed.
- if a computed boundary distance exceeds the estimated element scale.
Specification(s): distance_error_tests/distance_source_missing, distance_error_tests/distance_source_ambiguous, distance_error_tests/subdomain_pairs_without_manager, distance_error_tests/duplicate_distance_boundary, distance_error_tests/surface_boundary_count_mismatch, distance_error_tests/missing_distance_data, distance_error_tests/large_distance_warning
Design: Shifted Cohesive Zone Physics System
Issue(s): #33666
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException
- shifted_boundary_method: Subdomain Element Modifier
- 18.6.5The system shall throw an error
- if the SurfaceMeshBySubdomainBuilder surface mesh is distributed, since it requires a replicated mesh for its In-Out test.
- if the embedding mesh dimension does not match the surface mesh dimension plus one.
- if the SurfaceMeshBySubdomainBuilder surface mesh contains element types other than EDGE2 or TRI3.
- if the fixed_x_ray method is requested for PointInSubdomainCheckUO, which performs per-subdomain ray-casting and cannot use the whole-mesh TriangleManifold engine.
- if a point is contained in more than one subdomain of a PointInSubdomainCheckUO surface mesh, since a single-subdomain query is then ambiguous.
Specification(s): error_test/distributed_surface_mesh, error_test/dim_mismatch, error_test/unsupported_element_type, error_test/fixed_x_ray_unsupported, error_test/ambiguous_subdomain
Design: SubdomainElementModifierSurfaceMeshBySubdomainBuilderPointInSubdomainCheckUO
Issue(s): #33397
Collection(s): FAILURE_ANALYSISFUNCTIONAL
Type(s): RunException