Xfem System Requirement Specification

Introduction

The SRS for Xfem describes the system functional and non-functional requirements that describe the expected interactions that the software shall provide.

Dependencies

The Xfem application is developed using MOOSE and is based on various modules, as such the SRS for Xfem is dependent upon the following documents.

Requirements

The following is a complete list for all the functional requirements for Xfem.

  • xfem: Bimaterials
  • F9.1.1The XFEM module shall have the capability to calculate mechanical response in two glued, layered materials with the interface location and material properties applied to on each side of the boundary determined by a level set function.
  • F9.1.2The XFEM module shall have the capability to calculate mechanical response in a composite material matrix with an inclusion with the location of the inclusion boundary and material properties applied to the matrix and inclusion determined by a prescribed level set function.
  • xfem: Corner Nodes Cut
  • F9.2.1The XFEM module shall have the capability of cutting directly through multiple nodes of a single QUAD4 element in 2D using deprecated SolidMechanics methods.
  • F9.2.2The XFEM module shall be able to perform mesh cuts on any combination of the edges of elements and through elements including allowing cuts that go through the nodes on the same mesh using deprecated SolidMechanics methods.
  • F9.2.3The XFEM module shall have the capability of perfoming mesh cuts on the edges of elements such that only two new nodes are generated to separate the previously connected elements using deprecated SolidMechanics methods.
  • F9.2.4The XFEM module shall be capable of propagating an existing crack front along a prescribed cut in 2D deprecated SolidMechanics methods.
  • F9.2.5The XFEM module shall have the capability of cutting directly through multiple nodes of a single QUAD4 element in 2D.
  • F9.2.6The XFEM module shall be able to perform mesh cuts on any combination of the edges of elements and through elements including allowing cuts that go through the nodes on the same mesh.
  • F9.2.7The XFEM module shall have the capability of perfoming mesh cuts on the edges of elements such that only two new nodes are generated to separate the previously connected elements.
  • F9.2.8The XFEM module shall be capable of propagating an existing crack front along a prescribed cut in 2D.
  • xfem: Crack Tip Enrichment
  • F9.3.1The XFEM module shall have the capability to include near-tip enrichment functions in 2D mechanics simulations.
  • F9.3.2The XFEM module shall have the capability to include near-tip enrichment functions in 3D mechanics simulations.
  • xfem: Diffusion Xfem
  • F9.4.1The XFEM Module shall have the capability to run 2D diffusion problems with prescribed values on the domain boundary (Dirichlet conditions) with a fixed position discontinuous interface through mesh elements.
  • F9.4.2The XFEM Module shall have the capability to run 2D diffusion problems with prescribed solution values on the domain boundary (Dirichlet conditions) and prescribed boundary flux values (Neumann conditions) with a fixed position discontinuous interface defined by a geometric cut user object.
  • F9.4.3The XFEM Module shall have the capability to run 2D diffusion problems with a fixed position discontinuous interface defined by the location of the zero values of a level set function with the level set variable being a Moose Variable.
  • F9.4.4The XFEM Module shall have the capability to run 2D diffusion problems with a fixed position discontinuous interface defined by the location of the zero values of a prescribed level set function with the level set variable being a Moose AuxVariable.
  • F9.4.5The XFEM Module shall have the capability to run 3D diffusion problems with a fixed position discontinuous interface defined by the location of the zero values of a prescribed level set function with the level set variable being a Moose AuxVariable.
  • xfem: Init Solution Propagation
  • F9.5.1The XFEM module shall retain the values of auxiliary variables on child nodes and elements after running the cutting algorithm, and initialize solution variables on newly created nodes with values from parent nodes in parallel using deprecated SolidMechanics methods.
  • F9.5.2The XFEM module shall retain the values of auxiliary variables on child nodes and elements after running the cutting algorithm, and initialize solution variables on newly created nodes with values from parent nodes in parallel
  • xfem: Mechanical Constraint
  • F9.6.1The XFEM module shall permit applying a glued constraint across the XFEM interface for 2D solid mechanics problems.
  • xfem: Moment Fitting
  • F9.7.1The XFEM module shall permit the use of the moment fitting algorithm to compute integration point weights for partial elements on 2D solid mechanics problems using deprecated SolidMechanics methods.
  • F9.7.2The XFEM module shall permit the use of the moment fitting algorithm to compute integration point weights for partial elements on 2D solid mechanics problems
  • F9.7.3The XFEM module shall permit the use of the moment fitting algorithm to compute integration point weights for partial elements on 2D problems with a 4-point integration rule
  • F9.7.4The XFEM module shall permit the use of the moment fitting algorithm to compute integration point weights for partial elements on 2D problems with a 6-point integration rule
  • xfem: Moving Interface
  • F9.8.1The XFEM module shall provide an ability to specify whether an XFEM cut surface should be healed independently for individual interfaces
  • F9.8.2The XFEM module shall not output summary information on mesh changes when debug_output_level=0
  • F9.8.3The XFEM module shall output summary information on mesh changes when debug_output_level=1
  • F9.8.4The XFEM module shall output detailed information on mesh changes when debug_output_level=2
  • F9.8.5The XFEM module shall output detailed information on mesh changes when debug_output_level=3
  • F9.8.6The XFEM module shall provide an ability to solve bi-material mechanics problems where a moving material interface is defined by an XFEM surface, which is defined by a prescribed level set field.
  • F9.8.7The XFEM module shall provide an ability to solve bi-material diffusion problems where a moving material interface is defined by an XFEM surface, which is defined by a prescribed level set field.
  • F9.8.8The XFEM module shall provide an ability to solve a simple phase transition problem in which the phase boundary is defined by and XFEM surface and the interface velocity depends on the jump of variables and gradients across the interface.
  • F9.8.9The XFEM module shall accurately solve 1D, xy problems with homogeneous material properties with a moving interface determined by a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.10The XFEM module shall accurately solve 1D, xy problems with material properties and a moving interface dependent on a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.11The XFEM module shall accurately solve 1D, xy problems with a moving interface separating two discrete materials prescribed by a user defined level set function with problem results verified using the Method of Manufactured Solutions.
  • F9.8.12The XFEM module shall accurately solve 1D, rz problems with homogeneous material properties with a moving interface determined by a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.13The XFEM module shall accurately solve 1D, rz problems with material properties and a moving interface dependent on a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.14The XFEM module shall accurately solve 2D, xy problems with homogeneous material properties with a moving interface determined by a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.15The XFEM module shall accurately solve 2D, xy problems with material properties and a moving interface dependent on a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.16The XFEM module shall accurately solve 2D, rz problems with homogeneous material properties with a moving interface determined by a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • F9.8.17The XFEM module shall accurately solve 2D, rz problems with material properties and a moving interface dependent on a user prescribed level set function, and problem results are verified using the Method of Manufactured Solutions.
  • xfem: Pressure Bc
  • F9.9.1The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D using deprecated SolidMechanics methods.
  • F9.9.2The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 3D using deprecated SolidMechanics methods.
  • F9.9.3The XFEM module shall permit application of pressure boundary conditions to inclined XFEM cut surfaces in 2D using deprecated SolidMechanics methods.
  • F9.9.4The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D finite deformation simulations using deprecated SolidMechanics methods.
  • F9.9.5The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D
  • F9.9.6The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 3D
  • F9.9.7The XFEM module shall permit application of pressure boundary conditions to inclined XFEM cut surfaces in 2D
  • F9.9.8The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D finite deformation simulations
  • xfem: Second Order Elements
  • F9.10.1The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD8 elements using deprecated SolidMechanics methods.
  • F9.10.2The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD9 elements using deprecated SolidMechanics methods.
  • F9.10.3The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using TRI6 elements using deprecated SolidMechanics methods.
  • F9.10.4The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using TRI6 elements.
  • F9.10.5The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using QUAD8 elements.
  • F9.10.6The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using QUAD9 elements.
  • F9.10.7The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using QUAD9 elements when the XFEM cutting plane is prescribed using a level set field.
  • F9.10.8The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 3D using TET10 elements when the XFEM cutting plane is prescribed using a level set field.
  • F9.10.9The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 3D using HEX20 elements when the XFEM cutting plane is prescribed using a level set field.
  • F9.10.10The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 3D using HEX27 elements when the XFEM cutting plane is prescribed using a level set field.
  • F9.10.11The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD8 elements.
  • F9.10.12The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD9 elements.
  • F9.10.13The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using TRI6 elements.
  • xfem: Side Integral
  • F9.11.1The XFEM module shall properly integrate quantities on sides of cut elements that are intersected by the cutting plane in 2D
  • F9.11.2The XFEM module shall properly integrate quantities on sides of cut elements that are intersected by the cutting plane in 3D
  • xfem: Single Var Constraint 2D
  • F9.12.1The XFEM module shall provide an ability to apply a zero-jump, zero-flux-jump constraint across a propagating XFEM interface for one variable.
  • F9.12.2The XFEM module shall provide an ability to apply a zero-jump, zero-flux-jump constraint across a propagating XFEM interface for one variable in a problem with another variable that does not have a constraint across that interface.
  • F9.12.3The XFEM module shall provide an ability to apply zero-jump, zero-flux-jump constraints across a propagating XFEM interface for two variables.
  • F9.12.4The XFEM module shall provide an ability to apply a zero-jump, zero-flux-jump constraint on a stationary interface for one variable.
  • F9.12.5The XFEM module shall provide an ability to apply a zero-jump, nonzero-flux-jump (defined by a Real value) constraint on a stationary interface for one variable.
  • F9.12.6The XFEM module shall provide an ability to apply a zero-jump, nonzero-flux-jump (defined by a function) constraint on a stationary interface for one variable.
  • F9.12.7The XFEM module shall provide an ability to apply a nonzero-jump (defined by a Real value), zero-flux-jump constraint on a stationary interface for one variable.
  • F9.12.8The XFEM module shall provide an ability to apply a nonzero-jump (defined by a function), zero-flux-jump constraint on a stationary interface for one variable.
  • F9.12.9The XFEM module shall provide an ability to apply a nonzero-jump, nonzero-flux-jump constraint on a stationary interface for one variable.
  • F9.12.10The XFEM module shall provide an ability to apply a two-sided equal value constraint on a stationary interface for one variable.
  • xfem: Single Var Constraint 3D
  • F9.13.1The XFEM module shall provide an ability to apply a zero-jump, zero-flux-jump constraint across a stationary XFEM interface for one variable in 3D.
  • F9.13.2The XFEM module shall provide an ability to apply a zero-jump, nonzero-flux-jump constraint across a stationary XFEM interface for one variable in 3D.
  • F9.13.3The XFEM module shall provide an ability to apply a nonzero-jump, zero-flux-jump constraint across a stationary XFEM interface for one variable in 3D.
  • F9.13.4The XFEM module shall provide an ability to apply a nonzero-jump, nonzero-flux-jump constraint across a stationary XFEM interface for one variable in 3D.
  • xfem: Solid Mechanics Basic
  • F9.14.1The XFEM module shall represent a propagating crack in a 2D mechanics problem in which crack growth occurs when the average stress in the element at the crack tip exceeds a critical value using the deprecated SolidMechanics system.
  • F9.14.2The XFEM module shall permit definition of a stationary crack in a 3D mechanics model with XFEM, where the crack is defined using a rectangular cutting plane by RectangleCutUserObject using the deprecated SolidMechanics system.
  • F9.14.3The XFEM module shall represent a propagating crack in a 3D mechanics model with XFEM, where the crack is defined using a topologically surface cutting mesh by MeshCut3DUserObject using the deprecated SolidMechanics system.
  • F9.14.4The XFEM module shall permit definition of a stationary crack in a 3D mechanics model with XFEM, where the crack is defined using an elliptical cutting plane by EllipseCutUserObject using the deprecated SolidMechanics system.
  • F9.14.5MeshCut3DUserObject shall increase the size of the XFEM cutting surface that it defines for a stationary crack in a 3D model at any point in time by adding additional elements around the periphery of the cutting mesh over time using the deprecated SolidMechanics system.
  • F9.14.6The XFEM system shall permit computation of fracture domain integrals in 3D mechanics problems where a stationary embedded circular crack is defined by a cutting plane geometry and points along the crack front for the domain integral are explicitly specified using the deprecated SolidMechanics system.
  • F9.14.7The XFEM system shall permit computation of fracture domain integrals in 3D mechanics problems where a stationary embedded circular crack is defined by a cutting plane geometry and points along the crack front for the domain integral provided by a class that derives from CrackFrontPointsProvider using the deprecated SolidMechanics system.
  • F9.14.8The XFEM system shall permit branched cracks to be represented in 2D by sequentially cutting a 4-noded quadrilateral element by two prescribed evolving cutting planes using the deprecated SolidMechanics system.
  • F9.14.9The XFEM system shall permit branched cracks to be represented in 2D by sequentially cutting a 3-noded triangle element by two prescribed evolving cutting planes using the deprecated SolidMechanics system.
  • F9.14.10The XFEM module shall represent a propagating crack in a 2D mechanics problem in which crack growth occurs when the average stress in the element at the crack tip exceeds a critical value.
  • F9.14.11The XFEM module shall represent a propagating crack in a 2D mechanics problem in which crack growth occurs when the average stress in the element at the crack tip exceeds a critical value defined by the value of a field variable.
  • F9.14.12The XFEM module shall represent a propagating crack in a 2D mechanics problem in which crack growth occurs when the stress at any of the quadrature points in the element at the crack tip exceeds a critical value defined by the value of a field variable.
  • F9.14.13The XFEM module shall permit definition of a stationary crack in a 3D mechanics model with XFEM, where the crack is defined using a rectangular cutting plane by RectangleCutUserObject
  • F9.14.14The XFEM module shall represent a propagating crack in a 3D mechanics model with XFEM, where the crack is defined using a topologically surface cutting mesh by MeshCut3DUserObject
  • F9.14.15The XFEM module shall permit definition of a stationary crack in a 3D mechanics model with XFEM, where the crack is defined using an elliptical cutting plane by EllipseCutUserObject
  • F9.14.16MeshCut3DUserObject shall increase the size of the XFEM cutting surface that it defines for a stationary crack in a 3D model at any point in time by adding additional elements around the periphery of the cutting mesh over time
  • F9.14.17The XFEM system shall permit computation of fracture domain integrals in 3D mechanics problems where a stationary embedded circular crack is defined by a cutting plane geometry and points along the crack front for the domain integral are explicitly specified.
  • F9.14.18The XFEM system shall permit computation of fracture domain integrals in 3D mechanics problems where a stationary embedded circular crack is defined by a cutting plane geometry and points along the crack front for the domain integral provided by a class that derives from CrackFrontPointsProvider.
  • F9.14.19The XFEM system shall permit branched cracks to be represented in 2D by sequentially cutting a 4-noded quadrilateral element by two prescribed evolving cutting planes
  • F9.14.20The XFEM system shall permit branched cracks to be represented in 2D by sequentially cutting a 3-noded triangle element by two prescribed evolving cutting planes
  • F9.14.21The XFEM system shall provide an accessor function to the crack_tip_origin_direction_map