www.mooseframework.org
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
ADComputeEigenstrain< compute_stage > Class Template Reference

ComputeEigenstrain computes an Eigenstrain that is a function of a single variable defined by a base tensor and a scalar function defined in a Derivative Material. More...

#include <ADComputeEigenstrain.h>

Inheritance diagram for ADComputeEigenstrain< compute_stage >:
[legend]

Public Member Functions

 ADComputeEigenstrain (const InputParameters &parameters)
 

Static Public Member Functions

static InputParameters validParams ()
 

Protected Member Functions

virtual void computeQpEigenstrain () override
 Compute the eigenstrain and store in _eigenstrain. More...
 
const ADMaterialProperty (Real) &_prefactor
 
virtual void initQpStatefulProperties () override
 
virtual void computeQpProperties () override
 
 ADMaterialProperty (RankTwoTensor) &_eigenstrain
 Stores the current total eigenstrain. More...
 
ADReal computeVolumetricStrainComponent (const ADReal volumetric_strain) const
 Helper function for models that compute the eigenstrain based on a volumetric strain. More...
 

Protected Attributes

RankTwoTensor _eigen_base_tensor
 
 usingComputeEigenstrainBaseMembers
 
const std::string _base_name
 Base name prepended to material property name. More...
 
std::string _eigenstrain_name
 Material property name for the eigenstrain tensor. More...
 
bool & _step_zero
 Restartable data to check for the zeroth and first time steps for thermal calculations. More...
 
 usingMaterialMembers
 

Detailed Description

template<ComputeStage compute_stage>
class ADComputeEigenstrain< compute_stage >

ComputeEigenstrain computes an Eigenstrain that is a function of a single variable defined by a base tensor and a scalar function defined in a Derivative Material.

Definition at line 17 of file ADComputeEigenstrain.h.

Constructor & Destructor Documentation

◆ ADComputeEigenstrain()

template<ComputeStage compute_stage>
ADComputeEigenstrain< compute_stage >::ADComputeEigenstrain ( const InputParameters &  parameters)

Definition at line 32 of file ADComputeEigenstrain.C.

34  _prefactor(getADMaterialProperty<Real>("prefactor"))
35 {
36  _eigen_base_tensor.fillFromInputVector(getParam<std::vector<Real>>("eigen_base"));
37 }

Member Function Documentation

◆ ADMaterialProperty() [1/2]

template<ComputeStage compute_stage>
ADComputeEigenstrainBase< compute_stage >::ADMaterialProperty ( RankTwoTensor  ) &
protectedinherited

Stores the current total eigenstrain.

◆ ADMaterialProperty() [2/2]

template<ComputeStage compute_stage>
const ADComputeEigenstrain< compute_stage >::ADMaterialProperty ( Real  ) &
protected

◆ computeQpEigenstrain()

template<ComputeStage compute_stage>
void ADComputeEigenstrain< compute_stage >::computeQpEigenstrain ( )
overrideprotectedvirtual

Compute the eigenstrain and store in _eigenstrain.

Implements ADComputeEigenstrainBase< compute_stage >.

Definition at line 41 of file ADComputeEigenstrain.C.

42 {
43  // Define Eigenstrain
44  _eigenstrain[_qp] = _eigen_base_tensor * _prefactor[_qp];
45 }

◆ computeQpProperties()

template<ComputeStage compute_stage>
void ADComputeEigenstrainBase< compute_stage >::computeQpProperties ( )
overrideprotectedvirtualinherited

Definition at line 59 of file ADComputeEigenstrainBase.C.

60 {
61  if (_t_step >= 1)
62  _step_zero = false;
63 
64  // Skip the eigenstrain calculation in step zero because no solution is computed during
65  // the zeroth step, hence computing the eigenstrain in the zeroth step would result in
66  // an incorrect calculation of mechanical_strain, which is stateful.
67  if (!_step_zero)
69 }

◆ computeVolumetricStrainComponent()

template<ComputeStage compute_stage>
ADReal ADComputeEigenstrainBase< compute_stage >::computeVolumetricStrainComponent ( const ADReal  volumetric_strain) const
protectedinherited

Helper function for models that compute the eigenstrain based on a volumetric strain.

This function computes the diagonal components of the eigenstrain tensor as logarithmic strains.

Parameters
volumetric_strainThe current volumetric strain to be applied
Returns
Current strain in one direction due to volumetric strain, expressed as a logarithmic strain

Definition at line 73 of file ADComputeEigenstrainBase.C.

75 {
76  // The engineering strain in a given direction is:
77  // epsilon_eng = cbrt(volumetric_strain + 1.0) - 1.0
78  //
79  // We need to provide this as a logarithmic strain to be consistent with the strain measure
80  // used for finite strain:
81  // epsilon_log = log(1.0 + epsilon_eng)
82  //
83  // This can be simplified down to a more direct form:
84  // epsilon_log = log(cbrt(volumetric_strain + 1.0))
85  // or:
86  // epsilon_log = (1/3) log(volumetric_strain + 1.0)
87 
88  return std::log(volumetric_strain + 1.0) / 3.0;
89 }

◆ initQpStatefulProperties()

template<ComputeStage compute_stage>
void ADComputeEigenstrainBase< compute_stage >::initQpStatefulProperties ( )
overrideprotectedvirtualinherited

Reimplemented in ADComputeInstantaneousThermalExpansionFunctionEigenstrain< compute_stage >.

Definition at line 50 of file ADComputeEigenstrainBase.C.

51 {
52  // This property can be promoted to be stateful by other models that use it,
53  // so it needs to be initalized.
54  _eigenstrain[_qp].zero();
55 }

◆ validParams()

template<ComputeStage compute_stage>
InputParameters ADComputeEigenstrain< compute_stage >::validParams ( )
static

Definition at line 20 of file ADComputeEigenstrain.C.

21 {
23  params.addClassDescription("Computes a constant Eigenstrain");
24  params.addRequiredParam<std::vector<Real>>(
25  "eigen_base", "Vector of values defining the constant base tensor for the Eigenstrain");
26  params.addParam<MaterialPropertyName>(
27  "prefactor", 1.0, "Name of material defining the variable dependence");
28  return params;
29 }

Member Data Documentation

◆ _base_name

template<ComputeStage compute_stage>
const std::string ADComputeEigenstrainBase< compute_stage >::_base_name
protectedinherited

Base name prepended to material property name.

Definition at line 50 of file ADComputeEigenstrainBase.h.

◆ _eigen_base_tensor

template<ComputeStage compute_stage>
RankTwoTensor ADComputeEigenstrain< compute_stage >::_eigen_base_tensor
protected

◆ _eigenstrain_name

template<ComputeStage compute_stage>
std::string ADComputeEigenstrainBase< compute_stage >::_eigenstrain_name
protectedinherited

Material property name for the eigenstrain tensor.

Definition at line 53 of file ADComputeEigenstrainBase.h.

◆ _step_zero

template<ComputeStage compute_stage>
bool& ADComputeEigenstrainBase< compute_stage >::_step_zero
protectedinherited

Restartable data to check for the zeroth and first time steps for thermal calculations.

Definition at line 69 of file ADComputeEigenstrainBase.h.

◆ usingComputeEigenstrainBaseMembers

template<ComputeStage compute_stage>
ADComputeEigenstrain< compute_stage >::usingComputeEigenstrainBaseMembers
protected

Definition at line 40 of file ADComputeEigenstrain.h.

◆ usingMaterialMembers

template<ComputeStage compute_stage>
ADComputeEigenstrainBase< compute_stage >::usingMaterialMembers
protectedinherited

Definition at line 71 of file ADComputeEigenstrainBase.h.


The documentation for this class was generated from the following files:
ADComputeEigenstrain::_eigen_base_tensor
RankTwoTensor _eigen_base_tensor
Definition: ADComputeEigenstrain.h:38
ADComputeEigenstrainBase
ADComputeEigenstrainBase is the base class for eigenstrain tensors.
Definition: ADComputeEigenstrainBase.h:21
ADComputeEigenstrainBase::_step_zero
bool & _step_zero
Restartable data to check for the zeroth and first time steps for thermal calculations.
Definition: ADComputeEigenstrainBase.h:69
ADComputeEigenstrainBase::validParams
static InputParameters validParams()
Definition: ADComputeEigenstrainBase.C:18
ADComputeEigenstrainBase::computeQpEigenstrain
virtual void computeQpEigenstrain()=0
Compute the eigenstrain and store in _eigenstrain.