ComputeStrainBase Class Reference

ComputeStrainBase is the base class for strain tensors. More...

#include <ComputeStrainBase.h>

Inheritance diagram for ComputeStrainBase:

Public Member Functions
	ComputeStrainBase (const InputParameters &parameters)
void	initialSetup () override

Static Public Member Functions
static InputParameters	validParams ()

Protected Member Functions
virtual void	initQpStatefulProperties () override
virtual void	displacementIntegrityCheck ()

Protected Attributes
unsigned int	_ndisp
	Coupled displacement variables. More...
std::vector< const VariableValue * >	_disp
std::vector< const VariableGradient * >	_grad_disp
const std::string	_base_name
MaterialProperty< RankTwoTensor > &	_mechanical_strain
MaterialProperty< RankTwoTensor > &	_total_strain
std::vector< MaterialPropertyName >	_eigenstrain_names
std::vector< const MaterialProperty< RankTwoTensor > * >	_eigenstrains
const MaterialProperty< RankTwoTensor > *	_global_strain
const bool	_volumetric_locking_correction
const Real &	_current_elem_volume

Detailed Description

ComputeStrainBase is the base class for strain tensors.

Definition at line 26 of file ComputeStrainBase.h.

Constructor & Destructor Documentation

ComputeStrainBase()

ComputeStrainBase::ComputeStrainBase

(

const InputParameters &

parameters

)

Definition at line 38 of file ComputeStrainBase.C.

  : DerivativeMaterialInterface<Material>(parameters),
    _ndisp(coupledComponents("displacements")),
    _disp(3),
    _grad_disp(3),
    _base_name(isParamValid("base_name") ? getParam<std::string>("base_name") + "_" : ""),
    _mechanical_strain(declareProperty<RankTwoTensor>(_base_name + "mechanical_strain")),
    _total_strain(declareProperty<RankTwoTensor>(_base_name + "total_strain")),
    _eigenstrain_names(getParam<std::vector<MaterialPropertyName>>("eigenstrain_names")),
    _eigenstrains(_eigenstrain_names.size()),
    _global_strain(isParamValid("global_strain")
                       ? &getMaterialProperty<RankTwoTensor>(_base_name + "global_strain")
                       : nullptr),
    _volumetric_locking_correction(getParam<bool>("volumetric_locking_correction") &&
                                   !isBoundaryMaterial()),
    _current_elem_volume(_assembly.elemVolume())
{
  for (unsigned int i = 0; i < _eigenstrains.size(); ++i)
  {
    _eigenstrain_names[i] = _base_name + _eigenstrain_names[i];
    _eigenstrains[i] = &getMaterialProperty<RankTwoTensor>(_eigenstrain_names[i]);
  }
 
  if (_ndisp == 1 && _volumetric_locking_correction)
    paramError("volumetric_locking_correction", "has to be set to false for 1-D problems.");
 
  if (getParam<bool>("use_displaced_mesh"))
    paramError("use_displaced_mesh", "The strain calculator needs to run on the undisplaced mesh.");
 
  // Generate warning when volumetric locking correction is used with second order elements
  if (_mesh.hasSecondOrderElements() && _volumetric_locking_correction)
    mooseWarning("Volumetric locking correction is not required for second order elements. Using "
                 "volumetric locking with second order elements could cause zigzag patterns in "
                 "stresses and strains.");
}

Member Function Documentation

displacementIntegrityCheck()

void ComputeStrainBase::displacementIntegrityCheck ( )

protectedvirtual

Reimplemented in Compute2DFiniteStrain, Compute2DIncrementalStrain, and Compute2DSmallStrain.

Definition at line 94 of file ComputeStrainBase.C.

{
  // Checking for consistency between mesh size and length of the provided displacements vector
  if (_ndisp != _mesh.dimension())
    paramError(
        "displacements",
        "The number of variables supplied in 'displacements' must match the mesh dimension.");
}

Referenced by initialSetup().

initialSetup()

void ComputeStrainBase::initialSetup ( )

override

Definition at line 75 of file ComputeStrainBase.C.

{
  displacementIntegrityCheck();
  // fetch coupled variables and gradients (as stateful properties if necessary)
  for (unsigned int i = 0; i < _ndisp; ++i)
  {
    _disp[i] = &coupledValue("displacements", i);
    _grad_disp[i] = &coupledGradient("displacements", i);
  }
 
  // set unused dimensions to zero
  for (unsigned i = _ndisp; i < 3; ++i)
  {
    _disp[i] = &_zero;
    _grad_disp[i] = &_grad_zero;
  }
}

Referenced by ComputeIncrementalStrainBase::initialSetup(), and ComputeAxisymmetric1DSmallStrain::initialSetup().

initQpStatefulProperties()

void ComputeStrainBase::initQpStatefulProperties ( )

overrideprotectedvirtual

Reimplemented in ComputeIncrementalStrainBase, and ComputeCosseratIncrementalSmallStrain.

Definition at line 104 of file ComputeStrainBase.C.

{
  _mechanical_strain[_qp].zero();
  _total_strain[_qp].zero();
}

validParams()

InputParameters ComputeStrainBase::validParams ( )

static

Definition at line 17 of file ComputeStrainBase.C.

{
  InputParameters params = Material::validParams();
  params.addRequiredCoupledVar(
      "displacements",
      "The displacements appropriate for the simulation geometry and coordinate system");
  params.addParam<std::string>("base_name",
                               "Optional parameter that allows the user to define "
                               "multiple mechanics material systems on the same "
                               "block, i.e. for multiple phases");
  params.addParam<bool>(
      "volumetric_locking_correction", false, "Flag to correct volumetric locking");
  params.addParam<std::vector<MaterialPropertyName>>(
      "eigenstrain_names", "List of eigenstrains to be applied in this strain calculation");
  params.addParam<MaterialPropertyName>("global_strain",
                                        "Optional material property holding a global strain "
                                        "tensor applied to the mesh as a whole");
  params.suppressParameter<bool>("use_displaced_mesh");
  return params;
}

Referenced by ComputeCosseratSmallStrain::validParams(), ComputeIncrementalStrainBase::validParams(), and ComputeSmallStrain::validParams().

Member Data Documentation

_base_name

const std::string ComputeStrainBase::_base_name

protected

Definition at line 44 of file ComputeStrainBase.h.

Referenced by ComputeStrainBase().

_current_elem_volume

const Real& ComputeStrainBase::_current_elem_volume

protected

Definition at line 56 of file ComputeStrainBase.h.

Referenced by ComputeFiniteStrain::computeProperties(), ComputeSmallStrain::computeProperties(), ComputeIncrementalSmallStrain::computeProperties(), Compute2DFiniteStrain::computeProperties(), and Compute2DSmallStrain::computeProperties().

_disp

std::vector<const VariableValue *> ComputeStrainBase::_disp

protected

Definition at line 41 of file ComputeStrainBase.h.

Referenced by ComputeAxisymmetric1DFiniteStrain::computeGradDispZZ(), ComputeAxisymmetric1DIncrementalStrain::computeGradDispZZ(), ComputeAxisymmetricRZFiniteStrain::computeOutOfPlaneGradDisp(), ComputeAxisymmetricRZIncrementalStrain::computeOutOfPlaneGradDisp(), ComputeAxisymmetricRZSmallStrain::computeOutOfPlaneStrain(), ComputeRSphericalSmallStrain::computeProperties(), ComputeRSphericalFiniteStrain::computeProperties(), ComputeAxisymmetric1DSmallStrain::computeStrainZZ(), ComputeRSphericalIncrementalStrain::computeTotalStrainIncrement(), Compute2DSmallStrain::initialSetup(), initialSetup(), Compute2DIncrementalStrain::initialSetup(), and Compute2DFiniteStrain::initialSetup().

_eigenstrain_names

std::vector<MaterialPropertyName> ComputeStrainBase::_eigenstrain_names

protected

Definition at line 50 of file ComputeStrainBase.h.

Referenced by ComputeIncrementalStrainBase::ComputeIncrementalStrainBase(), and ComputeStrainBase().

_eigenstrains

std::vector<const MaterialProperty<RankTwoTensor> *> ComputeStrainBase::_eigenstrains

protected

Definition at line 51 of file ComputeStrainBase.h.

Referenced by ComputeSmallStrain::computeProperties(), ComputeRSphericalSmallStrain::computeProperties(), Compute1DSmallStrain::computeProperties(), Compute2DSmallStrain::computeProperties(), ComputeCosseratSmallStrain::computeQpProperties(), ComputeCrackTipEnrichmentSmallStrain::computeQpProperties(), ComputeStrainBase(), and ComputeIncrementalStrainBase::subtractEigenstrainIncrementFromStrain().

_global_strain

const MaterialProperty<RankTwoTensor>* ComputeStrainBase::_global_strain

protected

Definition at line 53 of file ComputeStrainBase.h.

Referenced by ComputeSmallStrain::computeProperties(), and ComputeFiniteStrain::computeQpStrain().

_grad_disp

std::vector<const VariableGradient *> ComputeStrainBase::_grad_disp

protected

Definition at line 42 of file ComputeStrainBase.h.

Referenced by ComputeFiniteStrain::computeProperties(), ComputeSmallStrain::computeProperties(), Compute1DFiniteStrain::computeProperties(), ComputeRSphericalSmallStrain::computeProperties(), Compute1DSmallStrain::computeProperties(), Compute2DFiniteStrain::computeProperties(), Compute2DSmallStrain::computeProperties(), ComputeRSphericalFiniteStrain::computeProperties(), ComputeCosseratSmallStrain::computeQpProperties(), ComputeCosseratIncrementalSmallStrain::computeQpProperties(), ComputeCrackTipEnrichmentSmallStrain::computeQpProperties(), ComputeIncrementalSmallStrain::computeTotalStrainIncrement(), Compute1DIncrementalStrain::computeTotalStrainIncrement(), ComputeRSphericalIncrementalStrain::computeTotalStrainIncrement(), Compute2DIncrementalStrain::computeTotalStrainIncrement(), Compute2DSmallStrain::initialSetup(), Compute2DIncrementalStrain::initialSetup(), initialSetup(), and Compute2DFiniteStrain::initialSetup().

_mechanical_strain

MaterialProperty<RankTwoTensor>& ComputeStrainBase::_mechanical_strain

protected

Definition at line 46 of file ComputeStrainBase.h.

Referenced by ComputeSmallStrain::computeProperties(), ComputeIncrementalSmallStrain::computeProperties(), Compute1DSmallStrain::computeProperties(), ComputeRSphericalSmallStrain::computeProperties(), Compute2DSmallStrain::computeProperties(), ComputeCosseratSmallStrain::computeQpProperties(), ComputeCosseratIncrementalSmallStrain::computeQpProperties(), ComputeCrackTipEnrichmentSmallStrain::computeQpProperties(), ComputeFiniteStrain::computeQpStrain(), ComputeIncrementalStrainBase::initQpStatefulProperties(), and initQpStatefulProperties().

_ndisp

unsigned int ComputeStrainBase::_ndisp

protected

Coupled displacement variables.

Definition at line 40 of file ComputeStrainBase.h.

Referenced by ComputeCrackTipEnrichmentSmallStrain::ComputeCrackTipEnrichmentSmallStrain(), ComputeCrackTipEnrichmentSmallStrain::computeQpProperties(), ComputeStrainBase(), Compute2DIncrementalStrain::displacementIntegrityCheck(), Compute2DSmallStrain::displacementIntegrityCheck(), displacementIntegrityCheck(), Compute2DFiniteStrain::displacementIntegrityCheck(), ComputeIncrementalStrainBase::initialSetup(), and initialSetup().

_total_strain

MaterialProperty<RankTwoTensor>& ComputeStrainBase::_total_strain

protected

Definition at line 48 of file ComputeStrainBase.h.

Referenced by ComputeSmallStrain::computeProperties(), ComputeIncrementalSmallStrain::computeProperties(), Compute1DSmallStrain::computeProperties(), ComputeRSphericalSmallStrain::computeProperties(), Compute2DSmallStrain::computeProperties(), ComputeCosseratSmallStrain::computeQpProperties(), ComputeCosseratIncrementalSmallStrain::computeQpProperties(), ComputeCrackTipEnrichmentSmallStrain::computeQpProperties(), ComputeFiniteStrain::computeQpStrain(), ComputeIncrementalStrainBase::initQpStatefulProperties(), and initQpStatefulProperties().

_volumetric_locking_correction

const bool ComputeStrainBase::_volumetric_locking_correction

protected

Definition at line 55 of file ComputeStrainBase.h.

Referenced by ComputeFiniteStrain::computeProperties(), ComputeSmallStrain::computeProperties(), ComputeIncrementalSmallStrain::computeProperties(), Compute2DSmallStrain::computeProperties(), Compute2DFiniteStrain::computeProperties(), and ComputeStrainBase().

---

The documentation for this class was generated from the following files:

• tensor_mechanics/include/materials/ComputeStrainBase.h
• tensor_mechanics/src/materials/ComputeStrainBase.C