Phase Field Failure Analysis Report

Introduction

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

Dependencies

The Phase Field module is developed using MOOSE and can itself be based on various MOOSE modules, as such the FAR for the Phase Field 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 Phase Field module.

phase_field: Ebsdmeshgenerator
12.5.1
The system shall detect invalid or inconsistent EBSD file parameters
1. if the EBSD data step size is zero,
2. if the EBSD grid size is zero,
3. if the EBSD data is zero dimensional,
4. if the requested pre_refine levels are not possible
Specification(s): errors/zerostep, errors/zerosize, errors/zerodim, errors/norefine
Design: EBSDMeshGenerator
Issue(s): #19150
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68 68 68 68

phase_field: Conserved Noise
12.25.5The conserved noise kernel shall error out with a helpful message if a 'seed' parameter is supplied
Specification(s): seed_error
Design: Langevin Noise
Issue(s): #4763
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68

phase_field: Flood Counter Aux Test
12.29.4The feature flood counter aux kernel shall throw an error when acting on a variable that is incompatible with the flood counter mode.
Specification(s): simple_error
Design: FeatureFloodCountAux
Issue(s): #5077
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68
12.29.9The system shall report an error if a nodal variable is specified as the target for the intersection status.
Specification(s): boundary_intersection_error
Design: FeatureFloodCount FeatureFloodCountAux
Issue(s): #23246
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68

phase_field: Grain Tracker Test
12.36.4The PolycrystalUserObject base class shall error when a valid coloring cannot be found when using the simple back-tracking algorithm.
Specification(s): test_advanced_op_assignment_bt_error
Design: Polycrystal Initial Conditions
Issue(s): #7005 #8804
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68
12.36.5The PolycrystalUserObject base class shall error when a valid coloring cannot be found when using the built-in PETSc based stochastic algorithms.
Specification(s): test_advanced_op_assignment_petsc_error
Design: Polycrystal Initial Conditions
Issue(s): #7005 #8804
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): RunException
68

phase_field: Initial Conditions
12.37.8
The system shall support phase-field initial conditions consiting of box patterns:
1. bounding boxes,
2. bounding boxes with random noise,
3. multiple bounding boxes in 1D,
4. multiple bounding boxes in 2D, and
5. multiple bounding boxes in 3D.
6. Diffused interface can be assigned for isolated bounding boxes in 2D,
7. 3D,
8. nested bounding boxes in 2D, and
9. 3D.
10. Using IsolatedBoundingBoxIC to create overlapping boxes will throw an error.
Specification(s): boxes/BoundingBoxIC, boxes/RndBoundingBoxIC, boxes/MultiBoundingBoxIC1D, boxes/MultiBoundingBoxIC2D, boxes/MultiBoundingBoxIC3D, boxes/IsolatedBoundingBoxIC_2D, boxes/IsolatedBoundingBoxIC_3D, boxes/NestedBoundingBoxIC_2D, boxes/NestedBoundingBoxIC_3D, boxes/IsolatedBoundingBoxIC_2D_Overlapping
Design: Polycrystal Initial Conditions
Issue(s): #6858 #5816 #7358 #8721 #12000 #6655 #9174 #17731
Collection(s): FUNCTIONALFAILURE_ANALYSIS
Type(s): ExodiffRunException
68 68 68 68 68 68 68 68 68 68


[zerostep]
  type = RunException
  input = test.i
  cli_args = 'Mesh/ebsd/filename=ebsd3D_zerostep.txt --mesh-only'
  expect_err = 'Error reading header, EBSD data step size is zero.'
  detail = 'if the EBSD data step size is zero,'
[]


[zerosize]
  type = RunException
  input = test.i
  cli_args = 'Mesh/ebsd/filename=ebsd3D_zerosize.txt --mesh-only'
  expect_err = 'Error reading header, EBSD grid size is zero.'
  detail = 'if the EBSD grid size is zero,'
[]


[zerodim]
  type = RunException
  input = test.i
  cli_args = 'Mesh/ebsd/filename=ebsd3D_zerodim.txt --mesh-only'
  expect_err = 'Error reading header, EBSD data is zero dimensional.'
  detail = 'if the EBSD data is zero dimensional,'
[]


[norefine]
  type = RunException
  input = test.i
  cli_args = 'Mesh/ebsd/filename=ebsd3D_norefine.txt Mesh/ebsd/pre_refine=2 --mesh-only'
  expect_err = 'EBSDMeshGenerator error. Requested levels of pre refinement not possible.'
  detail = 'if the requested pre_refine levels are not possible'
[]


[./seed_error]
  type = 'RunException'
  input = 'integral.i'
  cli_args = 'Kernels/conserved_langevin/seed=1234'
  expect_err = "This parameter has no effect in this kernel. The noise is generated in the user object"

  requirement = "The conserved noise kernel shall error out with a helpful message if a 'seed' parameter is supplied"
[../]


[simple_error]
  type = 'RunException'
  input = 'simple.i'
  expect_err = 'must be on variable types that match the entity mode of the FeatureFloodCounter'
  cli_args = 'AuxVariables/bubble_map0/family=MONOMIAL'
  #max_parallel = 4                     # Only 4 elements
  max_parallel = 1 # See #9886
  issues = '#5077'
  design = 'FeatureFloodCountAux.md'
  requirement = "The feature flood counter aux kernel shall throw an error when acting on a variable that is incompatible with the flood counter mode."
[]


[boundary_intersection_error]
  type = 'RunException'
  expect_err = 'The selected option is only available for elemental aux variables'
  cli_args = 'AuxVariables/v/family=LAGRANGE AuxVariables/v/order=FIRST'
  input = 'boundary_intersection.i'
  issues = '#23246'
  requirement = "The system shall report an error if a nodal variable is specified as the target for the intersection status."
  design = 'FeatureFloodCount.md FeatureFloodCountAux.md'
[]


[test_advanced_op_assignment_bt_error]
  type = 'RunException'
  input = 'grain_tracker_advanced_op.i'
  expect_err = "Unable to find a valid grain to op coloring"
  recover = false # No solve
  cli_args = 'GlobalParams/op_num=4 Outputs/csv=false'

  requirement = "The PolycrystalUserObject base class shall error when a valid coloring cannot be found when using the simple back-tracking algorithm."
  issues = '#7005 #8804'
  design = "PolycrystalICs.md"
[]


[test_advanced_op_assignment_petsc_error]
  type = 'RunException'
  input = 'grain_tracker_advanced_op.i'
  expect_err = "Unable to find a valid grain to op coloring"
  recover = false # No solve
  cli_args = 'UserObjects/voronoi/coloring_algorithm=jp GlobalParams/op_num=6 Outputs/csv=false'

  requirement = "The PolycrystalUserObject base class shall error when a valid coloring cannot be found when using the built-in PETSc based stochastic algorithms."
  issues = '#7005 #8804'
  design = "PolycrystalICs.md"
[]


[RndBoundingBoxIC]
  type = Exodiff
  input = 'RndBoundingBoxIC.i'
  exodiff = 'RndBoundingBoxIC_out.e'
  scale_refine = 1
  valgrind = 'HEAVY'
  max_parallel = 1
  max_threads = 1
  recover = false # See #5207

  detail = 'bounding boxes with random noise,'
[]


[IsolatedBoundingBoxIC_2D]
  type = Exodiff
  input = 'IsolatedBoundingBoxIC_2D.i'
  exodiff = 'IsolatedBoundingBoxIC_2D_out.e'

  detail = 'Diffused interface can be assigned for isolated bounding boxes in 2D,'
[]


[IsolatedBoundingBoxIC_2D_Overlapping]
  type = RunException
  input = 'IsolatedBoundingBoxIC_2D_Overlapping.i'
  expect_err = 'Partially overlapping boxes are not allowed. Note that this includes the overlapping diffused interfaces. For nested boxes, use NestedBoundingBoxIC.C'

  detail = 'Using IsolatedBoundingBoxIC to create overlapping boxes will throw an error.'
[]

Introduction
Dependencies
Failure Analysis Requirements