ComputePlaneIncrementalStrain defines strain increment for small strains in a 2D planar simulation. More...

#include <ComputePlaneIncrementalStrain.h>

Inheritance diagram for ComputePlaneIncrementalStrain:

Public Member Functions
	ComputePlaneIncrementalStrain (const InputParameters &parameters)

void	initialSetup () override

virtual void	computeProperties () override

Static Public Member Functions
static InputParameters	validParams ()

Protected Member Functions
virtual Real	computeOutOfPlaneGradDisp () override
	Computes the current out-of-plane component of the displacement gradient; as a virtual function, this function is overwritten for the specific geometries defined by inheriting classes. More...

virtual Real	computeOutOfPlaneGradDispOld () override
	Computes the old out-of-plane component of the displacement gradient; as a virtual function, this function is overwritten for the specific geometries defined by inheriting classes. More...

unsigned int	getCurrentSubblockIndex () const
	gets its subblock index for current element More...

virtual void	displacementIntegrityCheck () override

virtual void	computeTotalStrainIncrement (RankTwoTensor &total_strain_increment) override
	Computes the current and old deformation gradients with the assumptions for 2D geometries, including plane strain, generalized plane strain, and axisymmetric, and returns the total strain increment tensor. More...

virtual void	initQpStatefulProperties () override

void	subtractEigenstrainIncrementFromStrain (RankTwoTensor &strain)

Protected Attributes
const SubblockIndexProvider *	_subblock_id_provider

const bool	_scalar_out_of_plane_strain_coupled

unsigned int	_nscalar_strains

std::vector< const VariableValue * >	_scalar_out_of_plane_strain

std::vector< const VariableValue * >	_scalar_out_of_plane_strain_old

const bool	_out_of_plane_strain_coupled

const VariableValue &	_out_of_plane_strain

const VariableValue &	_out_of_plane_strain_old

const unsigned int	_out_of_plane_direction

std::vector< const VariableGradient * >	_grad_disp_old

MaterialProperty< RankTwoTensor > &	_strain_rate

MaterialProperty< RankTwoTensor > &	_strain_increment

MaterialProperty< RankTwoTensor > &	_rotation_increment

MaterialProperty< RankTwoTensor > &	_deformation_gradient

const MaterialProperty< RankTwoTensor > &	_mechanical_strain_old

const MaterialProperty< RankTwoTensor > &	_total_strain_old

std::vector< const MaterialProperty< RankTwoTensor > * >	_eigenstrains_old

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

ComputePlaneIncrementalStrain defines strain increment for small strains in a 2D planar simulation.

Definition at line 24 of file ComputePlaneIncrementalStrain.h.

Constructor & Destructor Documentation

◆ ComputePlaneIncrementalStrain()

ComputePlaneIncrementalStrain::ComputePlaneIncrementalStrain ( const InputParameters & parameters )

Definition at line 31 of file ComputePlaneIncrementalStrain.C.

   : Compute2DIncrementalStrain(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")),
     _nscalar_strains(coupledScalarComponents("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),
     _out_of_plane_strain_old(_out_of_plane_strain_coupled ? coupledValueOld("out_of_plane_strain")
                                                           : _zero)
 {
   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);
     _scalar_out_of_plane_strain_old.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);
       _scalar_out_of_plane_strain_old[i] = &coupledScalarValueOld("scalar_out_of_plane_strain", i);
     }
   }
 }

Member Function Documentation

◆ computeOutOfPlaneGradDisp()

Real ComputePlaneIncrementalStrain::computeOutOfPlaneGradDisp ( )

overrideprotectedvirtual

Computes the current out-of-plane component of the displacement gradient; as a virtual function, this function is overwritten for the specific geometries defined by inheriting classes.

Implements Compute2DIncrementalStrain.

Definition at line 60 of file ComputePlaneIncrementalStrain.C.

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

◆ computeOutOfPlaneGradDispOld()

Real ComputePlaneIncrementalStrain::computeOutOfPlaneGradDispOld ( )

overrideprotectedvirtual

Computes the old out-of-plane component of the displacement gradient; as a virtual function, this function is overwritten for the specific geometries defined by inheriting classes.

Implements Compute2DIncrementalStrain.

Definition at line 69 of file ComputePlaneIncrementalStrain.C.

 {
   if (_scalar_out_of_plane_strain_coupled)
     return (*_scalar_out_of_plane_strain_old[getCurrentSubblockIndex()])[0];
   else
     return _out_of_plane_strain_old[_qp];
 }

◆ computeProperties()

void ComputeIncrementalSmallStrain::computeProperties ( )

overridevirtualinherited

Definition at line 33 of file ComputeIncrementalSmallStrain.C.

 {
   Real volumetric_strain = 0.0;
   for (_qp = 0; _qp < _qrule->n_points(); ++_qp)
   {
     RankTwoTensor total_strain_increment;
     computeTotalStrainIncrement(total_strain_increment);
  
     _strain_increment[_qp] = total_strain_increment;
  
     if (_volumetric_locking_correction)
       volumetric_strain += total_strain_increment.trace() * _JxW[_qp] * _coord[_qp];
   }
   if (_volumetric_locking_correction)
     volumetric_strain /= _current_elem_volume;
  
   for (_qp = 0; _qp < _qrule->n_points(); ++_qp)
   {
     Real trace = _strain_increment[_qp].trace();
     if (_volumetric_locking_correction)
     {
       _strain_increment[_qp](0, 0) += (volumetric_strain - trace) / 3.0;
       _strain_increment[_qp](1, 1) += (volumetric_strain - trace) / 3.0;
       _strain_increment[_qp](2, 2) += (volumetric_strain - trace) / 3.0;
     }
  
     _total_strain[_qp] = _total_strain_old[_qp] + _strain_increment[_qp];
  
     // Remove the Eigen strain increment
     subtractEigenstrainIncrementFromStrain(_strain_increment[_qp]);
  
     // strain rate
     if (_dt > 0)
       _strain_rate[_qp] = _strain_increment[_qp] / _dt;
     else
       _strain_rate[_qp].zero();
  
     // Update strain in intermediate configuration: rotations are not needed
     _mechanical_strain[_qp] = _mechanical_strain_old[_qp] + _strain_increment[_qp];
  
     // incremental small strain does not include rotation
     _rotation_increment[_qp].setToIdentity();
   }
 }

◆ computeTotalStrainIncrement()

void Compute2DIncrementalStrain::computeTotalStrainIncrement ( RankTwoTensor & total_strain_increment )

overrideprotectedvirtualinherited

Computes the current and old deformation gradients with the assumptions for 2D geometries, including plane strain, generalized plane strain, and axisymmetric, and returns the total strain increment tensor.

Reimplemented from ComputeIncrementalSmallStrain.

Definition at line 58 of file Compute2DIncrementalStrain.C.

 {
   // Deformation gradient calculation for 2D problems
   RankTwoTensor A(
       (*_grad_disp[0])[_qp], (*_grad_disp[1])[_qp], (*_grad_disp[2])[_qp]); // Deformation gradient
   RankTwoTensor Fbar((*_grad_disp_old[0])[_qp],
                      (*_grad_disp_old[1])[_qp],
                      (*_grad_disp_old[2])[_qp]); // Old Deformation gradient
  
   // Compute the displacement gradient of the out of plane direction for plane strain,
   // generalized plane strain, or axisymmetric problems
   A(_out_of_plane_direction, _out_of_plane_direction) = computeOutOfPlaneGradDisp();
   Fbar(_out_of_plane_direction, _out_of_plane_direction) = computeOutOfPlaneGradDispOld();
  
   _deformation_gradient[_qp] = A;
   _deformation_gradient[_qp].addIa(1.0);
  
   A -= Fbar; // very nearly A = gradU - gradUold
  
   total_strain_increment = 0.5 * (A + A.transpose());
 }

◆ displacementIntegrityCheck()

void Compute2DIncrementalStrain::displacementIntegrityCheck ( )

overrideprotectedvirtualinherited

Reimplemented from ComputeStrainBase.

Definition at line 81 of file Compute2DIncrementalStrain.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.");
 }

◆ getCurrentSubblockIndex()

unsigned int ComputePlaneIncrementalStrain::getCurrentSubblockIndex ( ) const

inlineprotected

gets its subblock index for current element

Definition at line 36 of file ComputePlaneIncrementalStrain.h.

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

Referenced by computeOutOfPlaneGradDisp(), and computeOutOfPlaneGradDispOld().

◆ initialSetup()

void Compute2DIncrementalStrain::initialSetup ( )

overrideinherited

Definition at line 35 of file Compute2DIncrementalStrain.C.

 {
   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);
     }
  
     if (_fe_problem.isTransient() && i != _out_of_plane_direction)
       _grad_disp_old[i] = &coupledGradientOld("displacements", i);
     else
       _grad_disp_old[i] = &_grad_zero;
   }
 }

◆ initQpStatefulProperties()

void ComputeIncrementalStrainBase::initQpStatefulProperties ( )

overrideprotectedvirtualinherited

Reimplemented from ComputeStrainBase.

Reimplemented in ComputeCosseratIncrementalSmallStrain.

Definition at line 51 of file ComputeIncrementalStrainBase.C.

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

Referenced by ComputeCosseratIncrementalSmallStrain::initQpStatefulProperties().

◆ subtractEigenstrainIncrementFromStrain()

void ComputeIncrementalStrainBase::subtractEigenstrainIncrementFromStrain ( RankTwoTensor & strain )

protectedinherited

Definition at line 59 of file ComputeIncrementalStrainBase.C.

 {
   for (unsigned int i = 0; i < _eigenstrains.size(); ++i)
   {
     strain -= (*_eigenstrains[i])[_qp];
     strain += (*_eigenstrains_old[i])[_qp];
   }
 }

Referenced by ComputeIncrementalSmallStrain::computeProperties(), ComputeCosseratIncrementalSmallStrain::computeQpProperties(), and ComputeFiniteStrain::computeQpStrain().

◆ validParams()

InputParameters ComputePlaneIncrementalStrain::validParams ( )

static

Definition at line 17 of file ComputePlaneIncrementalStrain.C.

 {
   InputParameters params = Compute2DIncrementalStrain::validParams();
   params.addClassDescription(
       "Compute strain increment for small strain under 2D planar assumptions.");
   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;
 }