This class uses the stress update material in a radial return isotropic creep model.
More...
#include <ADPowerLawCreepStressUpdate.h>
|
| ADPowerLawCreepStressUpdate (const InputParameters ¶meters) |
|
virtual void | updateState (ADRankTwoTensor &strain_increment, ADRankTwoTensor &inelastic_strain_increment, const ADRankTwoTensor &rotation_increment, ADRankTwoTensor &stress_new, const RankTwoTensor &stress_old, const ADRankFourTensor &elasticity_tensor, const RankTwoTensor &elastic_strain_old) override |
| A radial return (J2) mapping method is performed with return mapping iterations. More...
|
|
virtual Real | computeReferenceResidual (const ADReal &effective_trial_stress, const ADReal &scalar_effective_inelastic_strain) override |
| Compute a reference quantity to be used for checking relative convergence. More...
|
|
virtual ADReal | minimumPermissibleValue (const ADReal &) const override |
| Compute the minimum permissible value of the scalar. More...
|
|
virtual ADReal | maximumPermissibleValue (const ADReal &effective_trial_stress) const override |
| Compute the maximum permissible value of the scalar. More...
|
|
virtual Real | computeTimeStepLimit () override |
| Compute the limiting value of the time step for this material. More...
|
|
bool | requiresIsotropicTensor () override |
| Does the model require the elasticity tensor to be isotropic? More...
|
|
void | setQp (unsigned int qp) |
| Sets the value of the global variable _qp for 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 |
|
|
virtual void | computeStressInitialize (const ADReal &effective_trial_stress, const ADRankFourTensor &elasticity_tensor) override |
| Perform any necessary initialization before return mapping iterations. More...
|
|
virtual ADReal | computeResidual (const ADReal &effective_trial_stress, const ADReal &scalar) override |
| Compute the residual for a predicted value of the scalar. More...
|
|
virtual ADReal | computeDerivative (const ADReal &effective_trial_stress, const ADReal &scalar) override |
| Compute the derivative of the residual as a function of the scalar variable. More...
|
|
virtual void | initQpStatefulProperties () override |
|
virtual void | propagateQpStatefulProperties () override |
| If updateState is not called during a timestep, this will be. More...
|
|
virtual void | computeStressFinalize (const ADRankTwoTensor &plastic_strain_increment) override |
| Perform any necessary steps to finalize state after return mapping iterations. More...
|
|
| ADMaterialProperty (RankTwoTensor) &_creep_strain |
| Creep strain material property. More...
|
|
| ADMaterialProperty (Real) &_effective_inelastic_strain |
|
void | propagateQpStatefulPropertiesRadialReturn () |
| Propagate the properties pertaining to this intermediate class. More...
|
|
void | outputIterationSummary (std::stringstream *iter_output, const unsigned int total_it) override |
| Output summary information for the convergence history of the model. More...
|
|
void | returnMappingSolve (const ADReal &effective_trial_stress, ADReal &scalar, const ConsoleStream &console) |
| Perform the return mapping iterations. More...
|
|
virtual ADReal | initialGuess (const ADReal &) |
| Compute an initial guess for the value of the scalar. More...
|
|
virtual void | iterationFinalize (ADReal) |
| Finalize internal state variables for a model for a given iteration. More...
|
|
virtual void | outputIterationStep (std::stringstream *iter_output, const ADReal &effective_trial_stress, const ADReal &scalar, const Real reference_residual) |
| Output information for a single iteration step to build the convergence history of the model. More...
|
|
bool | converged (const ADReal &residual, const Real reference) |
| Check to see whether the residual is within the convergence limits. More...
|
|
|
SolveState | internalSolve (const ADReal effective_trial_stress, ADReal &scalar, std::stringstream *iter_output=nullptr) |
| Method called from within this class to perform the actual return mappping iterations. More...
|
|
bool | convergedAcceptable (const unsigned int it, const Real reference) |
| Check to see whether the residual is within acceptable convergence limits. More...
|
|
void | checkPermissibleRange (ADReal &scalar, ADReal &scalar_increment, const ADReal &scalar_old, const ADReal min_permissible_scalar, const ADReal max_permissible_scalar, std::stringstream *iter_output) |
| Check to see whether solution is within admissible range, and set it within that range if it is not. More...
|
|
void | updateBounds (const ADReal &scalar, const ADReal &residual, const Real init_resid_sign, ADReal &scalar_upper_bound, ADReal &scalar_lower_bound, std::stringstream *iter_output) |
| Update the upper and lower bounds of the root for the effective inelastic strain. More...
|
|
template<ComputeStage compute_stage>
class ADPowerLawCreepStressUpdate< compute_stage >
This class uses the stress update material in a radial return isotropic creep model.
This class is one of the basic radial return constitutive models; more complex constitutive models combine creep and plasticity.
This class inherits from RadialReturnCreepStressUpdateBase and must be used in conjunction with ComputeMultipleInelasticStress. This class calculates creep based on stress, temperature, and time effects. This class also computes the creep strain as a stateful material property.
Definition at line 15 of file ADPowerLawCreepStressUpdate.h.
◆ InternalSolveOutput
template<ComputeStage compute_stage>
◆ SolveState
template<ComputeStage compute_stage>
◆ ADPowerLawCreepStressUpdate()
template<ComputeStage compute_stage>
Definition at line 38 of file ADPowerLawCreepStressUpdate.C.
41 _temperature(isParamValid(
"temperature") ? &adCoupledValue(
"temperature") :
nullptr),
51 paramError(
"start_time",
52 "Start time must be equal to or greater than the Executioner start_time if a "
53 "non-integer m_exponent is used");
◆ ADMaterialProperty() [1/2]
template<ComputeStage compute_stage>
Creep strain material property.
◆ ADMaterialProperty() [2/2]
template<ComputeStage compute_stage>
◆ checkPermissibleRange()
template<ComputeStage compute_stage>
void ADSingleVariableReturnMappingSolution< compute_stage >::checkPermissibleRange |
( |
ADReal & |
scalar, |
|
|
ADReal & |
scalar_increment, |
|
|
const ADReal & |
scalar_old, |
|
|
const ADReal |
min_permissible_scalar, |
|
|
const ADReal |
max_permissible_scalar, |
|
|
std::stringstream * |
iter_output |
|
) |
| |
|
privateinherited |
Check to see whether solution is within admissible range, and set it within that range if it is not.
- Parameters
-
scalar | Current value of the inelastic strain increment |
scalar_increment | Incremental change in scalar from the previous iteration |
scalar_old | Previous value of scalar |
min_permissible_scalar | Minimum permissible value of scalar |
max_permissible_scalar | Maximum permissible value of scalar |
iter_output | Output stream |
Definition at line 334 of file ADSingleVariableReturnMappingSolution.C.
342 if (scalar > max_permissible_scalar)
344 scalar_increment = (max_permissible_scalar - scalar_old) / 2.0;
345 scalar = scalar_old + scalar_increment;
347 *iter_output <<
"Scalar greater than maximum ("
348 << MetaPhysicL::raw_value(max_permissible_scalar)
349 <<
") adjusted scalar=" << MetaPhysicL::raw_value(scalar)
350 <<
" scalar_increment=" << MetaPhysicL::raw_value(scalar_increment) << std::endl;
352 else if (scalar < min_permissible_scalar)
354 scalar_increment = (min_permissible_scalar - scalar_old) / 2.0;
355 scalar = scalar_old + scalar_increment;
357 *iter_output <<
"Scalar less than minimum (" << MetaPhysicL::raw_value(min_permissible_scalar)
358 <<
") adjusted scalar=" << MetaPhysicL::raw_value(scalar)
359 <<
" scalar_increment=" << MetaPhysicL::raw_value(scalar_increment) << std::endl;
◆ computeDerivative()
template<ComputeStage compute_stage>
ADReal ADPowerLawCreepStressUpdate< compute_stage >::computeDerivative |
( |
const ADReal & |
effective_trial_stress, |
|
|
const ADReal & |
scalar |
|
) |
| |
|
overrideprotectedvirtual |
◆ computeReferenceResidual()
template<ComputeStage compute_stage>
Real ADRadialReturnStressUpdate< compute_stage >::computeReferenceResidual |
( |
const ADReal & |
effective_trial_stress, |
|
|
const ADReal & |
scalar |
|
) |
| |
|
overridevirtualinherited |
Compute a reference quantity to be used for checking relative convergence.
This should be in strain increment units for all models for consistency.
- Parameters
-
effective_trial_stress | Effective trial stress |
scalar | Inelastic strain increment magnitude being solved for |
Implements ADSingleVariableReturnMappingSolution< compute_stage >.
Definition at line 124 of file ADRadialReturnStressUpdate.C.
128 MetaPhysicL::raw_value(scalar_effective_inelastic_strain);
◆ computeResidual()
template<ComputeStage compute_stage>
◆ computeStressFinalize()
template<ComputeStage compute_stage>
|
overrideprotectedvirtualinherited |
◆ computeStressInitialize()
template<ComputeStage compute_stage>
◆ computeTimeStepLimit()
template<ComputeStage compute_stage>
◆ converged()
template<ComputeStage compute_stage>
Check to see whether the residual is within the convergence limits.
- Parameters
-
residual | Current value of the residual |
reference | Current value of the reference quantity |
- Returns
- Whether the model converged
Definition at line 301 of file ADSingleVariableReturnMappingSolution.C.
304 const Real residual = MetaPhysicL::raw_value(ad_residual);
◆ convergedAcceptable()
template<ComputeStage compute_stage>
Check to see whether the residual is within acceptable convergence limits.
This will only return true if it has been determined that progress is no longer being made and that the residual is within the acceptable limits.
- Parameters
-
residual | Current iteration count |
residual | Current value of the residual |
reference | Current value of the reference quantity |
- Returns
- Whether the model converged
Definition at line 311 of file ADSingleVariableReturnMappingSolution.C.
322 const Real convergence_history_factor = 10.0;
323 if (std::abs(
_residual * convergence_history_factor) <
◆ initialGuess()
template<ComputeStage compute_stage>
|
inlineprotectedvirtualinherited |
Compute an initial guess for the value of the scalar.
For some cases, an intellegent starting point can provide enhanced robustness in the Newton iterations. This is also an opportunity for classes that derive from this to perform initialization tasks.
- Parameters
-
effective_trial_stress | Effective trial stress |
Reimplemented in ADViscoplasticityStressUpdate< compute_stage >.
Definition at line 82 of file ADSingleVariableReturnMappingSolution.h.
◆ initQpStatefulProperties()
template<ComputeStage compute_stage>
|
overrideprotectedvirtualinherited |
◆ internalSolve()
template<ComputeStage compute_stage>
Method called from within this class to perform the actual return mappping iterations.
- Parameters
-
effective_trial_stress | Effective trial stress |
scalar | Inelastic strain increment magnitude being solved for |
iter_output | Output stream – if null, no output is produced |
- Returns
- Whether the solution was successful
Definition at line 162 of file ADSingleVariableReturnMappingSolution.C.
166 ADReal scalar_old = scalar;
167 ADReal scalar_increment = 0.0;
170 ADReal scalar_upper_bound = max_permissible_scalar;
171 ADReal scalar_lower_bound = min_permissible_scalar;
177 Real init_resid_sign = MathUtils::sign(MetaPhysicL::raw_value(
_residual));
194 scalar = scalar_old + scalar_increment;
200 min_permissible_scalar,
201 max_permissible_scalar,
210 scalar,
_residual, init_resid_sign, scalar_upper_bound, scalar_lower_bound, iter_output);
219 bool modified_increment =
false;
226 ADReal alpha = residual_old / (residual_old -
_residual);
227 alpha = MathUtils::clamp(alpha, 1.0e-2, 1.0);
231 modified_increment =
true;
232 scalar_increment *= alpha;
234 *iter_output <<
" Line search alpha = " << MetaPhysicL::raw_value(alpha)
235 <<
" increment = " << MetaPhysicL::raw_value(scalar_increment)
245 if (scalar_old + scalar_increment >= scalar_upper_bound ||
246 scalar_old + scalar_increment <= scalar_lower_bound)
248 if (scalar_upper_bound != max_permissible_scalar &&
249 scalar_lower_bound != min_permissible_scalar)
251 const Real frac = 0.5;
253 (1.0 - frac) * scalar_lower_bound + frac * scalar_upper_bound - scalar_old;
254 modified_increment =
true;
256 *iter_output <<
" Trial scalar_increment exceeded bounds. Setting between "
257 "lower/upper bounds. frac: "
258 << frac << std::endl;
265 if (modified_increment)
267 scalar = scalar_old + scalar_increment;
◆ iterationFinalize()
template<ComputeStage compute_stage>
|
inlineprotectedvirtualinherited |
◆ maximumPermissibleValue()
template<ComputeStage compute_stage>
◆ minimumPermissibleValue()
template<ComputeStage compute_stage>
virtual ADReal ADRadialReturnStressUpdate< compute_stage >::minimumPermissibleValue |
( |
const ADReal & |
effective_trial_stress | ) |
const |
|
inlineoverridevirtualinherited |
◆ outputIterationStep()
template<ComputeStage compute_stage>
void ADSingleVariableReturnMappingSolution< compute_stage >::outputIterationStep |
( |
std::stringstream * |
iter_output, |
|
|
const ADReal & |
effective_trial_stress, |
|
|
const ADReal & |
scalar, |
|
|
const Real |
reference_residual |
|
) |
| |
|
protectedvirtualinherited |
Output information for a single iteration step to build the convergence history of the model.
- Parameters
-
iter_output | Output stream |
it | Current iteration count |
effective_trial_stress | Effective trial stress |
scalar | Inelastic strain increment magnitude being solved for |
residual | Current value of the residual |
reference | Current value of the reference quantity |
Definition at line 393 of file ADSingleVariableReturnMappingSolution.C.
402 const Real residual = MetaPhysicL::raw_value(
_residual);
404 *iter_output <<
" iteration=" << it
405 <<
" trial_stress=" << MetaPhysicL::raw_value(effective_trial_stress)
406 <<
" scalar=" << MetaPhysicL::raw_value(scalar) <<
" residual=" << residual
407 <<
" ref_res=" << reference_residual
408 <<
" rel_res=" << std::abs(residual) / reference_residual
◆ outputIterationSummary()
template<ComputeStage compute_stage>
void ADRadialReturnStressUpdate< compute_stage >::outputIterationSummary |
( |
std::stringstream * |
iter_output, |
|
|
const unsigned int |
total_it |
|
) |
| |
|
overrideprotectedvirtualinherited |
Output summary information for the convergence history of the model.
- Parameters
-
iter_output | Output stream |
total_it | Total iteration count |
Reimplemented from ADSingleVariableReturnMappingSolution< compute_stage >.
Definition at line 153 of file ADRadialReturnStressUpdate.C.
158 *iter_output <<
"At element " << _current_elem->id() <<
" _qp=" << _qp <<
" Coordinates "
159 << _q_point[_qp] <<
" block=" << _current_elem->subdomain_id() <<
'\n';
◆ propagateQpStatefulProperties()
template<ComputeStage compute_stage>
|
overrideprotectedvirtualinherited |
◆ propagateQpStatefulPropertiesRadialReturn()
template<ComputeStage compute_stage>
◆ requiresIsotropicTensor()
template<ComputeStage compute_stage>
|
inlineoverridevirtualinherited |
◆ resetProperties()
template<ComputeStage compute_stage>
◆ resetQpProperties()
template<ComputeStage compute_stage>
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 103 of file ADStressUpdateBase.h.
◆ returnMappingSolve()
template<ComputeStage compute_stage>
Perform the return mapping iterations.
- Parameters
-
effective_trial_stress | Effective trial stress |
scalar | Inelastic strain increment magnitude being solved for |
console | Console output |
Definition at line 101 of file ADSingleVariableReturnMappingSolution.C.
105 std::unique_ptr<std::stringstream> iter_output =
107 ? libmesh_make_unique<std::stringstream>()
121 throw MooseException(
"");
125 iter_output = libmesh_make_unique<std::stringstream>();
131 *iter_output <<
"Encountered inf or nan in material return mapping iterations.\n";
135 *iter_output <<
"Exceeded maximum iterations in material return mapping iterations.\n";
139 mooseError(
"Unhandled solver state");
145 internalSolve(effective_trial_stress, scalar, iter_output.get());
149 throw MooseException(iter_output->str());
156 console << iter_output->str();
◆ setQp()
template<ComputeStage compute_stage>
Sets the value of the global variable _qp for inheriting classes.
Definition at line 47 of file ADStressUpdateBase.C.
◆ updateBounds()
template<ComputeStage compute_stage>
void ADSingleVariableReturnMappingSolution< compute_stage >::updateBounds |
( |
const ADReal & |
scalar, |
|
|
const ADReal & |
residual, |
|
|
const Real |
init_resid_sign, |
|
|
ADReal & |
scalar_upper_bound, |
|
|
ADReal & |
scalar_lower_bound, |
|
|
std::stringstream * |
iter_output |
|
) |
| |
|
privateinherited |
Update the upper and lower bounds of the root for the effective inelastic strain.
- Parameters
-
scalar | Current value of the inelastic strain increment |
residual | Current value of the residual |
init_resid_sign | Sign of the initial value of the residual |
scalar_upper_bound | Upper bound value of scalar |
scalar_lower_bound | Lower bound value of scalar |
iter_output | Output stream |
Definition at line 365 of file ADSingleVariableReturnMappingSolution.C.
373 if (residual * init_resid_sign < 0.0 && scalar < scalar_upper_bound)
375 scalar_upper_bound = scalar;
376 if (scalar_upper_bound < scalar_lower_bound)
378 scalar_upper_bound = scalar_lower_bound;
379 scalar_lower_bound = 0.0;
381 *iter_output <<
" Corrected for scalar_upper_bound < scalar_lower_bound" << std::endl;
386 else if (residual * init_resid_sign > 0.0 && scalar > scalar_lower_bound &&
387 scalar < scalar_upper_bound)
388 scalar_lower_bound = scalar;
◆ updateState()
template<ComputeStage compute_stage>
void ADRadialReturnStressUpdate< compute_stage >::updateState |
( |
ADRankTwoTensor & |
strain_increment, |
|
|
ADRankTwoTensor & |
inelastic_strain_increment, |
|
|
const ADRankTwoTensor & |
rotation_increment, |
|
|
ADRankTwoTensor & |
stress_new, |
|
|
const RankTwoTensor & |
stress_old, |
|
|
const ADRankFourTensor & |
elasticity_tensor, |
|
|
const RankTwoTensor & |
elastic_strain_old |
|
) |
| |
|
overridevirtualinherited |
A radial return (J2) mapping method is performed with return mapping iterations.
- Parameters
-
strain_increment | Sum of elastic and inelastic strain increments |
inelastic_strain_increment | Inelastic strain increment calculated by this class |
rotation | increment Not used by this class |
stress_new | New trial stress from pure elastic calculation |
stress_old | Old state of stress |
elasticity_tensor | Rank 4 C_{ijkl}, must be isotropic |
elastic_strain_old | Old state of total elastic strain |
Implements ADStressUpdateBase< compute_stage >.
Definition at line 68 of file ADRadialReturnStressUpdate.C.
79 ADRankTwoTensor deviatoric_trial_stress = stress_new.deviatoric();
82 ADReal dev_trial_stress_squared =
83 deviatoric_trial_stress.doubleContraction(deviatoric_trial_stress);
84 ADReal effective_trial_stress =
85 dev_trial_stress_squared == 0.0 ? 0.0 : std::sqrt(3.0 / 2.0 * dev_trial_stress_squared);
93 ADReal scalar_effective_inelastic_strain = 0.0;
94 if (!MooseUtils::absoluteFuzzyEqual(effective_trial_stress, 0.0))
96 returnMappingSolve(effective_trial_stress, scalar_effective_inelastic_strain, _console);
97 if (scalar_effective_inelastic_strain != 0.0)
98 inelastic_strain_increment =
99 deviatoric_trial_stress *
100 (1.5 * scalar_effective_inelastic_strain / effective_trial_stress);
102 inelastic_strain_increment.zero();
105 inelastic_strain_increment.zero();
109 strain_increment -= inelastic_strain_increment;
110 _effective_inelastic_strain[_qp] =
116 stress_new = elasticity_tensor * (elastic_strain_old + strain_increment);
◆ validParams()
template<ComputeStage compute_stage>
Definition at line 18 of file ADPowerLawCreepStressUpdate.C.
21 params.addClassDescription(
22 "This class uses the stress update material in a radial return isotropic power law creep "
23 "model. This class can be used in conjunction with other creep and plasticity materials "
24 "for more complex simulations.");
27 params.addCoupledVar(
"temperature",
"Coupled temperature");
28 params.addRequiredParam<Real>(
"coefficient",
"Leading coefficient in power-law equation");
29 params.addRequiredParam<Real>(
"n_exponent",
"Exponent on effective stress in power-law equation");
30 params.addParam<Real>(
"m_exponent", 0.0,
"Exponent on time in power-law equation");
31 params.addRequiredParam<Real>(
"activation_energy",
"Activation energy");
32 params.addParam<Real>(
"gas_constant", 8.3143,
"Universal gas constant");
33 params.addParam<Real>(
"start_time", 0.0,
"Start time (if not zero)");
Referenced by ADPowerLawCreepExceptionTest< compute_stage >::validParams().
◆ _absolute_tolerance
template<ComputeStage compute_stage>
◆ _acceptable_multiplier
template<ComputeStage compute_stage>
◆ _activation_energy
template<ComputeStage compute_stage>
◆ _apply_strain
template<ComputeStage compute_stage>
◆ _base_name
template<ComputeStage compute_stage>
Name used as a prefix for all material properties related to the stress update model.
Definition at line 109 of file ADStressUpdateBase.h.
◆ _bracket_solution
template<ComputeStage compute_stage>
◆ _check_range
template<ComputeStage compute_stage>
◆ _coefficient
template<ComputeStage compute_stage>
◆ _creep_strain_old
template<ComputeStage compute_stage>
◆ _effective_inelastic_strain_old
template<ComputeStage compute_stage>
◆ _exp_time
template<ComputeStage compute_stage>
◆ _exponential
template<ComputeStage compute_stage>
◆ _gas_constant
template<ComputeStage compute_stage>
◆ _initial_residual
template<ComputeStage compute_stage>
◆ _internal_solve_full_iteration_history
template<ComputeStage compute_stage>
◆ _internal_solve_output_on
template<ComputeStage compute_stage>
◆ _iteration
template<ComputeStage compute_stage>
◆ _line_search
template<ComputeStage compute_stage>
◆ _m_exponent
template<ComputeStage compute_stage>
◆ _max_inelastic_increment
template<ComputeStage compute_stage>
◆ _max_its
template<ComputeStage compute_stage>
Maximum number of return mapping iterations.
This exists only to avoid an infinite loop, and is is intended to be a large number that is not settable by the user.
Definition at line 172 of file ADSingleVariableReturnMappingSolution.h.
◆ _n_exponent
template<ComputeStage compute_stage>
◆ _num_resids
template<ComputeStage compute_stage>
◆ _relative_tolerance
template<ComputeStage compute_stage>
◆ _residual
template<ComputeStage compute_stage>
◆ _residual_history
template<ComputeStage compute_stage>
◆ _start_time
template<ComputeStage compute_stage>
◆ _svrms_name
template<ComputeStage compute_stage>
◆ _temperature
template<ComputeStage compute_stage>
◆ _three_shear_modulus
template<ComputeStage compute_stage>
◆ usingMaterialMembers
template<ComputeStage compute_stage>
◆ usingRadialReturnCreepStressUpdateBaseMembers
template<ComputeStage compute_stage>
◆ usingRadialReturnStressUpdateMembers
template<ComputeStage compute_stage>
◆ usingSingleVariableReturnMappingSolutionMembers
template<ComputeStage compute_stage>
◆ usingStressUpdateBaseMembers
template<ComputeStage compute_stage>
The documentation for this class was generated from the following files:
const MaterialProperty< Real > & _effective_inelastic_strain_old
const Real _m_exponent
Exponent on time.
virtual ADReal initialGuess(const ADReal &)
Compute an initial guess for the value of the scalar.
static InputParameters validParams()
const bool _internal_solve_full_iteration_history
Whether to output iteration information all the time (regardless of whether iterations converge)
void returnMappingSolve(const ADReal &effective_trial_stress, ADReal &scalar, const ConsoleStream &console)
Perform the return mapping iterations.
virtual void computeStressInitialize(const ADReal &, const ADRankFourTensor &)
Perform any necessary initialization before return mapping iterations.
ExpressionBuilder::EBTerm pow(const ExpressionBuilder::EBTerm &left, T exponent)
bool _bracket_solution
Whether to save upper and lower bounds of root for scalar, and set solution to the midpoint between t...
virtual void outputIterationStep(std::stringstream *iter_output, const ADReal &effective_trial_stress, const ADReal &scalar, const Real reference_residual)
Output information for a single iteration step to build the convergence history of the model.
unsigned int _iteration
iteration number
const Real _gas_constant
Gas constant for exp term.
const Real _start_time
Simulation start time.
ADReal _initial_residual
Residual values, kept as members to retain solver state for summary outputting.
const MaterialProperty< RankTwoTensor > & _creep_strain_old
bool convergedAcceptable(const unsigned int it, const Real reference)
Check to see whether the residual is within acceptable convergence limits.
std::vector< Real > _residual_history
History of residuals used to check whether progress is still being made on decreasing the residual.
virtual ADReal maximumPermissibleValue(const ADReal &effective_trial_stress) const
Compute the maximum permissible value of the scalar.
virtual void initQpStatefulProperties() override
Real _relative_tolerance
Relative convergence tolerance.
const ADVariableValue * _temperature
Temperature variable value.
enum ADSingleVariableReturnMappingSolution::InternalSolveOutput _internal_solve_output_on
void propagateQpStatefulPropertiesRadialReturn()
Propagate the properties pertaining to this intermediate class.
Real _acceptable_multiplier
Multiplier applied to relative and absolute tolerances for acceptable convergence.
const Real _n_exponent
Exponent on the effective stress.
bool converged(const ADReal &residual, const Real reference)
Check to see whether the residual is within the convergence limits.
void updateBounds(const ADReal &scalar, const ADReal &residual, const Real init_resid_sign, ADReal &scalar_upper_bound, ADReal &scalar_lower_bound, std::stringstream *iter_output)
Update the upper and lower bounds of the root for the effective inelastic strain.
const unsigned int _max_its
Maximum number of return mapping iterations.
This class provides baseline functionallity for creep models based on the stress update material in a...
void checkPermissibleRange(ADReal &scalar, ADReal &scalar_increment, const ADReal &scalar_old, const ADReal min_permissible_scalar, const ADReal max_permissible_scalar, std::stringstream *iter_output)
Check to see whether solution is within admissible range, and set it within that range if it is not.
virtual void iterationFinalize(ADReal)
Finalize internal state variables for a model for a given iteration.
virtual ADReal minimumPermissibleValue(const ADReal &effective_trial_stress) const
Compute the minimum permissible value of the scalar.
ADReal _three_shear_modulus
3 * shear modulus
bool _check_range
Whether to check to see whether iterative solution is within admissible range, and set within that ra...
virtual void computeStressFinalize(const ADRankTwoTensor &)
Perform any necessary steps to finalize state after return mapping iterations.
ADReal _exponential
Exponential calculated from activiaction, gas constant, and temperature.
Real _max_inelastic_increment
const std::size_t _num_resids
Number of residuals to be stored in history.
Real _exp_time
Exponential calculated from current time.
Real _absolute_tolerance
Absolute convergence tolerance.
const Real _activation_energy
Activation energy for exp term.
bool _line_search
Whether to use line searches to improve convergence.
const Real _coefficient
Leading coefficient.
virtual ADReal computeResidual(const ADReal &effective_trial_stress, const ADReal &scalar)=0
Compute the residual for a predicted value of the scalar.
virtual void outputIterationSummary(std::stringstream *iter_output, const unsigned int total_it)
Output summary information for the convergence history of the model.
SolveState internalSolve(const ADReal effective_trial_stress, ADReal &scalar, std::stringstream *iter_output=nullptr)
Method called from within this class to perform the actual return mappping iterations.
virtual ADReal computeDerivative(const ADReal &effective_trial_stress, const ADReal &scalar)=0
Compute the derivative of the residual as a function of the scalar variable.
virtual Real computeReferenceResidual(const ADReal &effective_trial_stress, const ADReal &scalar)=0
Compute a reference quantity to be used for checking relative convergence.