Xfem Software Design Description

Introduction

The Software Design Description (SDD) for Xfem is a description of the software product and serves as guideline that describes the architecture of the system and all of its parts.

Dependencies

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

Requirements Cross Reference

The following is a list of all design documents and the associated requirements for Xfem.

  • xfem: LevelSetCutUserObject
  • 9.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.

    Specification(s): glued_bimaterial

    Design: LevelSetCutUserObjectXFEMSingleVariableConstraint

    Issue(s): #10421

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.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.

    Specification(s): inclusion_bimaterial

    Design: LevelSetCutUserObjectXFEMSingleVariableConstraint

    Issue(s): #10421

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.5.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.

    Specification(s): levelsetcut2d

    Design: LevelSetCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.5.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.

    Specification(s): levelsetcut2d_aux

    Design: LevelSetCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.5.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.

    Specification(s): levelsetcut3d

    Design: LevelSetCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.1The XFEM module shall provide an ability to specify whether an XFEM cut surface should be healed independently for individual interfaces

    Specification(s): moving_interface

    Design: LineSegmentCutSetUserObjectLevelSetCutUserObject

    Issue(s): #11259

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.10The 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.

    Specification(s): moving_diffusion

    Design: LevelSetBiMaterialRealXFEMEqualValueAtInterfaceLineSegmentLevelSetAuxLevelSetCutUserObject

    Issue(s): #11749

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.14The 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.

    Specification(s): 1D_xy_homog1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.15The 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.

    Specification(s): 1D_xy_lsdep1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.16The 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.

    Specification(s): 1D_xy_discrete2mat

    Design: LevelSetCutUserObjectXFEMSingleVariableConstraint

    Issue(s): #13756

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.17The 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.

    Specification(s): 1D_rz_homog1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.18The 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.

    Specification(s): 1D_rz_lsdep1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.19The 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.

    Specification(s): 2D_xy_homog1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.20The 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.

    Specification(s): 2D_xy_lsdep1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.21The 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.

    Specification(s): 2D_rz_homog1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.22The 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.

    Specification(s): 2D_rz_lsdep1mat

    Design: LevelSetCutUserObject

    Issue(s): #12833

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: Checkpoint
  • 9.2.1The XFEM module shall support outputting of checkpoint files.

    Specification(s): checkpoint

    Design: Checkpoint

    Issue(s): #17063

    Collection(s): FUNCTIONAL

    Type(s): CheckFiles

  • xfem: LineSegmentCutUserObject
  • 9.3.1The XFEM module shall have the capability of cutting directly through multiple nodes of a single QUAD4 element in 2D.

    Specification(s): corner_node_cut_twice

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.3.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.

    Specification(s): corner_edge_cut

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.3.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.

    Specification(s): corner_node_cut

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.3.4The XFEM module shall be capable of propagating an existing crack front along a prescribed cut in 2D.

    Specification(s): notch

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.4.1The XFEM module shall have the capability to include near-tip enrichment functions in 2D mechanics simulations.

    Specification(s): crack_tip_enrichment_edge_2d

    Design: LineSegmentCutUserObjectCrackTipEnrichmentStressDivergenceTensors

    Issue(s): #10042

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.5.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.

    Specification(s): diffusion_xfem

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.5.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.

    Specification(s): diffusion_xfem_flux_bc

    Design: LineSegmentCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: XFEM
  • 9.6.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

    Specification(s): init_solution_propagation

    Design: XFEM

    Issue(s): #8763

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.7.1The XFEM module shall permit applying a glued constraint across the XFEM interface for 2D solid mechanics problems.

    Specification(s): glued_penalty

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.8.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

    Specification(s): solid_mechanics_moment_fitting

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.8.2The 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

    Specification(s): diffusion_moment_fitting_four_points

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.8.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 6-point integration rule

    Specification(s): diffusion_moment_fitting_six_points

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.9.2The XFEM module shall not output summary information on mesh changes when debug_output_level=0

    Specification(s): moving_interface_debug_output_0

    Design: XFEM

    Issue(s): #13666

    Collection(s): FUNCTIONAL

    Type(s): RunApp

  • 9.9.3The XFEM module shall output summary information on mesh changes when debug_output_level=1

    Specification(s): moving_interface_debug_output_1

    Design: XFEM

    Issue(s): #13666

    Collection(s): FUNCTIONAL

    Type(s): RunApp

  • 9.9.4The XFEM module shall output detailed information on mesh changes when debug_output_level=2

    Specification(s): moving_interface_debug_output_2

    Design: XFEM

    Issue(s): #13666

    Collection(s): FUNCTIONAL

    Type(s): RunApp

  • 9.9.5The XFEM module shall output detailed information on mesh changes when debug_output_level=3

    Specification(s): moving_interface_debug_output_3

    Design: XFEM

    Issue(s): #13666

    Collection(s): FUNCTIONAL

    Type(s): RunApp

  • 9.11.1The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using TRI6 elements.

    Specification(s): diffusion_2d_tri6

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.2The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using QUAD8 elements.

    Specification(s): diffusion_2d_quad8

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.3The XFEM module shall permit modeling of discontinuities represented with XFEM with second-order elements in 2D using QUAD9 elements.

    Specification(s): diffusion_2d_quad9

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.4The 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.

    Specification(s): diffusion_quad9_levelsetcut

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.5The 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.

    Specification(s): diffusion_3d_tet10

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.6The 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.

    Specification(s): diffusion_3d_hex20

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.7The 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.

    Specification(s): diffusion_3d_hex27

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.8The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD8 elements.

    Specification(s): square_branch_quad8_2d

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.9The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using QUAD9 elements.

    Specification(s): square_branch_quad9_2d

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.11.10The XFEM module shall permit modeling of branching of discontinuities represented with XFEM by sequentially cutting second-order elements in 2D using TRI6 elements.

    Specification(s): square_branch_tri6_2d

    Design: XFEM

    Issue(s): #8709

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.12.1The XFEM module shall properly integrate quantities on sides of cut elements that are intersected by the cutting plane in 2D

    Specification(s): side_integral_xfem

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.12.2The XFEM module shall properly integrate quantities on sides of cut elements that are intersected by the cutting plane in 3D

    Specification(s): side_integral_3d_xfem

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.10The 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

    Specification(s): square_branch_quad_2d

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.11The 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

    Specification(s): square_branch_tri_2d

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.12The XFEM system shall provide an accessor function to the crack_tip_origin_direction_map

    Specification(s): test_crack_counter

    Design: XFEM

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): CSVDiff

  • xfem: XFEMPressure
  • 9.10.1The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D

    Specification(s): edge_2d_pressure

    Design: XFEMPressure

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.10.2The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 3D

    Specification(s): edge_3d_pressure

    Design: XFEMPressure

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.10.3The XFEM module shall permit application of pressure boundary conditions to inclined XFEM cut surfaces in 2D

    Specification(s): inclined_edge_2d_pressure

    Design: XFEMPressure

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.10.4The XFEM module shall permit application of pressure boundary conditions to XFEM cut surfaces in 2D finite deformation simulations

    Specification(s): 2d_pressure_displaced_mesh

    Design: XFEMPressure

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: XFEMRankTwoTensorMarkerUserObject
  • 9.15.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.

    Specification(s): crack_propagation_ave

    Design: XFEMRankTwoTensorMarkerUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.2The 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.

    Specification(s): crack_propagation_var

    Design: XFEMRankTwoTensorMarkerUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.3The 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.

    Specification(s): crack_propagation_single_point

    Design: XFEMRankTwoTensorMarkerUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: RectangleCutUserObject
  • 9.15.4The 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

    Specification(s): edge_crack_3d

    Design: RectangleCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: MeshCut3DUserObject
  • 9.15.5The 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

    Specification(s): edge_crack_3d_propagation

    Design: MeshCut3DUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.7MeshCut3DUserObject 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

    Specification(s): mesh_grow

    Design: MeshCut3DUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: EllipseCutUserObject
  • 9.15.6The 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

    Specification(s): elliptical_crack

    Design: EllipseCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • xfem: DomainIntegral System
  • 9.15.8The 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.

    Specification(s): penny_crack

    Design: DomainIntegral SystemCircleCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff

  • 9.15.9The 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.

    Specification(s): penny_crack_cfp

    Design: DomainIntegral SystemCircleCutUserObject

    Issue(s): #6320

    Collection(s): FUNCTIONAL

    Type(s): Exodiff