Tensor Mechanics Failure Analysis Report

Introduction

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

Dependencies

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

Failure Analysis Requirements

The following is a complete list for all the requirements related to failure analysis for Tensor Mechanics.

  • tensor_mechanics: Ad Action
  • 2.10.3The TensorMechanics MasterAction shall error if an input file does not specify block restrictions for the MasterAction in input files with more than one instance of the MasterAction block.

    Specification(s): error_unrestricted

    Design: Tensor Mechanics Master Action System

    Issue(s): #7555

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.10.2

  • 2.10.4The TensorMechanics MasterAction shall error if an input file specifies overlapping block restrictions for the MasterAction in input files with more than one instance of the MasterAction block.

    Specification(s): error_overlapping

    Design: Tensor Mechanics Master Action System

    Issue(s): #7555

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.10.3

  • 2.10.6The TensorMechanics MasterAction shall error if an input file assigns the same TensorMechanics MasterAction block to mesh blocks with different coordinate systems.

    Specification(s): error_coord

    Design: Tensor Mechanics Master Action System

    Issue(s): #7555

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.10.5

  • tensor_mechanics: Beam
  • 2.27.3The LineElementAction class shall produce an error when the displacement variables are not provided by the user.

    Specification(s): beam_action_test1

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.4The LineElementAction class shall produce an error if the user provided inputs for strain_type, rotation_type and use_displaced_mesh parameters are not compatible.

    Specification(s): beam_action_test2

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.5The LineElementAction class shall produce an error if the number of variables listed in the save_in parameter differs from the number of displacement variables.

    Specification(s): beam_action_test3

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.6The LineElementAction class shall produce an error if the number of variables listed in the diag_save_in parameter differs from the number of displacement variables.

    Specification(s): beam_action_test4

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.7The LineElementAction class shall produce an error if the names for the rotational degrees of freedom are not provided by the user.

    Specification(s): beam_action_test5

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.8The LineElementAction class shall produce an error if the number of rotational variables provided as input differs from the number of displacement variables.

    Specification(s): beam_action_test6

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.9The LineElementAction class shall produce an error if the moment of inertia, area and orientation of the beam are not provided as input.

    Specification(s): beam_action_test7

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.10The LineElementAction class shall produce an error if translational and rotational velocities and accelerations are not provided as input for dynamic simulations using beam elements.

    Specification(s): beam_action_test8

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.11The LineElementAction class shall produce an error if the number of translational and rotational velocities and accelerations differs from the number of displacement variables.

    Specification(s): beam_action_test9

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.12The LineElementAction class shall produce an error if Newmark time integration parameters (beta and gamma) are not provided as input for dynamic simulations using beam elements.

    Specification(s): beam_action_test10

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.13The LineElementAction class shall produce an error if density is not provided as input for dynamic beam simulations using beams elements with consistent mass/inertia matrix.

    Specification(s): beam_action_test11

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.14The LineElementAction class shall produce an error if nodal mass is not provided as input for dynamic beam simulations using beam elements with nodal mass matrix.

    Specification(s): beam_action_test12

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.15The LineElementAction class shall produce an error if nodal inertia is not provided as input for dynamic beam simulations using beam elements with nodal inertia matrix.

    Specification(s): beam_action_test13

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.16The LineElementAction class shall produce an error if multiple subblocks specify properties for the same mesh block.

    Specification(s): beam_action_test14

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.17The LineElementAction class shall produce an error if an action subblock is mesh block restricted while another is not.

    Specification(s): beam_action_test15

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.18The LineElementAction class shall produce an error if dynamic_nodal_translational_inertia is set to true in the common action block but the subblocks do not have the parameters required for a dynamic beam simulation using beam elements.

    Specification(s): beam_action_test16

    Design: Line Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.36The InertialForceBeam class shall produce an error if the number of variables provided for rotations differs from that provided for displacements.

    Specification(s): error_1

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.37The NodalRotatioanlInertia class shall produce an error if the number of rotational velocities and accelerations provided as input differ from the number of rotations.

    Specification(s): error_2

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.38The NodalRotationalInertia class shall produce an error if the user provided nodal inertia is not positive definite.

    Specification(s): error_3

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.39The NodalRotatioanlInertia class shall produce an error if the user provided x and y orientations are not unit vectors.

    Specification(s): error_4

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.40The NodalRotatioanlInertia class shall produce an error if the user provided x and y orientations are not perpendicular to each other.

    Specification(s): error_5

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.41The NodalRotatioanlInertia class shall produce an error if only x or y orientation is provided as input by the user.

    Specification(s): error_6

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.42The InertialForceBeam class shall produce an error if the number of translational and rotational velocities and accelerations provided as input differ from the number of displacement variables.

    Specification(s): error_7

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.43The NodalTranslationalInertia class shall produce an error if nodal mass is provided as input both as a constant value and also using a csv file.

    Specification(s): error_8

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.44The NodalTranslationalInertia class shall produce an error if nodal mass is not provided as input either as a constant value or using a csv file.

    Specification(s): error_9

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.45The NodalTranslationalInertia class shall produce an error if the number of columns in the nodal mass file is not 4.

    Specification(s): error_10

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.46The NodalTranslationalInertia class shall produce an error if all the nodal positions provided in the nodal mass file cannot be found in the given boundary or mesh block.

    Specification(s): error_11

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.47The NodalGravity class shall produce an error if nodal mass is provided as input both as a constant value and also using a csv file.

    Specification(s): error_12

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.48The NodalGravity class shall produce an error if nodal mass is not provided as input either as a constant value or using a csv file.

    Specification(s): error_13

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.49The NodalGravity class shall produce an error if the number of columns in the nodal mass file is not 4.

    Specification(s): error_14

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.50The NodalGravity class shall produce an error if all the nodal positions provided in the nodal mass file cannot be found in the given boundary or mesh block.

    Specification(s): error_15

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.51The LineElementAction class shall produce an error if add_dynamic_variables option is set to false while dynamic_consistent_inertia, dynamic_nodal_rotational_inertia or dynamic_nodal_translational_inertia options are set to true.

    Specification(s): error_16

    Design: C0 Timoshenko Beam ElementLine Element Action System

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.52The NodalTranslationalInertia class shall produce an error if nodal mass is provided as input both as constant value and also using a csv file.

    Specification(s): error_17

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.55The ComputeEigenstrainBeamFromVariable class shall report an error if less than 3 displacement or rotational eigenstrains are provided by the user.

    Specification(s): eigenstrain_from_var_test1

    Design: Compute Eigenstrain Beam From Variable

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.67The ComputeIncrementalBeamStrain class shall produce an error if the number of supplied displacements and rotations do not match.

    Specification(s): error_displacements1

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.68The StressDivergenceBeam class shall produce an error if the number of supplied displacements and rotations do not match.

    Specification(s): error_displacements2

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.69The ComputeIncrementalBeamStrain class shall produce an error if large strain calculation is requested for asymmetric beam configurations with non-zero first or third moments of area.

    Specification(s): error_large_strain

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.27.70The ComputeIncrementalBeamStrain class shall produce an error if the y orientation provided is not perpendicular to the beam axis.

    Specification(s): error_y_orientation

    Design: C0 Timoshenko Beam Element

    Issue(s): #10313

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Capped Weak Plane
  • 2.30.1The CappedWeakPlaneStressUpdate model shall generate an error if the friction angle is negative

    Specification(s): except1

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.2The CappedWeakPlaneStressUpdate model shall generate an error if the dilation angle is negative

    Specification(s): except2

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.3The CappedWeakPlaneStressUpdate model shall generate an error if the friction angle is less than the dilation angle

    Specification(s): except3

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.4The CappedWeakPlaneStressUpdate model shall generate an error if the cohesion is negative

    Specification(s): except4

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.5The CappedWeakPlaneStressUpdate model shall generate an error if the sum of the tensile and compressive strength is less than smoothing_tol

    Specification(s): except5

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.6The CappedWeakPlaneStressUpdate model shall generate an error if the normal vector has zero length

    Specification(s): except6

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7784

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.30.24The system shall permit exceptions to be thrown from material models with stateful properties without reading/writing to/from uninitialized memory

    Specification(s): throw_test

    Design: CappedWeakPlaneStressUpdate

    Issue(s): #7960

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Check Error
  • 2.32.1The system shall generate an error if a number of elastic constants other than two is supplied for an isotropic elasticity tensor

    Specification(s): num_constants

    Design: Compute Isotropic Elasticity Tensor

    Issue(s): #9438

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.32.2The system shall generate an error if a non-positive Youngs modulus is supplied for an isotropic elasticity tensor

    Specification(s): youngs_modulus

    Design: Compute Isotropic Elasticity Tensor

    Issue(s): #9438

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.32.3The system shall generate an error if a non-positive bulk modulus is supplied for an isotropic elasticity tensor

    Specification(s): bulk_modulus

    Design: Compute Isotropic Elasticity Tensor

    Issue(s): #9438

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.32.4The system shall generate an error if a Poissons ratio outside the range from -1 to 0.5 is supplied for an isotropic elasticity tensor

    Specification(s): poissons_ratio

    Design: Compute Isotropic Elasticity Tensor

    Issue(s): #9438

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.32.5The system shall generate an error if a non-positive shear modulus is supplied for an isotropic elasticity tensor

    Specification(s): shear_modulus

    Design: Compute Isotropic Elasticity Tensor

    Issue(s): #9438

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Critical Time Step
  • 2.38.3The system shall produce an error if the input elasticity tensor is non-isotropic.

    Specification(s): except1

    Design: Critical Time Step Postprocessor

    Issue(s): #13975

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Domain Integral Thermal
  • 2.40.5The DomainIntegralAction shall generate an error if a user specifies the eigenstrain gradient and also request the J integral

    Specification(s): test_ii_arb_eig_grad_err_jint

    Design: DomainIntegral System

    Issue(s): #18804

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.40.4

  • 2.40.6The DomainIntegralAction shall generate an error if a user specifies the temperature and also provides the eigenstrain_gradient

    Specification(s): test_ii_arb_eig_grad_err_temp

    Design: DomainIntegral System

    Issue(s): #18804

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.40.5

  • 2.40.8The DomainIntegralAction shall generate an error if a user specifies the body force and also request the J integral

    Specification(s): test_ii_bf_err_jint

    Design: DomainIntegral System

    Issue(s): #18804

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.40.7

  • tensor_mechanics: Initial Stress
  • 2.59.1TensorMechanics shall allow users to specify initial stresses, but shall error-out with appropriate message if the user does not supply the correct number of functions to define the initial stress tensor

    Specification(s): except01

    Design: ComputeEigenstrainFromInitialStress

    Issue(s): #9749

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.59.2TensorMechanics shall allow users to specify initial stresses, but shall error-out with appropriate message if the user does not supply the correct number of AuxVariables to define the initial stress tensor

    Specification(s): except02

    Design: ComputeEigenstrainFromInitialStress

    Issue(s): #13087

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Material Limit Time Step
  • 2.72.6The MaterialTimeStepPostprocessor shall generate an error if an unknown property is requested with the 'time_step_limit' parameter

    Specification(s): elements_damage_limit_unknown_prop

    Design: Material Time Step Postprocessor

    Issue(s): #11662

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.72.4

  • 2.72.7The MaterialTimeStepPostprocessor shall generate an error if neither the material time step limit nor the elements changed limit is specified.

    Specification(s): e

    Design: Material Time Step Postprocessor

    Issue(s): #11662

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.72.3

  • tensor_mechanics: Mohr Coulomb
  • 2.75.1

    Specification(s): except1

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.75.2

    Specification(s): except2

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.75.3

    Specification(s): except3

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.75.4

    Specification(s): except4

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Static Deformations
  • 2.94.12

    Specification(s): except01

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

    Prerequisite(s): 2.94.2

  • tensor_mechanics: Stickybc
  • 2.95.1

    Specification(s): except1

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Strain Energy Density
  • 2.96.2The system shall be capable of informing a user when they incorrectly choose not to use the incremental strain energy density formulation with an incremental material model.

    Specification(s): incr_chk1

    Design: Strain Energy Density

    Issue(s): #10972

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.96.4The system shall be capable of informing a user when they incorrectly choose to use the incremental strain energy density formulation in a material utilizing small strain.

    Specification(s): tot_chk1

    Design: Strain Energy Density

    Issue(s): #10972

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Torque Reaction
  • 2.106.7The system shall generate an error if the DisplacementAboutAxis boundary condition is applied to a component outside the range applicable for the dimensionality of the model

    Specification(s): disp_about_axis_error1

    Design: Displacement About Axis

    Issue(s): #15092

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.106.8The system shall generate an error if the vector prescribed using the axis_direction parameter in the DisplacementAboutAxis boundary condition has a length of zero

    Specification(s): disp_about_axis_error2

    Design: Displacement About Axis

    Issue(s): #15092

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Umat
  • 2.109.2The system shall raise an error if a UMAT that requires incremental quantities is being used with a total strain formulation

    Specification(s): total_strain_error

    Design: Abaqus UMAT Stress

    Issue(s): #14974

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • tensor_mechanics: Weak Plane Shear
  • 2.114.1The system shall not allow a weak plane shear friction angle less than the dilation angle.

    Specification(s): except1

    Design: TensorMechanicsPlasticWeakPlaneShear

    Issue(s): #3878#4150#4507

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.114.2The system shall not allow a zero length transverse direction vector

    Specification(s): except2

    Design: TensorMechanicsPlasticWeakPlaneShear

    Issue(s): #3878#4150#4507

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException

  • 2.114.3The system shall cut the timestep through a mooseException when the loading conditions deform the element enough to produce a negative number under a square root term in the Rashid approximation for the rotation tensor

    Specification(s): except3

    Design: Compute Finite Strain in Cartesian System

    Issue(s): #19067

    Collection(s): FAILURE_ANALYSISFUNCTIONAL

    Type(s): RunException