ComputePlaneSmallStrain Class Reference

ComputePlaneSmallStrain defines small strains under generalized plane strain and plane stress assumptions, where the out of plane strain can be uniformly or non-uniformly zero or nonzero. More...

#include <ComputePlaneSmallStrain.h>

Inheritance diagram for ComputePlaneSmallStrain:

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

Static Public Member Functions
static InputParameters	validParams ()

Protected Member Functions
virtual Real	computeOutOfPlaneStrain ()
unsigned int	getCurrentSubblockIndex () const
	gets its subblock index for current element More...
virtual void	computeProperties () override
virtual void	displacementIntegrityCheck () override
virtual void	initQpStatefulProperties () override

Protected Attributes
const SubblockIndexProvider *	_subblock_id_provider
const unsigned int	_out_of_plane_direction
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

Private Attributes
const bool	_scalar_out_of_plane_strain_coupled
const bool	_out_of_plane_strain_coupled
const VariableValue &	_out_of_plane_strain
unsigned int	_nscalar_strains
std::vector< const VariableValue * >	_scalar_out_of_plane_strain

Detailed Description

ComputePlaneSmallStrain defines small strains under generalized plane strain and plane stress assumptions, where the out of plane strain can be uniformly or non-uniformly zero or nonzero.

Definition at line 25 of file ComputePlaneSmallStrain.h.

Constructor & Destructor Documentation

ComputePlaneSmallStrain()

ComputePlaneSmallStrain::ComputePlaneSmallStrain

(

const InputParameters &

parameters

)

Definition at line 31 of file ComputePlaneSmallStrain.C.

  : Compute2DSmallStrain(parameters),
    _subblock_id_provider(isParamValid("subblock_index_provider")
                              ? &getUserObject<SubblockIndexProvider>("subblock_index_provider")
                              : nullptr),
    _scalar_out_of_plane_strain_coupled(isParamValid("scalar_out_of_plane_strain")),
    _out_of_plane_strain_coupled(isCoupled("out_of_plane_strain")),
    _out_of_plane_strain(_out_of_plane_strain_coupled ? coupledValue("out_of_plane_strain")
                                                      : _zero),
    _nscalar_strains(coupledScalarComponents("scalar_out_of_plane_strain"))
{
  if (_out_of_plane_strain_coupled && _scalar_out_of_plane_strain_coupled)
    mooseError("Must define only one of out_of_plane_strain or scalar_out_of_plane_strain");
 
  if (_scalar_out_of_plane_strain_coupled)
  {
    _scalar_out_of_plane_strain.resize(_nscalar_strains);
    for (unsigned int i = 0; i < _nscalar_strains; ++i)
      _scalar_out_of_plane_strain[i] = &coupledScalarValue("scalar_out_of_plane_strain", i);
  }
}

Member Function Documentation

computeOutOfPlaneStrain()

Real ComputePlaneSmallStrain::computeOutOfPlaneStrain ( )

protectedvirtual

Implements Compute2DSmallStrain.

Definition at line 54 of file ComputePlaneSmallStrain.C.

{
  if (_scalar_out_of_plane_strain_coupled)
    return (*_scalar_out_of_plane_strain[getCurrentSubblockIndex()])[0];
  else
    return _out_of_plane_strain[_qp];
}

computeProperties()

void Compute2DSmallStrain::computeProperties ( )

overrideprotectedvirtualinherited

Reimplemented from ComputeSmallStrain.

Definition at line 54 of file Compute2DSmallStrain.C.

{
  const auto o0 = _out_of_plane_direction;
  const auto o1 = (_out_of_plane_direction + 1) % 3;
  const auto o2 = (_out_of_plane_direction + 2) % 3;
 
  Real volumetric_strain = 0.0;
  for (_qp = 0; _qp < _qrule->n_points(); ++_qp)
  {
    _total_strain[_qp](o0, o0) = computeOutOfPlaneStrain();
    _total_strain[_qp](o1, o1) = (*_grad_disp[o1])[_qp](o1);
    _total_strain[_qp](o2, o2) = (*_grad_disp[o2])[_qp](o2);
    _total_strain[_qp](o1, o2) = ((*_grad_disp[o1])[_qp](o2) + (*_grad_disp[o2])[_qp](o1)) / 2.0;
    _total_strain[_qp](o2, o1) = _total_strain[_qp](o1, o2); // force the symmetrical strain tensor
 
    if (_volumetric_locking_correction)
      volumetric_strain += _total_strain[_qp].trace() * _JxW[_qp] * _coord[_qp];
  }
 
  if (_volumetric_locking_correction)
    volumetric_strain /= _current_elem_volume;
 
  for (_qp = 0; _qp < _qrule->n_points(); ++_qp)
  {
    if (_volumetric_locking_correction)
    {
      const Real correction = (volumetric_strain - _total_strain[_qp].trace()) / 3.0;
      _total_strain[_qp](0, 0) += correction;
      _total_strain[_qp](1, 1) += correction;
      _total_strain[_qp](2, 2) += correction;
    }
 
    _mechanical_strain[_qp] = _total_strain[_qp];
 
    // Remove the eigenstrains
    for (const auto es : _eigenstrains)
      _mechanical_strain[_qp] -= (*es)[_qp];
  }
}

displacementIntegrityCheck()

void Compute2DSmallStrain::displacementIntegrityCheck ( )

overrideprotectedvirtualinherited

Reimplemented from ComputeStrainBase.

Definition at line 95 of file Compute2DSmallStrain.C.

{
  if (_out_of_plane_direction != 2 && _ndisp != 3)
    mooseError("For 2D simulations where the out-of-plane direction is x or y the number of "
               "supplied displacements must be three.");
  else if (_out_of_plane_direction == 2 && _ndisp != 2)
    mooseError("For 2D simulations where the out-of-plane direction is z the number of supplied "
               "displacements must be two.");
}

Referenced by Compute2DSmallStrain::initialSetup().

getCurrentSubblockIndex()

unsigned int ComputePlaneSmallStrain::getCurrentSubblockIndex ( ) const

inlineprotected

gets its subblock index for current element

Definition at line 36 of file ComputePlaneSmallStrain.h.

  {
    return _subblock_id_provider ? _subblock_id_provider->getSubblockIndex(*_current_elem) : 0;
  };

Referenced by computeOutOfPlaneStrain().

initialSetup()

void Compute2DSmallStrain::initialSetup ( )

overrideinherited

Definition at line 35 of file Compute2DSmallStrain.C.

{
  displacementIntegrityCheck();
  for (unsigned int i = 0; i < 3; ++i)
  {
    if (_out_of_plane_direction == i)
    {
      _disp[i] = &_zero;
      _grad_disp[i] = &_grad_zero;
    }
    else
    {
      _disp[i] = &coupledValue("displacements", i);
      _grad_disp[i] = &coupledGradient("displacements", i);
    }
  }
}

Referenced by ComputeAxisymmetricRZSmallStrain::initialSetup().

initQpStatefulProperties()

void ComputeStrainBase::initQpStatefulProperties ( )

overrideprotectedvirtualinherited

Reimplemented in ComputeIncrementalStrainBase, and ComputeCosseratIncrementalSmallStrain.

Definition at line 104 of file ComputeStrainBase.C.

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

validParams()

InputParameters ComputePlaneSmallStrain::validParams ( )

static

Definition at line 17 of file ComputePlaneSmallStrain.C.

{
  InputParameters params = Compute2DSmallStrain::validParams();
  params.addClassDescription("Compute a small strain under generalized plane strain assumptions "
                             "where the out of plane strain is generally nonzero.");
  params.addParam<UserObjectName>("subblock_index_provider",
                                  "SubblockIndexProvider user object name");
  params.addCoupledVar("scalar_out_of_plane_strain",
                       "Scalar variable for generalized plane strain");
  params.addCoupledVar("out_of_plane_strain", "Nonlinear variable for plane stress condition");
 
  return params;
}

Member Data Documentation

_base_name

const std::string ComputeStrainBase::_base_name

protectedinherited

Definition at line 44 of file ComputeStrainBase.h.

Referenced by ComputeStrainBase::ComputeStrainBase().

_current_elem_volume

const Real& ComputeStrainBase::_current_elem_volume

protectedinherited

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

protectedinherited

Definition at line 41 of file ComputeStrainBase.h.

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

_eigenstrain_names

std::vector<MaterialPropertyName> ComputeStrainBase::_eigenstrain_names

protectedinherited

Definition at line 50 of file ComputeStrainBase.h.

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

_eigenstrains

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

protectedinherited

Definition at line 51 of file ComputeStrainBase.h.

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

_global_strain

const MaterialProperty<RankTwoTensor>* ComputeStrainBase::_global_strain

protectedinherited

Definition at line 53 of file ComputeStrainBase.h.

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

_grad_disp

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

protectedinherited

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(), Compute2DFiniteStrain::initialSetup(), Compute2DIncrementalStrain::initialSetup(), and ComputeStrainBase::initialSetup().

_mechanical_strain

MaterialProperty<RankTwoTensor>& ComputeStrainBase::_mechanical_strain

protectedinherited

Definition at line 46 of file ComputeStrainBase.h.

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

_ndisp

unsigned int ComputeStrainBase::_ndisp

protectedinherited

Coupled displacement variables.

Definition at line 40 of file ComputeStrainBase.h.

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

_nscalar_strains

unsigned int ComputePlaneSmallStrain::_nscalar_strains

private

Definition at line 48 of file ComputePlaneSmallStrain.h.

Referenced by ComputePlaneSmallStrain().

_out_of_plane_direction

const unsigned int Compute2DSmallStrain::_out_of_plane_direction

protectedinherited

Definition at line 39 of file Compute2DSmallStrain.h.

Referenced by Compute2DSmallStrain::computeProperties(), Compute2DSmallStrain::displacementIntegrityCheck(), ComputeAxisymmetricRZSmallStrain::initialSetup(), and Compute2DSmallStrain::initialSetup().

_out_of_plane_strain

const VariableValue& ComputePlaneSmallStrain::_out_of_plane_strain

private

Definition at line 47 of file ComputePlaneSmallStrain.h.

Referenced by computeOutOfPlaneStrain().

_out_of_plane_strain_coupled

const bool ComputePlaneSmallStrain::_out_of_plane_strain_coupled

private

Definition at line 46 of file ComputePlaneSmallStrain.h.

Referenced by ComputePlaneSmallStrain().

_scalar_out_of_plane_strain

std::vector<const VariableValue *> ComputePlaneSmallStrain::_scalar_out_of_plane_strain

private

Definition at line 49 of file ComputePlaneSmallStrain.h.

Referenced by computeOutOfPlaneStrain(), and ComputePlaneSmallStrain().

_scalar_out_of_plane_strain_coupled

const bool ComputePlaneSmallStrain::_scalar_out_of_plane_strain_coupled

private

Definition at line 44 of file ComputePlaneSmallStrain.h.

Referenced by computeOutOfPlaneStrain(), and ComputePlaneSmallStrain().

_subblock_id_provider

const SubblockIndexProvider* ComputePlaneSmallStrain::_subblock_id_provider

protected

Definition at line 39 of file ComputePlaneSmallStrain.h.

Referenced by getCurrentSubblockIndex().

_total_strain

MaterialProperty<RankTwoTensor>& ComputeStrainBase::_total_strain

protectedinherited

Definition at line 48 of file ComputeStrainBase.h.

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

_volumetric_locking_correction

const bool ComputeStrainBase::_volumetric_locking_correction

protectedinherited

Definition at line 55 of file ComputeStrainBase.h.

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

---

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

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