Tensor Mechanics Software Design Description

Introduction

The Software Design Description (SDD) for Tensor Mechanics 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 Tensor Mechanics application is developed using MOOSE and is based on various modules, as such the SDD for Tensor Mechanics is dependent upon the following documents.

Requirements Cross Reference

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

  • tensor_mechanics: Pressure Action System
  • F2.16.1The Pressure boundary condition action shall create the objects needed to apply automatic differentiation pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure and match non-AD methods.

    Specification: ad_pressure:3D

    Design: Pressure Action System

    Issue(s): #4781#13260

  • F2.16.2The Pressure boundary condition action shall create the objects needed to apply automatic differentiation pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure using the volumetric locking correction b-bar formulation and match non-AD methods.

    Specification: ad_pressure:3D_Bbar

    Design: Pressure Action System

    Issue(s): #4781#8235#13260

  • F2.16.3The Pressure boundary condition action shall create the objects needed to apply automatic differentiation pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure and calculate a perfect Jacobian.

    Specification: ad_pressure:3D-jac

    Design: Pressure Action System

    Issue(s): #4781#13260

  • F2.16.4The Pressure boundary condition action shall create the objects needed to apply automatic differentiation pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure using the volumetric locking correction b-bar formulation and calculate a perfect Jacobian.

    Specification: ad_pressure:3D_Bbar-jac

    Design: Pressure Action System

    Issue(s): #4781#8235#13260

  • F2.58.1The Pressure boundary condition action shall create the objects needed to apply pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure.

    Specification: pressure:3D

    Design: Pressure Action System

    Issue(s): #4781

  • F2.58.2The Pressure boundary condition action shall create the objects needed to apply pressure boundary conditions on a 3D model as demonstrated by correctly computing the response of an elastic small-strain isotropic unit cube with pressure applied on three faces to create a hydrostatic pressure using the volumetric locking correction b-bar formulation.

    Specification: pressure:3D_Bbar

    Design: Pressure Action System

    Issue(s): #4781#8235

  • tensor_mechanics: Dynamics
  • F2.34.1The PresetAcceleration class shall accurately prescribe the acceleration at the given boundary.

    Specification: dynamics/acceleration_bc:acceleration_bc

    Design: DynamicsPresetAcceleration

    Issue(s): #7642

  • F2.34.2The PresetAcceleration class shall accurately prescribe the acceleration at the given boundary when the Newmark-Beta time integrator is used to calculate the velocity and acceleration.

    Specification: dynamics/acceleration_bc:acceleration_bc_ti

    Design: DynamicsPresetAcceleration

    Issue(s): #12185

  • F2.34.4The PresetDisplacement class shall accurately prescribe the displacement at the given boundary.

    Specification: dynamics/prescribed_displacement:displacement_bc

    Design: DynamicsPresetDisplacement

    Issue(s): #7642

  • F2.34.5The PresetDisplacement class shall accurately prescribe the displacement at the given boundary using the velocity and and acceleration computed using the Newmark-Beta time integrator.

    Specification: dynamics/prescribed_displacement:displacement_bc_ti

    Design: DynamicsPresetDisplacement

    Issue(s): #12185

  • F2.34.6The mechanics system shall accurately conduct a static analysis in a small number of time steps to equilibrate the system under gravity before starting the dynamic analysis.

    Specification: dynamics/prescribed_displacement:displacement_bc_gravity

    Design: Dynamics

    Issue(s): #7642

  • F2.34.7The mechanics system shall accurately predict the dynamic response of a linear elastic system with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration.

    Specification: dynamics/rayleigh_damping:hht

    Design: Dynamics

    Issue(s): #5559

  • F2.34.8The mechanics system shall accurately predict the dynamic response of a linear elastic system with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration when using the velocity and acceleration computed using the Newmark-Beta time integrator.

    Specification: dynamics/rayleigh_damping:hht_ti

    Design: Dynamics

    Issue(s): #12185

  • F2.34.9The mechanics system shall accurately predict the dynamic response of a linear elastic system with a constant Rayleigh damping.

    Specification: dynamics/rayleigh_damping:newmark

    Design: Dynamics

    Issue(s): #5559

  • F2.34.10The mechanics system shall accurately predict the dynamic response of a linear elastic system with Rayleigh damping provided as a material property.

    Specification: dynamics/rayleigh_damping:newmark_material

    Design: Dynamics

    Issue(s): #5559

  • F2.34.11The mechanics system shall accurately predict the dynamic response of a linear elastic system using Hilber-Hughes-Taylor (HHT) time integration.

    Specification: dynamics/time_integration:hht

    Design: Dynamics

    Issue(s): #5559

  • F2.34.12The mechanics system shall accurately predict the dynamic response of a linear elastic system using Newmark time integration.

    Specification: dynamics/time_integration:newmark

    Design: Dynamics

    Issue(s): #5559

  • F2.34.13The mechanics system shall accurately predict the dynamic response of a linear elastic system using Hilber-Hughes-Taylor (HHT) time integration when velocity and acceleration of the system are calculated using the Newmark-Beta time integrator.

    Specification: dynamics/time_integration:hht_ti

    Design: Dynamics

    Issue(s): #12185

  • F2.34.14The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration.

    Specification: dynamics/wave_1D:hht

    Design: Dynamics

    Issue(s): #5559

  • F2.34.15The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with no numerical or structural damping.

    Specification: dynamics/wave_1D:newmark

    Design: Dynamics

    Issue(s): #5559

  • F2.34.16The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration.

    Specification: dynamics/wave_1D:rayleigh_hht

    Design: Dynamics

    Issue(s): #5559

  • F2.34.17The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration when automatic differentiation is used.

    Specification: dynamics/wave_1D:rayleigh_hht_ad

    Design: Dynamics

    Issue(s): #5559

  • F2.34.18The mechanics system shall correctly compute the Jacobian for 1D wave propagation in a linear elastic material with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration when automatic differentiation is used.

    Specification: dynamics/wave_1D:rayleigh_hht_ad_jac

    Design: Dynamics

    Issue(s): #5559

  • F2.34.19The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with both Rayleigh damping and numerical damping resulting from Hilber-Hughes-Taylor (HHT) time integration when using the velocity and acceleration computed using the Newmark-Beta time integrator.

    Specification: dynamics/wave_1D:rayleigh_hht_ti

    Design: Dynamics

    Issue(s): #12185

  • F2.34.20The mechanics system shall correctly predict 1D wave propagation in a linear elastic material with Rayleigh damping.

    Specification: dynamics/wave_1D:rayleigh_newmark

    Design: Dynamics

    Issue(s): #5559

  • tensor_mechanics: Global Strain
  • F2.42.1The globalstrain system shall correctly compute the volume change due to applied stress while still maintaining periodicity in 2D.

    Specification: global_strain:test

    Design: Global Strain

    Issue(s): #11314

  • F2.42.2The globalstrain system shall correctly compute the volume change under uniaxial stress while still maintaining periodicity in all the directions in 3D.

    Specification: global_strain:uniaxial

    Design: Global Strain

    Issue(s): #11314

  • F2.42.3The globalstrain system shall correctly compute the volume change under hydrostratic stress while still maintaining periodicity in all the directions in 3D.

    Specification: global_strain:hydrostat

    Design: Global Strain

    Issue(s): #11314

  • F2.42.4The globalstrain system shall correctly compute the shear deformation due to applied stress while still maintaining periodicity in all the directions in 3D.

    Specification: global_strain:shear

    Design: Global Strain

    Issue(s): #11314

  • F2.42.5The globalstrain system shall correctly compute the deformation behavior in 2D with applied displacement boundary condition in one direction while still maintaining periodicity in the other.

    Specification: global_strain:direction

    Design: Global Strain

    Issue(s): #11314

  • F2.42.6The globalstrain system shall correctly compute the deformation behavior in 3D with applied displacement boundary condition in one direction while still maintaining periodicity in the others.

    Specification: global_strain:disp

    Design: Global Strain

    Issue(s): #11314

  • F2.42.7The globalstrain system shall correctly compute the deformation behavior in 3D with pressure boundary condition in one direction while still maintaining periodicity in the others.

    Specification: global_strain:pressure_3D

    Design: Global Strain

    Issue(s): #11314

  • F2.42.8The 'GlobalStrainAction' should set all the objects reqiured for the globalstrain system to correctly compute the deformation behavior maintaining strain periodicity.

    Specification: global_strain:action_check

    Design: Global Strain

    Issue(s): #11314

  • tensor_mechanics: Gravity
  • F2.43.1The tensor mechanics module shall have the capability of applying a body force term in the stress divergence equilibrium equation that accounts for the force of gravity on a solid object due to its own weight.

    Specification: gravity:gravity_test

    Design: Gravity

    Issue(s): #4781

  • tensor_mechanics: Volume Weighted Weibull
  • F2.45.1VolumeWeightedWeibull shall generate a randomly distributed field that approximates the analytic expression for the Weibull distribution when the mesh is uniform and the reference volume is set equal to the element size

    Specification: ics/volume_weighted_weibull:test

    Design: Volume Weighted Weibull

    Issue(s): #10221

  • F2.45.2VolumeWeightedWeibull shall generate a randomly distributed field that approaches the analytic expression for the Weibull distribution when the mesh is uniform and the reference volume is set equal to the element size as the mesh density is increased

    Specification: ics/volume_weighted_weibull:test_finer

    Design: Volume Weighted Weibull

    Issue(s): #10221

  • F2.45.3VolumeWeightedWeibull shall generate a randomly distributed field that approximates the analytic expression for the Weibull distribution when the mesh is uniform, the reference volume is set to a value different from the element size, and the median is adjusted to account for the different reference volume

    Specification: ics/volume_weighted_weibull:test_ref_vol

    Design: Volume Weighted Weibull

    Issue(s): #10221