Scalar damage model for which the damage is prescribed by another material. More...

#include <ScalarMaterialDamage.h>

Inheritance diagram for ScalarMaterialDamage:

Public Member Functions
	ScalarMaterialDamage (const InputParameters &parameters)

virtual void	initQpStatefulProperties () override

virtual void	updateDamage () override
	Update the internal variable(s) that evolve the damage. More...

virtual void	updateStressForDamage (RankTwoTensor &stress_new) override
	Update the current stress tensor for effects of damage. More...

virtual void	updateJacobianMultForDamage (RankFourTensor &jacobian_mult) override
	Update the material constitutive matrix. More...

virtual void	computeUndamagedOldStress (RankTwoTensor &stress_old) override

virtual Real	computeTimeStepLimit () override
	Compute the limiting value of the time step for this material. More...

const Real &	getQpDamageIndex (unsigned int qp)

const std::string	getDamageIndexName () const

virtual void	finiteStrainRotation (const RankTwoTensor &rotation_increment)
	Perform any necessary rotation of internal variables for finite strain. More...

void	setQp (unsigned int qp)
	Sets the value of the member variable _qp for use in inheriting classes. More...


void	resetQpProperties () final
	Retained as empty methods to avoid a warning from Material.C in framework. These methods are unused in all inheriting classes and should not be overwritten. More...

void	resetProperties () final

Static Public Member Functions
static InputParameters	validParams ()

Protected Member Functions
virtual void	updateQpDamageIndex () override
	Update the damage index at the current qpoint. More...

Protected Attributes
const std::string	_damage_index_name
	Name of the material property where the damage index is stored. More...

const bool	_use_old_damage
	If true, use the damage index from the old state (rather than the current state) More...

const Real &	_residual_stiffness_fraction
	Residual fraction of stiffness used for material that is fully damaged. More...

const Real &	_maximum_damage_increment
	Maximum damage increment allowed for the time step. More...

const std::string	_base_name
	Base name optionally used as prefix to material tensor names. More...


const MaterialProperty< Real > &	_damage_property
	Material property that provides the damage index. More...


MaterialProperty< Real > &	_damage_index
	Material property that provides the damage index. More...

const MaterialProperty< Real > &	_damage_index_old

const MaterialProperty< Real > &	_damage_index_older

Detailed Description

Scalar damage model for which the damage is prescribed by another material.

Definition at line 23 of file ScalarMaterialDamage.h.

Constructor & Destructor Documentation

◆ ScalarMaterialDamage()

ScalarMaterialDamage::ScalarMaterialDamage ( const InputParameters & parameters )

Definition at line 29 of file ScalarMaterialDamage.C.

   : ScalarDamageBase(parameters),
     _damage_property(
         getMaterialPropertyByName<Real>(getParam<MaterialPropertyName>("damage_index")))
 {
 }

Member Function Documentation

◆ computeTimeStepLimit()

Real ScalarDamageBase::computeTimeStepLimit ( )

overridevirtualinherited

Compute the limiting value of the time step for this material.

Returns: Limiting time step

Reimplemented from DamageBase.

Definition at line 100 of file ScalarDamageBase.C.

 {
   Real current_damage_increment = (_damage_index[_qp] - _damage_index_old[_qp]);
   if (MooseUtils::absoluteFuzzyEqual(current_damage_increment, 0.0))
     return std::numeric_limits<Real>::max();
  
   return _dt * _maximum_damage_increment / current_damage_increment;
 }

◆ computeUndamagedOldStress()

void ScalarDamageBase::computeUndamagedOldStress ( RankTwoTensor & stress_old )

overridevirtualinherited

Implements DamageBase.

Definition at line 83 of file ScalarDamageBase.C.

 {
   Real damage_index_old =
       std::max((1.0 - (_use_old_damage ? _damage_index_older[_qp] : _damage_index_old[_qp])), 0.0);
  
   if (damage_index_old > 0.0)
     stress_old /= damage_index_old;
 }

◆ finiteStrainRotation()

void DamageBase::finiteStrainRotation ( const RankTwoTensor & rotation_increment )

virtualinherited

Perform any necessary rotation of internal variables for finite strain.

Parameters

rotation_increment The finite-strain rotation increment

Definition at line 57 of file DamageBase.C.

58 {

59 }

Referenced by ComputeDamageStress::computeQpStress(), and ComputeMultipleInelasticStress::computeQpStress().

◆ getDamageIndexName()

const std::string ScalarDamageBase::getDamageIndexName ( ) const

inlineinherited

Definition at line 44 of file ScalarDamageBase.h.

44 { return _damage_index_name; }

◆ getQpDamageIndex()

const Real & ScalarDamageBase::getQpDamageIndex ( unsigned int qp )

inherited

Definition at line 60 of file ScalarDamageBase.C.

 {
   setQp(qp);
   updateQpDamageIndex();
   return _damage_index[_qp];
 }

Referenced by CombinedScalarDamage::updateQpDamageIndex().

◆ initQpStatefulProperties()

void ScalarDamageBase::initQpStatefulProperties ( )

overridevirtualinherited

Definition at line 54 of file ScalarDamageBase.C.

 {
   _damage_index[_qp] = 0.0;
 }

◆ resetProperties()

void DamageBase::resetProperties ( )

inlinefinalinherited

Definition at line 72 of file DamageBase.h.

72 {}

◆ resetQpProperties()

void DamageBase::resetQpProperties ( )

inlinefinalinherited

Retained as empty methods to avoid a warning from Material.C in framework. These methods are unused in all inheriting classes and should not be overwritten.

Definition at line 71 of file DamageBase.h.

71 {}

◆ setQp()

void DamageBase::setQp ( unsigned int qp )

inherited

Sets the value of the member variable _qp for use in inheriting classes.

Definition at line 40 of file DamageBase.C.

 {
   _qp = qp;
 }

Referenced by ComputeDamageStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStress(), and ScalarDamageBase::getQpDamageIndex().

◆ updateDamage()

void ScalarDamageBase::updateDamage ( )

overridevirtualinherited

Update the internal variable(s) that evolve the damage.

Reimplemented from DamageBase.

Definition at line 68 of file ScalarDamageBase.C.

 {
   updateQpDamageIndex();
 }

◆ updateJacobianMultForDamage()

void ScalarDamageBase::updateJacobianMultForDamage ( RankFourTensor & jacobian_mult )

overridevirtualinherited

Update the material constitutive matrix.

Parameters

jacobian_mult Material constitutive matrix to be modified for effects of damage

Implements DamageBase.

Definition at line 93 of file ScalarDamageBase.C.

 {
   jacobian_mult *= std::max((1.0 - (_use_old_damage ? _damage_index_old[_qp] : _damage_index[_qp])),
                             _residual_stiffness_fraction);
 }

◆ updateQpDamageIndex()

void ScalarMaterialDamage::updateQpDamageIndex ( )

overrideprotectedvirtual

Update the damage index at the current qpoint.

Implements ScalarDamageBase.

Definition at line 37 of file ScalarMaterialDamage.C.

 {
   _damage_index[_qp] = _damage_property[_qp];
  
   if (MooseUtils::absoluteFuzzyLessThan(_damage_index[_qp], 0.0) ||
       MooseUtils::absoluteFuzzyGreaterThan(_damage_index[_qp], 1.0))
     mooseError(_base_name + "damage_index ",
                "must be between 0 and 1. Current value is: ",
                _damage_index[_qp]);
 }

◆ updateStressForDamage()

void ScalarDamageBase::updateStressForDamage ( RankTwoTensor & stress_new )

overridevirtualinherited

Update the current stress tensor for effects of damage.

Parameters

stress_new Undamaged stress to be modified by the damage model

Implements DamageBase.

Definition at line 74 of file ScalarDamageBase.C.

 {
   // Avoid multiplying by a small negative number, which could occur if damage_index
   // is slightly greater than 1.0
   stress_new *=
       std::max((1.0 - (_use_old_damage ? _damage_index_old[_qp] : _damage_index[_qp])), 0.0);
 }

◆ validParams()

InputParameters ScalarMaterialDamage::validParams ( )

static

Definition at line 17 of file ScalarMaterialDamage.C.

 {
   InputParameters params = ScalarDamageBase::validParams();
   params.addClassDescription(
       "Scalar damage model for which the damage is prescribed by another material");
   params.addRequiredParam<MaterialPropertyName>("damage_index",
                                                 "Name of the material property containing the "
                                                 "damage index, which goes from 0 (undamaged) to 1 "
                                                 "(fully damaged)");
   return params;
 }

Member Data Documentation

◆ _base_name

const std::string DamageBase::_base_name

protectedinherited

Base name optionally used as prefix to material tensor names.

Definition at line 77 of file DamageBase.h.

Referenced by updateQpDamageIndex().

◆ _damage_index

MaterialProperty<Real>& ScalarDamageBase::_damage_index

protectedinherited

Material property that provides the damage index.

Definition at line 54 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::computeTimeStepLimit(), ScalarDamageBase::getQpDamageIndex(), ScalarDamageBase::initQpStatefulProperties(), ScalarDamageBase::updateJacobianMultForDamage(), updateQpDamageIndex(), CombinedScalarDamage::updateQpDamageIndex(), and ScalarDamageBase::updateStressForDamage().

◆ _damage_index_name

const std::string ScalarDamageBase::_damage_index_name

protectedinherited

Name of the material property where the damage index is stored.

Definition at line 48 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::getDamageIndexName().

◆ _damage_index_old

const MaterialProperty<Real>& ScalarDamageBase::_damage_index_old

protectedinherited

Definition at line 55 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::computeTimeStepLimit(), ScalarDamageBase::computeUndamagedOldStress(), ScalarDamageBase::updateJacobianMultForDamage(), CombinedScalarDamage::updateQpDamageIndex(), and ScalarDamageBase::updateStressForDamage().

◆ _damage_index_older

const MaterialProperty<Real>& ScalarDamageBase::_damage_index_older

protectedinherited

Definition at line 56 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::computeUndamagedOldStress().

◆ _damage_property

const MaterialProperty<Real>& ScalarMaterialDamage::_damage_property

protected

Material property that provides the damage index.

Definition at line 34 of file ScalarMaterialDamage.h.

Referenced by updateQpDamageIndex().

◆ _maximum_damage_increment

const Real& ScalarDamageBase::_maximum_damage_increment

protectedinherited

Maximum damage increment allowed for the time step.

Definition at line 66 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::computeTimeStepLimit().

◆ _residual_stiffness_fraction

const Real& ScalarDamageBase::_residual_stiffness_fraction

protectedinherited

Residual fraction of stiffness used for material that is fully damaged.

Definition at line 63 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::updateJacobianMultForDamage().

◆ _use_old_damage

const bool ScalarDamageBase::_use_old_damage

protectedinherited

If true, use the damage index from the old state (rather than the current state)

Definition at line 60 of file ScalarDamageBase.h.

Referenced by ScalarDamageBase::computeUndamagedOldStress(), ScalarDamageBase::updateJacobianMultForDamage(), and ScalarDamageBase::updateStressForDamage().

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

tensor_mechanics/include/materials/ScalarMaterialDamage.h
tensor_mechanics/src/materials/ScalarMaterialDamage.C

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ScalarMaterialDamage()

Member Function Documentation

◆ computeTimeStepLimit()

◆ computeUndamagedOldStress()

◆ finiteStrainRotation()

◆ getDamageIndexName()

◆ getQpDamageIndex()

◆ initQpStatefulProperties()

◆ resetProperties()

◆ resetQpProperties()

◆ setQp()

◆ updateDamage()

◆ updateJacobianMultForDamage()

◆ updateQpDamageIndex()

◆ updateStressForDamage()

◆ validParams()

Member Data Documentation

◆ _base_name

◆ _damage_index

◆ _damage_index_name

◆ _damage_index_old

◆ _damage_index_older

◆ _damage_property

◆ _maximum_damage_increment

◆ _residual_stiffness_fraction

◆ _use_old_damage