ComputeMultipleInelasticStress computes the stress, the consistent tangent operator (or an approximation to it), and a decomposition of the strain into elastic and inelastic parts. More...

#include <ComputeMultipleInelasticCosseratStress.h>

Inheritance diagram for ComputeMultipleInelasticCosseratStress:

[legend]

Public Member Functions
	ComputeMultipleInelasticCosseratStress (const InputParameters &parameters)

virtual void	initialSetup () override

Static Public Member Functions
static InputParameters	validParams ()

Protected Types
enum	TangentOperatorEnum { TangentOperatorEnum::elastic, TangentOperatorEnum::nonlinear }
	what sort of Tangent operator to calculate More...

Protected Member Functions
virtual void	initQpStatefulProperties () override

virtual void	computeQpStress () override
	Compute the stress and store it in the _stress material property for the current quadrature point. More...

virtual void	computeQpJacobianMult () override
	Using _elasticity_tensor[_qp] and the consistent tangent operators, _consistent_tangent_operator[...] computed by the inelastic models, compute _Jacobian_mult[_qp]. More...

virtual void	computeAdmissibleState (unsigned model_number, RankTwoTensor &elastic_strain_increment, RankTwoTensor &inelastic_strain_increment, RankFourTensor &consistent_tangent_operator) override
	The current Cosserat models do not know they might be using the "host" version of the elasticity tensor during the return-map process. More...

virtual void	computeQpStressIntermediateConfiguration ()
	Compute the stress for the current QP, but do not rotate tensors from the intermediate configuration to the new configuration. More...

virtual void	finiteStrainRotation (const bool force_elasticity_rotation=false)
	Rotate _elastic_strain, _stress, _inelastic_strain, and _Jacobian_mult to the new configuration. More...

virtual void	updateQpState (RankTwoTensor &elastic_strain_increment, RankTwoTensor &combined_inelastic_strain_increment)
	Given the _strain_increment[_qp], iterate over all of the user-specified recompute materials in order to find an admissible stress (which is placed into _stress[_qp]) and set of inelastic strains, as well as the tangent operator (which is placed into _Jacobian_mult[_qp]). More...

virtual void	updateQpStateSingleModel (unsigned model_number, RankTwoTensor &elastic_strain_increment, RankTwoTensor &combined_inelastic_strain_increment)
	An optimised version of updateQpState that gets used when the number of plastic models is unity, or when we're cycling through models Given the _strain_increment[_qp], find an admissible stress (which is put into _stress[_qp]) and inelastic strain, as well as the tangent operator (which is placed into _Jacobian_mult[_qp]) More...

virtual void	computeQpProperties () override

bool	hasGuaranteedMaterialProperty (const MaterialPropertyName &prop, Guarantee guarantee)

Protected Attributes
const MaterialProperty< RankTwoTensor > &	_curvature
	The Cosserat curvature strain. More...

const MaterialProperty< RankFourTensor > &	_elastic_flexural_rigidity_tensor
	The Cosserat elastic flexural rigidity tensor. More...

MaterialProperty< RankTwoTensor > &	_couple_stress
	the Cosserat couple-stress More...

const MaterialProperty< RankTwoTensor > &	_couple_stress_old
	the old value of Cosserat couple-stress More...

MaterialProperty< RankFourTensor > &	_Jacobian_mult_couple
	derivative of couple-stress w.r.t. curvature More...

const MaterialProperty< RankFourTensor > &	_compliance
	Inverse of the elasticity tensor. More...

const bool	_perform_finite_strain_rotations
	after updateQpState, rotate the stress, elastic_strain, inelastic_strain and Jacobian_mult using _rotation_increment More...

MaterialProperty< RankTwoTensor > &	_inelastic_strain
	The sum of the inelastic strains that come from the plastic models. More...

const MaterialProperty< RankTwoTensor > &	_inelastic_strain_old
	old value of inelastic strain More...

enum ComputeMultipleInelasticStress::TangentOperatorEnum	_tangent_operator_type

const unsigned	_num_models
	number of plastic models More...

std::vector< bool >	_tangent_computation_flag
	Flags to compute tangent during updateState call. More...

TangentCalculationMethod	_tangent_calculation_method
	Calculation method for the tangent modulus. More...

const std::vector< Real >	_inelastic_weights
	_inelastic_strain = sum_i (_inelastic_weights_i * inelastic_strain_from_model_i) More...

std::vector< RankFourTensor >	_consistent_tangent_operator
	the consistent tangent operators computed by each plastic model More...

const bool	_cycle_models
	whether to cycle through the models, using only one model per timestep More...

MaterialProperty< Real > &	_matl_timestep_limit

const RankFourTensor	_identity_symmetric_four
	Rank four symmetric identity tensor. More...

std::vector< StressUpdateBase * >	_models
	The user supplied list of inelastic models to use in the simulation. More...

bool	_is_elasticity_tensor_guaranteed_isotropic
	is the elasticity tensor guaranteed to be isotropic? More...

bool	_all_models_isotropic
	are all inelastic models inherently isotropic? (not the case for e.g. weak plane plasticity models) More...

DamageBase *	_damage_model
	Pointer to the damage model. More...

RankTwoTensor	_undamaged_stress_old

const std::string	_elasticity_tensor_name
	Name of the elasticity tensor material property. More...

const MaterialProperty< RankFourTensor > &	_elasticity_tensor
	Elasticity tensor material property. More...

const MaterialProperty< RankTwoTensor > &	_rotation_increment
	Rotation increment material property. More...

const MaterialProperty< RankTwoTensor > &	_stress_old
	Old state of the stress tensor material property. More...

const std::string	_base_name
	Base name prepended to all material property names to allow for multi-material systems. More...

const MaterialProperty< RankTwoTensor > &	_mechanical_strain
	Mechanical strain material property. More...

MaterialProperty< RankTwoTensor > &	_stress
	Stress material property. More...

MaterialProperty< RankTwoTensor > &	_elastic_strain
	Elastic strain material property. More...

const MaterialProperty< RankTwoTensor > &	_extra_stress
	Extra stress tensor. More...

std::vector< const Function * >	_initial_stress_fcn
	initial stress components More...

MaterialProperty< RankFourTensor > &	_Jacobian_mult
	derivative of stress w.r.t. strain (_dstress_dstrain) More...


const unsigned int	_max_iterations
	Input parameters associated with the recompute iteration to return the stress state to the yield surface. More...

const Real	_relative_tolerance

const Real	_absolute_tolerance

const bool	_internal_solve_full_iteration_history


const MaterialProperty< RankTwoTensor > &	_elastic_strain_old
	Strain tensors. More...

const MaterialProperty< RankTwoTensor > &	_strain_increment

Private Attributes
const InputParameters &	_gc_params
	Parameters of the object with this interface. More...

FEProblemBase *const	_gc_feproblem
	Reference to the FEProblemBase class. More...

BlockRestrictable *const	_gc_block_restrict
	Access block restrictions of the object with this interface. More...

Detailed Description

ComputeMultipleInelasticStress computes the stress, the consistent tangent operator (or an approximation to it), and a decomposition of the strain into elastic and inelastic parts.

By default finite strains are assumed.

Cosserat couple-stress, and the cosserat version of the consistent tangent operator are also computed, but only using Cosserat elasticity.

The elastic strain is calculated by subtracting the computed inelastic strain increment tensor from the mechanical strain tensor. Mechanical strain is considered as the sum of the elastic and inelastic (plastic, creep, ect) strains.

This material is used to call the recompute iterative materials of a number of specified inelastic models that inherit from StressUpdateBase. It iterates over the specified inelastic models until the change in stress is within a user-specified tolerance, in order to produce the stress, the consistent tangent operator and the elastic and inelastic strains for the time increment.

Definition at line 38 of file ComputeMultipleInelasticCosseratStress.h.

Member Enumeration Documentation

◆ TangentOperatorEnum

enum ComputeMultipleInelasticStress::TangentOperatorEnum

strongprotectedinherited

what sort of Tangent operator to calculate

Enumerator
elastic
nonlinear

Definition at line 143 of file ComputeMultipleInelasticStress.h.

143 { elastic, nonlinear } _tangent_operator_type;

Constructor & Destructor Documentation

◆ ComputeMultipleInelasticCosseratStress()

ComputeMultipleInelasticCosseratStress::ComputeMultipleInelasticCosseratStress ( const InputParameters & parameters )

Definition at line 28 of file ComputeMultipleInelasticCosseratStress.C.

   : ComputeMultipleInelasticStress(parameters),
     _curvature(getMaterialProperty<RankTwoTensor>("curvature")),
     _elastic_flexural_rigidity_tensor(
         getMaterialProperty<RankFourTensor>("elastic_flexural_rigidity_tensor")),
     _couple_stress(declareProperty<RankTwoTensor>("couple_stress")),
     _couple_stress_old(getMaterialPropertyOld<RankTwoTensor>("couple_stress")),
     _Jacobian_mult_couple(declareProperty<RankFourTensor>("couple_Jacobian_mult")),
     _compliance(getMaterialProperty<RankFourTensor>(_base_name + "compliance_tensor"))
 {
 }

Member Function Documentation

◆ computeAdmissibleState()

void ComputeMultipleInelasticCosseratStress::computeAdmissibleState	(	unsigned	model_number,
		RankTwoTensor &	elastic_strain_increment,
		RankTwoTensor &	inelastic_strain_increment,
		RankFourTensor &	consistent_tangent_operator
	)

overrideprotectedvirtual

The current Cosserat models do not know they might be using the "host" version of the elasticity tensor during the return-map process.

Therefore, they compute the incorrect elastic/inelastic strain decomposition. Overriding this method allows the correction to be made.

Reimplemented from ComputeMultipleInelasticStress.

Definition at line 80 of file ComputeMultipleInelasticCosseratStress.C.

 {
   const RankTwoTensor trial_stress = _stress[_qp];
   const RankTwoTensor applied_strain_increment = elastic_strain_increment;
  
   ComputeMultipleInelasticStress::computeAdmissibleState(model_number,
                                                          elastic_strain_increment,
                                                          inelastic_strain_increment,
                                                          consistent_tangent_operator);
  
   inelastic_strain_increment = _compliance[_qp] * (trial_stress - _stress[_qp]);
   elastic_strain_increment = applied_strain_increment - inelastic_strain_increment;
 }

◆ computeQpJacobianMult()

void ComputeMultipleInelasticCosseratStress::computeQpJacobianMult ( )

overrideprotectedvirtual

Using _elasticity_tensor[_qp] and the consistent tangent operators, _consistent_tangent_operator[...] computed by the inelastic models, compute _Jacobian_mult[_qp].

Reimplemented from ComputeMultipleInelasticStress.

Definition at line 66 of file ComputeMultipleInelasticCosseratStress.C.

 {
   if (_tangent_operator_type == TangentOperatorEnum::elastic)
     _Jacobian_mult[_qp] = _elasticity_tensor[_qp];
   else
   {
     _Jacobian_mult[_qp] = _consistent_tangent_operator[0];
     for (unsigned i_rmm = 1; i_rmm < _num_models; ++i_rmm)
       _Jacobian_mult[_qp] =
           _consistent_tangent_operator[i_rmm] * _compliance[_qp] * _Jacobian_mult[_qp];
   }
 }

◆ computeQpProperties()

void ComputeStressBase::computeQpProperties ( )

overrideprotectedvirtualinherited

Definition at line 50 of file ComputeStressBase.C.

 {
   computeQpStress();
  
   // Add in extra stress
   _stress[_qp] += _extra_stress[_qp];
 }

◆ computeQpStress()

void ComputeMultipleInelasticCosseratStress::computeQpStress ( )

overrideprotectedvirtual

Compute the stress and store it in the _stress material property for the current quadrature point.

Reimplemented from ComputeMultipleInelasticStress.

Definition at line 49 of file ComputeMultipleInelasticCosseratStress.C.

 {
   ComputeMultipleInelasticStress::computeQpStress();
  
   _couple_stress[_qp] = _elastic_flexural_rigidity_tensor[_qp] * _curvature[_qp];
   if (_fe_problem.currentlyComputingJacobian())
     _Jacobian_mult_couple[_qp] = _elastic_flexural_rigidity_tensor[_qp];
  
   if (_perform_finite_strain_rotations)
   {
     _couple_stress[_qp] =
         _rotation_increment[_qp] * _couple_stress[_qp] * _rotation_increment[_qp].transpose();
     _Jacobian_mult_couple[_qp].rotate(_rotation_increment[_qp]);
   }
 }

◆ computeQpStressIntermediateConfiguration()

void ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration ( )

protectedvirtualinherited

Compute the stress for the current QP, but do not rotate tensors from the intermediate configuration to the new configuration.

Definition at line 215 of file ComputeMultipleInelasticStress.C.

 {
   RankTwoTensor elastic_strain_increment;
   RankTwoTensor combined_inelastic_strain_increment;
  
   if (_num_models == 0)
   {
     _elastic_strain[_qp] = _elastic_strain_old[_qp] + _strain_increment[_qp];
  
     // If the elasticity tensor values have changed and the tensor is isotropic,
     // use the old strain to calculate the old stress
     if (_is_elasticity_tensor_guaranteed_isotropic || !_perform_finite_strain_rotations)
       _stress[_qp] = _elasticity_tensor[_qp] * (_elastic_strain_old[_qp] + _strain_increment[_qp]);
     else
     {
       if (_damage_model)
         _stress[_qp] = _undamaged_stress_old + _elasticity_tensor[_qp] * _strain_increment[_qp];
       else
         _stress[_qp] = _stress_old[_qp] + _elasticity_tensor[_qp] * _strain_increment[_qp];
     }
     if (_fe_problem.currentlyComputingJacobian())
       _Jacobian_mult[_qp] = _elasticity_tensor[_qp];
  
     _matl_timestep_limit[_qp] = std::numeric_limits<Real>::max();
   }
   else
   {
     if (_num_models == 1 || _cycle_models)
       updateQpStateSingleModel((_t_step - 1) % _num_models,
                                elastic_strain_increment,
                                combined_inelastic_strain_increment);
     else
       updateQpState(elastic_strain_increment, combined_inelastic_strain_increment);
  
     _elastic_strain[_qp] = _elastic_strain_old[_qp] + elastic_strain_increment;
     _inelastic_strain[_qp] = _inelastic_strain_old[_qp] + combined_inelastic_strain_increment;
   }
 }

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

◆ finiteStrainRotation()

void ComputeMultipleInelasticStress::finiteStrainRotation ( const bool force_elasticity_rotation = false )

protectedvirtualinherited

Rotate _elastic_strain, _stress, _inelastic_strain, and _Jacobian_mult to the new configuration.

Parameters

force_elasticity_rotation Force the elasticity tensor to be rotated, even if it is not deemed necessary.

Definition at line 255 of file ComputeMultipleInelasticStress.C.

 {
   _elastic_strain[_qp] =
       _rotation_increment[_qp] * _elastic_strain[_qp] * _rotation_increment[_qp].transpose();
   _stress[_qp] = _rotation_increment[_qp] * _stress[_qp] * _rotation_increment[_qp].transpose();
   _inelastic_strain[_qp] =
       _rotation_increment[_qp] * _inelastic_strain[_qp] * _rotation_increment[_qp].transpose();
  
   if (force_elasticity_rotation ||
       !(_is_elasticity_tensor_guaranteed_isotropic &&
         (_all_models_isotropic ||
          _tangent_calculation_method == TangentCalculationMethod::ELASTIC || _num_models == 0)))
     _Jacobian_mult[_qp].rotate(_rotation_increment[_qp]);
 }

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

◆ hasGuaranteedMaterialProperty()

bool GuaranteeConsumer::hasGuaranteedMaterialProperty	(	const MaterialPropertyName &	prop,
		Guarantee	guarantee
	)

protectedinherited

Definition at line 28 of file GuaranteeConsumer.C.

 {
   if (!_gc_feproblem->startedInitialSetup())
     mooseError("hasGuaranteedMaterialProperty() needs to be called in initialSetup()");
  
   // Reference to MaterialWarehouse for testing and retrieving block ids
   const auto & warehouse = _gc_feproblem->getMaterialWarehouse();
  
   // Complete set of ids that this object is active
   const auto & ids = (_gc_block_restrict && _gc_block_restrict->blockRestricted())
                          ? _gc_block_restrict->blockIDs()
                          : _gc_feproblem->mesh().meshSubdomains();
  
   // Loop over each id for this object
   for (const auto & id : ids)
   {
     // If block materials exist, look if any issue the required guarantee
     if (warehouse.hasActiveBlockObjects(id))
     {
       const std::vector<std::shared_ptr<MaterialBase>> & mats = warehouse.getActiveBlockObjects(id);
       for (const auto & mat : mats)
       {
         const auto & mat_props = mat->getSuppliedItems();
         if (mat_props.count(prop_name))
         {
           auto guarantee_mat = dynamic_cast<GuaranteeProvider *>(mat.get());
           if (guarantee_mat && !guarantee_mat->hasGuarantee(prop_name, guarantee))
           {
             // we found at least one material on the set of block we operate on
             // that does _not_ provide the requested guarantee
             return false;
           }
         }
       }
     }
   }
  
   return true;
 }

Referenced by ComputeFiniteStrainElasticStress::initialSetup(), ComputeSmearedCrackingStress::initialSetup(), ComputeLinearElasticPFFractureStress::initialSetup(), CriticalTimeStep::initialSetup(), and ComputeMultipleInelasticStress::initialSetup().

◆ initialSetup()

void ComputeMultipleInelasticStress::initialSetup ( )

overridevirtualinherited

Reimplemented in ComputeSmearedCrackingStress.

Definition at line 122 of file ComputeMultipleInelasticStress.C.

 {
   _is_elasticity_tensor_guaranteed_isotropic =
       hasGuaranteedMaterialProperty(_elasticity_tensor_name, Guarantee::ISOTROPIC);
  
   std::vector<MaterialName> models = getParam<std::vector<MaterialName>>("inelastic_models");
  
   for (unsigned int i = 0; i < _num_models; ++i)
   {
     StressUpdateBase * rrr = dynamic_cast<StressUpdateBase *>(&getMaterialByName(models[i]));
  
     if (rrr)
     {
       _models.push_back(rrr);
       _all_models_isotropic = _all_models_isotropic && rrr->isIsotropic();
       if (rrr->requiresIsotropicTensor() && !_is_elasticity_tensor_guaranteed_isotropic)
         mooseError("Model " + models[i] +
                    " requires an isotropic elasticity tensor, but the one supplied is not "
                    "guaranteed isotropic");
     }
     else
       mooseError("Model " + models[i] + " is not compatible with ComputeMultipleInelasticStress");
   }
  
   // Check if tangent calculation methods are consistent. If all models have
   // TangentOperatorEnum::ELASTIC or tangent_operator is set by the user as elasic, then the tangent
   // is never calculated: J_tot = C. If PARTIAL and NONE models are present, utilize PARTIAL
   // formulation: J_tot = (I + J_1 + ... J_N)^-1 C. If FULL and NONE models are present, utilize
   // FULL formulation: J_tot = J_1 * C^-1 * J_2 * C^-1 * ... J_N * C. If PARTIAL and FULL models are
   // present, error out.
  
   if (_tangent_operator_type != TangentOperatorEnum::elastic)
   {
     bool full_present = false;
     bool partial_present = false;
     for (unsigned int i = 0; i < _num_models; ++i)
     {
       if (_models[i]->getTangentCalculationMethod() == TangentCalculationMethod::FULL)
       {
         full_present = true;
         _tangent_computation_flag[i] = true;
         _tangent_calculation_method = TangentCalculationMethod::FULL;
       }
       else if (_models[i]->getTangentCalculationMethod() == TangentCalculationMethod::PARTIAL)
       {
         partial_present = true;
         _tangent_computation_flag[i] = true;
         _tangent_calculation_method = TangentCalculationMethod::PARTIAL;
       }
     }
     if (full_present && partial_present)
       mooseError("In ",
                  _name,
                  ": Models that calculate the full tangent operator and the partial tangent "
                  "operator are being combined. Either set tangent_operator to elastic, implement "
                  "the corrent tangent formulations, or use different models.");
   }
  
   if (isParamValid("damage_model") && !_damage_model)
     paramError("damage_model",
                "Damage Model " + _damage_model->name() +
                    " is not compatible with ComputeMultipleInelasticStress");
 }

Referenced by ComputeSmearedCrackingStress::initialSetup().

◆ initQpStatefulProperties()

void ComputeMultipleInelasticCosseratStress::initQpStatefulProperties ( )

overrideprotectedvirtual

Reimplemented from ComputeMultipleInelasticStress.

Definition at line 42 of file ComputeMultipleInelasticCosseratStress.C.

 {
   ComputeMultipleInelasticStress::initQpStatefulProperties();
   _couple_stress[_qp].zero();
 }

◆ updateQpState()

void ComputeMultipleInelasticStress::updateQpState	(	RankTwoTensor &	elastic_strain_increment,
		RankTwoTensor &	combined_inelastic_strain_increment
	)

protectedvirtualinherited

Given the _strain_increment[_qp], iterate over all of the user-specified recompute materials in order to find an admissible stress (which is placed into _stress[_qp]) and set of inelastic strains, as well as the tangent operator (which is placed into _Jacobian_mult[_qp]).

Parameters

elastic_strain_increment	The elastic part of _strain_increment[_qp] after the iterative process has converged
combined_inelastic_strain_increment	The inelastic part of _strain_increment[_qp] after the iterative process has converged. This is a weighted sum of all the inelastic strains computed by all the plastic models during the Picard iterative scheme. The weights are dictated by the user using _inelastic_weights

Definition at line 271 of file ComputeMultipleInelasticStress.C.

 {
   if (_internal_solve_full_iteration_history == true)
   {
     _console << std::endl
              << "iteration output for ComputeMultipleInelasticStress solve:"
              << " time=" << _t << " int_pt=" << _qp << std::endl;
   }
   Real l2norm_delta_stress;
   Real first_l2norm_delta_stress = 1.0;
   unsigned int counter = 0;
  
   std::vector<RankTwoTensor> inelastic_strain_increment;
   inelastic_strain_increment.resize(_num_models);
  
   for (unsigned i_rmm = 0; i_rmm < _models.size(); ++i_rmm)
     inelastic_strain_increment[i_rmm].zero();
  
   RankTwoTensor stress_max, stress_min;
  
   do
   {
     for (unsigned i_rmm = 0; i_rmm < _num_models; ++i_rmm)
     {
       _models[i_rmm]->setQp(_qp);
  
       // initially assume the strain is completely elastic
       elastic_strain_increment = _strain_increment[_qp];
       // and subtract off all inelastic strain increments calculated so far
       // except the one that we're about to calculate
       for (unsigned j_rmm = 0; j_rmm < _num_models; ++j_rmm)
         if (i_rmm != j_rmm)
           elastic_strain_increment -= inelastic_strain_increment[j_rmm];
  
       // form the trial stress, with the check for changed elasticity constants
       if (_is_elasticity_tensor_guaranteed_isotropic || !_perform_finite_strain_rotations)
         _stress[_qp] =
             _elasticity_tensor[_qp] * (_elastic_strain_old[_qp] + elastic_strain_increment);
       else
       {
         if (_damage_model)
           _stress[_qp] = _undamaged_stress_old + _elasticity_tensor[_qp] * elastic_strain_increment;
         else
           _stress[_qp] = _stress_old[_qp] + _elasticity_tensor[_qp] * elastic_strain_increment;
       }
  
       // given a trial stress (_stress[_qp]) and a strain increment (elastic_strain_increment)
       // let the i^th model produce an admissible stress (as _stress[_qp]), and decompose
       // the strain increment into an elastic part (elastic_strain_increment) and an
       // inelastic part (inelastic_strain_increment[i_rmm])
       computeAdmissibleState(i_rmm,
                              elastic_strain_increment,
                              inelastic_strain_increment[i_rmm],
                              _consistent_tangent_operator[i_rmm]);
  
       if (i_rmm == 0)
       {
         stress_max = _stress[_qp];
         stress_min = _stress[_qp];
       }
       else
       {
         for (unsigned int i = 0; i < LIBMESH_DIM; ++i)
         {
           for (unsigned int j = 0; j < LIBMESH_DIM; ++j)
           {
             if (_stress[_qp](i, j) > stress_max(i, j))
               stress_max(i, j) = _stress[_qp](i, j);
             else if (stress_min(i, j) > _stress[_qp](i, j))
               stress_min(i, j) = _stress[_qp](i, j);
           }
         }
       }
     }
  
     // now check convergence in the stress:
     // once the change in stress is within tolerance after each recompute material
     // consider the stress to be converged
     l2norm_delta_stress = (stress_max - stress_min).L2norm();
     if (counter == 0 && l2norm_delta_stress > 0.0)
       first_l2norm_delta_stress = l2norm_delta_stress;
  
     if (_internal_solve_full_iteration_history == true)
     {
       _console << "stress iteration number = " << counter << "\n"
                << " relative l2 norm delta stress = "
                << (0 == first_l2norm_delta_stress ? 0
                                                   : l2norm_delta_stress / first_l2norm_delta_stress)
                << "\n"
                << " stress convergence relative tolerance = " << _relative_tolerance << "\n"
                << " absolute l2 norm delta stress = " << l2norm_delta_stress << "\n"
                << " stress convergence absolute tolerance = " << _absolute_tolerance << std::endl;
     }
     ++counter;
   } while (counter < _max_iterations && l2norm_delta_stress > _absolute_tolerance &&
            (l2norm_delta_stress / first_l2norm_delta_stress) > _relative_tolerance &&
            _num_models != 1);
  
   if (counter == _max_iterations && l2norm_delta_stress > _absolute_tolerance &&
       (l2norm_delta_stress / first_l2norm_delta_stress) > _relative_tolerance)
     throw MooseException("Max stress iteration hit during ComputeMultipleInelasticStress solve!");
  
   combined_inelastic_strain_increment.zero();
   for (unsigned i_rmm = 0; i_rmm < _num_models; ++i_rmm)
     combined_inelastic_strain_increment +=
         _inelastic_weights[i_rmm] * inelastic_strain_increment[i_rmm];
  
   if (_fe_problem.currentlyComputingJacobian())
     computeQpJacobianMult();
  
   _matl_timestep_limit[_qp] = 0.0;
   for (unsigned i_rmm = 0; i_rmm < _num_models; ++i_rmm)
     _matl_timestep_limit[_qp] += 1.0 / _models[i_rmm]->computeTimeStepLimit();
  
   if (MooseUtils::absoluteFuzzyEqual(_matl_timestep_limit[_qp], 0.0))
     _matl_timestep_limit[_qp] = std::numeric_limits<Real>::max();
   else
     _matl_timestep_limit[_qp] = 1.0 / _matl_timestep_limit[_qp];
 }

Referenced by ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration().

◆ updateQpStateSingleModel()

void ComputeMultipleInelasticStress::updateQpStateSingleModel	(	unsigned	model_number,
		RankTwoTensor &	elastic_strain_increment,
		RankTwoTensor &	combined_inelastic_strain_increment
	)

protectedvirtualinherited

An optimised version of updateQpState that gets used when the number of plastic models is unity, or when we're cycling through models Given the _strain_increment[_qp], find an admissible stress (which is put into _stress[_qp]) and inelastic strain, as well as the tangent operator (which is placed into _Jacobian_mult[_qp])

Parameters

model_number	Use this model number
elastic_strain_increment	The elastic part of _strain_increment[_qp]
combined_inelastic_strain_increment	The inelastic part of _strain_increment[_qp]

Definition at line 415 of file ComputeMultipleInelasticStress.C.

 {
   for (auto model : _models)
     model->setQp(_qp);
  
   elastic_strain_increment = _strain_increment[_qp];
  
   // If the elasticity tensor values have changed and the tensor is isotropic,
   // use the old strain to calculate the old stress
   if (_is_elasticity_tensor_guaranteed_isotropic || !_perform_finite_strain_rotations)
     _stress[_qp] = _elasticity_tensor[_qp] * (_elastic_strain_old[_qp] + elastic_strain_increment);
   else
   {
     if (_damage_model)
       _stress[_qp] = _undamaged_stress_old + _elasticity_tensor[_qp] * elastic_strain_increment;
     else
       _stress[_qp] = _stress_old[_qp] + _elasticity_tensor[_qp] * elastic_strain_increment;
   }
  
   computeAdmissibleState(model_number,
                          elastic_strain_increment,
                          combined_inelastic_strain_increment,
                          _consistent_tangent_operator[0]);
  
   if (_fe_problem.currentlyComputingJacobian())
   {
     if (_tangent_calculation_method == TangentCalculationMethod::ELASTIC)
       _Jacobian_mult[_qp] = _elasticity_tensor[_qp];
     else if (_tangent_calculation_method == TangentCalculationMethod::PARTIAL)
     {
       RankFourTensor A = _identity_symmetric_four + _consistent_tangent_operator[0];
       mooseAssert(A.isSymmetric(), "Tangent operator isn't symmetric");
       _Jacobian_mult[_qp] = A.invSymm() * _elasticity_tensor[_qp];
     }
     else
       _Jacobian_mult[_qp] = _consistent_tangent_operator[0];
   }
  
   _matl_timestep_limit[_qp] = _models[0]->computeTimeStepLimit();
  
   /* propagate internal variables, etc, to this timestep for those inelastic models where
    * "updateState" is not called */
   for (unsigned i_rmm = 0; i_rmm < _num_models; ++i_rmm)
     if (i_rmm != model_number)
       _models[i_rmm]->propagateQpStatefulProperties();
 }

Referenced by ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration().

◆ validParams()

InputParameters ComputeMultipleInelasticCosseratStress::validParams ( )

static

Definition at line 17 of file ComputeMultipleInelasticCosseratStress.C.

 {
   InputParameters params = ComputeMultipleInelasticStress::validParams();
   params.addClassDescription("Compute state (stress and other quantities such as plastic "
                              "strains and internal parameters) using an iterative process, as well "
                              "as Cosserat versions of these quantities.  Only elasticity is "
                              "currently implemented for the Cosserat versions."
                              "Combinations of creep models and plastic models may be used");
   return params;
 }

Member Data Documentation

◆ _absolute_tolerance

const Real ComputeMultipleInelasticStress::_absolute_tolerance

protectedinherited

Definition at line 124 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::updateQpState().

◆ _all_models_isotropic

bool ComputeMultipleInelasticStress::_all_models_isotropic

protectedinherited

are all inelastic models inherently isotropic? (not the case for e.g. weak plane plasticity models)

Definition at line 183 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::finiteStrainRotation(), and ComputeMultipleInelasticStress::initialSetup().

◆ _base_name

const std::string ComputeStressBase::_base_name

protectedinherited

Base name prepended to all material property names to allow for multi-material systems.

Definition at line 45 of file ComputeStressBase.h.

Referenced by ComputeLinearElasticStress::initialSetup(), and ComputeCosseratLinearElasticStress::initialSetup().

◆ _compliance

const MaterialProperty<RankFourTensor>& ComputeMultipleInelasticCosseratStress::_compliance

protected

Inverse of the elasticity tensor.

Definition at line 77 of file ComputeMultipleInelasticCosseratStress.h.

Referenced by computeAdmissibleState(), and computeQpJacobianMult().

◆ _consistent_tangent_operator

std::vector<RankFourTensor> ComputeMultipleInelasticStress::_consistent_tangent_operator

protectedinherited

the consistent tangent operators computed by each plastic model

Definition at line 158 of file ComputeMultipleInelasticStress.h.

Referenced by computeQpJacobianMult(), ComputeMultipleInelasticStress::computeQpJacobianMult(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _couple_stress

MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticCosseratStress::_couple_stress

protected

the Cosserat couple-stress

Definition at line 68 of file ComputeMultipleInelasticCosseratStress.h.

Referenced by computeQpStress(), and initQpStatefulProperties().

◆ _couple_stress_old

const MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticCosseratStress::_couple_stress_old

protected

the old value of Cosserat couple-stress

Definition at line 71 of file ComputeMultipleInelasticCosseratStress.h.

◆ _curvature

const MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticCosseratStress::_curvature

protected

The Cosserat curvature strain.

Definition at line 62 of file ComputeMultipleInelasticCosseratStress.h.

Referenced by computeQpStress().

◆ _cycle_models

const bool ComputeMultipleInelasticStress::_cycle_models

protectedinherited

whether to cycle through the models, using only one model per timestep

Definition at line 161 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration().

◆ _damage_model

DamageBase* ComputeMultipleInelasticStress::_damage_model

protectedinherited

Pointer to the damage model.

Definition at line 186 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeAdmissibleState(), ComputeMultipleInelasticStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeMultipleInelasticStress::initialSetup(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _elastic_flexural_rigidity_tensor

const MaterialProperty<RankFourTensor>& ComputeMultipleInelasticCosseratStress::_elastic_flexural_rigidity_tensor

protected

The Cosserat elastic flexural rigidity tensor.

Definition at line 65 of file ComputeMultipleInelasticCosseratStress.h.

Referenced by computeQpStress().

◆ _elastic_strain

MaterialProperty<RankTwoTensor>& ComputeStressBase::_elastic_strain

protectedinherited

Elastic strain material property.

Definition at line 52 of file ComputeStressBase.h.

Referenced by ComputeSmearedCrackingStress::computeCrackStrainAndOrientation(), ComputeLinearElasticStress::computeQpStress(), ComputeFiniteStrainElasticStress::computeQpStress(), ComputeCosseratLinearElasticStress::computeQpStress(), ComputeSmearedCrackingStress::computeQpStress(), FiniteStrainPlasticMaterial::computeQpStress(), ComputeMultiPlasticityStress::computeQpStress(), ComputeLinearViscoelasticStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeMultipleInelasticStress::finiteStrainRotation(), and ComputeStressBase::initQpStatefulProperties().

◆ _elastic_strain_old

const MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticStress::_elastic_strain_old

protectedinherited

Strain tensors.

Definition at line 132 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeAdmissibleState(), ComputeSmearedCrackingStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeSmearedCrackingStress::updateLocalElasticityTensor(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _elasticity_tensor

const MaterialProperty<RankFourTensor>& ComputeFiniteStrainElasticStress::_elasticity_tensor

protectedinherited

Elasticity tensor material property.

Definition at line 39 of file ComputeFiniteStrainElasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeAdmissibleState(), computeQpJacobianMult(), ComputeMultipleInelasticStress::computeQpJacobianMult(), ComputeFiniteStrainElasticStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeSmearedCrackingStress::updateCrackingStateAndStress(), ComputeSmearedCrackingStress::updateLocalElasticityTensor(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _elasticity_tensor_name

const std::string ComputeFiniteStrainElasticStress::_elasticity_tensor_name

protectedinherited

Name of the elasticity tensor material property.

Definition at line 37 of file ComputeFiniteStrainElasticStress.h.

Referenced by ComputeFiniteStrainElasticStress::initialSetup(), ComputeSmearedCrackingStress::initialSetup(), and ComputeMultipleInelasticStress::initialSetup().

◆ _extra_stress

const MaterialProperty<RankTwoTensor>& ComputeStressBase::_extra_stress

protectedinherited

Extra stress tensor.

Definition at line 55 of file ComputeStressBase.h.

Referenced by ComputeStressBase::computeQpProperties().

◆ _gc_block_restrict

BlockRestrictable* const GuaranteeConsumer::_gc_block_restrict

privateinherited

Access block restrictions of the object with this interface.

Definition at line 41 of file GuaranteeConsumer.h.

Referenced by GuaranteeConsumer::hasGuaranteedMaterialProperty().

◆ _gc_feproblem

FEProblemBase* const GuaranteeConsumer::_gc_feproblem

privateinherited

Reference to the FEProblemBase class.

Definition at line 38 of file GuaranteeConsumer.h.

Referenced by GuaranteeConsumer::hasGuaranteedMaterialProperty().

◆ _gc_params

const InputParameters& GuaranteeConsumer::_gc_params

privateinherited

Parameters of the object with this interface.

Definition at line 35 of file GuaranteeConsumer.h.

◆ _identity_symmetric_four

const RankFourTensor ComputeMultipleInelasticStress::_identity_symmetric_four

protectedinherited

Rank four symmetric identity tensor.

Definition at line 168 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeQpJacobianMult(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _inelastic_strain

MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticStress::_inelastic_strain

protectedinherited

The sum of the inelastic strains that come from the plastic models.

Definition at line 137 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeSmearedCrackingStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeMultipleInelasticStress::finiteStrainRotation(), and ComputeMultipleInelasticStress::initQpStatefulProperties().

◆ _inelastic_strain_old

const MaterialProperty<RankTwoTensor>& ComputeMultipleInelasticStress::_inelastic_strain_old

protectedinherited

old value of inelastic strain

Definition at line 140 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeSmearedCrackingStress::computeQpStress(), and ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration().

◆ _inelastic_weights

const std::vector<Real> ComputeMultipleInelasticStress::_inelastic_weights

protectedinherited

_inelastic_strain = sum_i (_inelastic_weights_i * inelastic_strain_from_model_i)

Definition at line 155 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::ComputeMultipleInelasticStress(), and ComputeMultipleInelasticStress::updateQpState().

◆ _initial_stress_fcn

std::vector<const Function *> ComputeStressBase::_initial_stress_fcn

protectedinherited

initial stress components

Definition at line 58 of file ComputeStressBase.h.

◆ _internal_solve_full_iteration_history

const bool ComputeMultipleInelasticStress::_internal_solve_full_iteration_history

protectedinherited

Definition at line 125 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::updateQpState().

◆ _is_elasticity_tensor_guaranteed_isotropic

bool ComputeMultipleInelasticStress::_is_elasticity_tensor_guaranteed_isotropic

protectedinherited

is the elasticity tensor guaranteed to be isotropic?

Definition at line 180 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeMultipleInelasticStress::finiteStrainRotation(), ComputeMultipleInelasticStress::initialSetup(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _Jacobian_mult

MaterialProperty<RankFourTensor>& ComputeStressBase::_Jacobian_mult

protectedinherited

derivative of stress w.r.t. strain (_dstress_dstrain)

Definition at line 61 of file ComputeStressBase.h.

◆ _Jacobian_mult_couple

MaterialProperty<RankFourTensor>& ComputeMultipleInelasticCosseratStress::_Jacobian_mult_couple

protected

derivative of couple-stress w.r.t. curvature

Definition at line 74 of file ComputeMultipleInelasticCosseratStress.h.

Referenced by computeQpStress().

◆ _matl_timestep_limit

MaterialProperty<Real>& ComputeMultipleInelasticStress::_matl_timestep_limit

protectedinherited

Definition at line 163 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeSmearedCrackingStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStress(), ComputeMultipleInelasticStress::computeQpStressIntermediateConfiguration(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().

◆ _max_iterations

const unsigned int ComputeMultipleInelasticStress::_max_iterations

protectedinherited

Input parameters associated with the recompute iteration to return the stress state to the yield surface.

Definition at line 122 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::updateQpState().

◆ _mechanical_strain

const MaterialProperty<RankTwoTensor>& ComputeStressBase::_mechanical_strain

protectedinherited

Mechanical strain material property.

Definition at line 48 of file ComputeStressBase.h.

Referenced by ComputeLinearElasticStress::computeQpStress(), ComputeFiniteStrainElasticStress::computeQpStress(), ComputeCosseratLinearElasticStress::computeQpStress(), FiniteStrainPlasticMaterial::computeQpStress(), ComputeLinearElasticPFFractureStress::computeQpStress(), ComputeLinearViscoelasticStress::computeQpStress(), ComputeLinearElasticPFFractureStress::computeStrainSpectral(), ComputeLinearElasticPFFractureStress::computeStrainVolDev(), and ComputeLinearElasticPFFractureStress::computeStressSpectral().

◆ _models

std::vector<StressUpdateBase *> ComputeMultipleInelasticStress::_models

protectedinherited

The user supplied list of inelastic models to use in the simulation.

Users should take care to list creep models first and plasticity models last to allow for the case when a creep model relaxes the stress state inside of the yield surface in an iteration.

Definition at line 177 of file ComputeMultipleInelasticStress.h.

Referenced by ComputeMultipleInelasticStress::computeAdmissibleState(), ComputeSmearedCrackingStress::computeQpStress(), ComputeMultipleInelasticStress::initialSetup(), ComputeMultipleInelasticStress::updateQpState(), and ComputeMultipleInelasticStress::updateQpStateSingleModel().