www.mooseframework.org
Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | List of all members
TensorMechanicsPlasticWeakPlaneTensileN Class Reference

Rate-independent associative weak-plane tensile failure with hardening/softening, and normal direction specified. More...

#include <TensorMechanicsPlasticWeakPlaneTensileN.h>

Inheritance diagram for TensorMechanicsPlasticWeakPlaneTensileN:
[legend]

Public Member Functions

 TensorMechanicsPlasticWeakPlaneTensileN (const InputParameters &parameters)
 
virtual std::string modelName () const override
 
virtual void activeConstraints (const std::vector< Real > &f, const RankTwoTensor &stress, Real intnl, const RankFourTensor &Eijkl, std::vector< bool > &act, RankTwoTensor &returned_stress) const override
 The active yield surfaces, given a vector of yield functions. More...
 
void initialize ()
 
void execute ()
 
void finalize ()
 
virtual unsigned int numberSurfaces () const
 The number of yield surfaces for this plasticity model. More...
 
virtual void yieldFunctionV (const RankTwoTensor &stress, Real intnl, std::vector< Real > &f) const
 Calculates the yield functions. More...
 
virtual void dyieldFunction_dstressV (const RankTwoTensor &stress, Real intnl, std::vector< RankTwoTensor > &df_dstress) const
 The derivative of yield functions with respect to stress. More...
 
virtual void dyieldFunction_dintnlV (const RankTwoTensor &stress, Real intnl, std::vector< Real > &df_dintnl) const
 The derivative of yield functions with respect to the internal parameter. More...
 
virtual void flowPotentialV (const RankTwoTensor &stress, Real intnl, std::vector< RankTwoTensor > &r) const
 The flow potentials. More...
 
virtual void dflowPotential_dstressV (const RankTwoTensor &stress, Real intnl, std::vector< RankFourTensor > &dr_dstress) const
 The derivative of the flow potential with respect to stress. More...
 
virtual void dflowPotential_dintnlV (const RankTwoTensor &stress, Real intnl, std::vector< RankTwoTensor > &dr_dintnl) const
 The derivative of the flow potential with respect to the internal parameter. More...
 
virtual void hardPotentialV (const RankTwoTensor &stress, Real intnl, std::vector< Real > &h) const
 The hardening potential. More...
 
virtual void dhardPotential_dstressV (const RankTwoTensor &stress, Real intnl, std::vector< RankTwoTensor > &dh_dstress) const
 The derivative of the hardening potential with respect to stress. More...
 
virtual void dhardPotential_dintnlV (const RankTwoTensor &stress, Real intnl, std::vector< Real > &dh_dintnl) const
 The derivative of the hardening potential with respect to the internal parameter. More...
 
virtual bool useCustomReturnMap () const
 Returns false. You will want to override this in your derived class if you write a custom returnMap function. More...
 
virtual bool useCustomCTO () const
 Returns false. You will want to override this in your derived class if you write a custom consistent tangent operator function. More...
 
virtual bool returnMap (const RankTwoTensor &trial_stress, Real intnl_old, const RankFourTensor &E_ijkl, Real ep_plastic_tolerance, RankTwoTensor &returned_stress, Real &returned_intnl, std::vector< Real > &dpm, RankTwoTensor &delta_dp, std::vector< Real > &yf, bool &trial_stress_inadmissible) const
 Performs a custom return-map. More...
 
virtual RankFourTensor consistentTangentOperator (const RankTwoTensor &trial_stress, Real intnl_old, const RankTwoTensor &stress, Real intnl, const RankFourTensor &E_ijkl, const std::vector< Real > &cumulative_pm) const
 Calculates a custom consistent tangent operator. More...
 
bool KuhnTuckerSingleSurface (Real yf, Real dpm, Real dpm_tol) const
 Returns true if the Kuhn-Tucker conditions for the single surface are satisfied. More...
 

Public Attributes

const Real _f_tol
 Tolerance on yield function. More...
 
const Real _ic_tol
 Tolerance on internal constraint. More...
 

Protected Member Functions

Real yieldFunction (const RankTwoTensor &stress, Real intnl) const override
 The following functions are what you should override when building single-plasticity models. More...
 
RankTwoTensor dyieldFunction_dstress (const RankTwoTensor &stress, Real intnl) const override
 The derivative of yield function with respect to stress. More...
 
Real dyieldFunction_dintnl (const RankTwoTensor &stress, Real intnl) const override
 The derivative of yield function with respect to the internal parameter. More...
 
RankTwoTensor flowPotential (const RankTwoTensor &stress, Real intnl) const override
 The flow potential. More...
 
RankFourTensor dflowPotential_dstress (const RankTwoTensor &stress, Real intnl) const override
 The derivative of the flow potential with respect to stress. More...
 
RankTwoTensor dflowPotential_dintnl (const RankTwoTensor &stress, Real intnl) const override
 The derivative of the flow potential with respect to the internal parameter. More...
 
virtual Real tensile_strength (const Real internal_param) const
 tensile strength as a function of residual value, rate, and internal_param More...
 
virtual Real dtensile_strength (const Real internal_param) const
 d(tensile strength)/d(internal_param) as a function of residual value, rate, and internal_param More...
 
virtual Real hardPotential (const RankTwoTensor &stress, Real intnl) const
 The hardening potential. More...
 
virtual RankTwoTensor dhardPotential_dstress (const RankTwoTensor &stress, Real intnl) const
 The derivative of the hardening potential with respect to stress. More...
 
virtual Real dhardPotential_dintnl (const RankTwoTensor &stress, Real intnl) const
 The derivative of the hardening potential with respect to the internal parameter. More...
 

Protected Attributes

RealVectorValue _input_n
 Unit normal inputted by user. More...
 
RankTwoTensor _df_dsig
 Flow direction, which is constant in this case. More...
 
RealTensorValue _rot
 This rotation matrix rotates _input_n to (0, 0, 1) More...
 
const Real _a
 Yield function = _a * stress_zz - _strength;. More...
 
const TensorMechanicsHardeningModel_strength
 Yield function = _a * stress_zz - _strength;. More...
 

Detailed Description

Rate-independent associative weak-plane tensile failure with hardening/softening, and normal direction specified.

Definition at line 21 of file TensorMechanicsPlasticWeakPlaneTensileN.h.

Constructor & Destructor Documentation

TensorMechanicsPlasticWeakPlaneTensileN::TensorMechanicsPlasticWeakPlaneTensileN ( const InputParameters &  parameters)

Definition at line 23 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

26  _input_n(getParam<RealVectorValue>("normal_vector")),
27  _df_dsig(RankTwoTensor())
28 {
29  // cannot check the following for all values of strength, but this is a start
30  if (_strength.value(0) < 0)
31  mooseError("Weak plane tensile strength must not be negative");
32  if (_input_n.norm() == 0)
33  mooseError("Weak-plane normal vector must not have zero length");
34  else
35  _input_n /= _input_n.norm();
36  _rot = RotationMatrix::rotVecToZ(_input_n);
37 
38  for (unsigned i = 0; i < 3; ++i)
39  for (unsigned j = 0; j < 3; ++j)
40  _df_dsig(i, j) = _rot(2, i) * _rot(2, j);
41 }
RealTensorValue _rot
This rotation matrix rotates _input_n to (0, 0, 1)
const TensorMechanicsHardeningModel & _strength
Yield function = _a * stress_zz - _strength;.
RankTwoTensor _df_dsig
Flow direction, which is constant in this case.
RealVectorValue _input_n
Unit normal inputted by user.
virtual Real value(Real intnl) const
TensorMechanicsPlasticWeakPlaneTensile(const InputParameters &parameters)

Member Function Documentation

void TensorMechanicsPlasticWeakPlaneTensile::activeConstraints ( const std::vector< Real > &  f,
const RankTwoTensor &  stress,
Real  intnl,
const RankFourTensor &  Eijkl,
std::vector< bool > &  act,
RankTwoTensor &  returned_stress 
) const
overridevirtualinherited

The active yield surfaces, given a vector of yield functions.

This is used by FiniteStrainMultiPlasticity to determine the initial set of active constraints at the trial (stress, intnl) configuration. It is up to you (the coder) to determine how accurate you want the returned_stress to be. Currently it is only used by FiniteStrainMultiPlasticity to estimate a good starting value for the Newton-Rahson procedure, so currently it may not need to be super perfect.

Parameters
fvalues of the yield functions
stressstress tensor
intnlinternal parameter
Eijklelasticity tensor (stress = Eijkl*strain)
[out]actact[i] = true if the i_th yield function is active
[out]returned_stressApproximate value of the returned stress

Reimplemented from TensorMechanicsPlasticModel.

Definition at line 96 of file TensorMechanicsPlasticWeakPlaneTensile.C.

102 {
103  act.assign(1, false);
104 
105  if (f[0] <= _f_tol)
106  {
107  returned_stress = stress;
108  return;
109  }
110 
111  Real str = tensile_strength(intnl);
112 
113  RankTwoTensor n; // flow direction
114  for (unsigned i = 0; i < 3; ++i)
115  for (unsigned j = 0; j < 3; ++j)
116  n(i, j) = _a * Eijkl(i, j, 2, 2);
117 
118  // returned_stress = _a * stress - alpha*n
119  // where alpha = (_a * stress(2, 2) - str)/n(2, 2)
120  Real alpha = (_a * stress(2, 2) - str) / n(2, 2);
121 
122  for (unsigned i = 0; i < 3; ++i)
123  for (unsigned j = 0; j < 3; ++j)
124  returned_stress(i, j) = _a * stress(i, j) - alpha * n(i, j);
125 
126  act[0] = true;
127 }
const Real _a
Yield function = _a * stress_zz - _strength;.
virtual Real tensile_strength(const Real internal_param) const
tensile strength as a function of residual value, rate, and internal_param
const Real _f_tol
Tolerance on yield function.
RankFourTensor TensorMechanicsPlasticModel::consistentTangentOperator ( const RankTwoTensor &  trial_stress,
Real  intnl_old,
const RankTwoTensor &  stress,
Real  intnl,
const RankFourTensor &  E_ijkl,
const std::vector< Real > &  cumulative_pm 
) const
virtualinherited

Calculates a custom consistent tangent operator.

You may choose to over-ride this in your derived TensorMechanicsPlasticXXXX class.

(Note, if you over-ride returnMap, you will probably want to override consistentTangentOpertor too, otherwise it will default to E_ijkl.)

Parameters
stress_oldtrial stress before returning
intnl_oldinternal parameter before returning
stresscurrent returned stress state
intnlinternal parameter
E_ijklelasticity tensor
cumulative_pmthe cumulative plastic multipliers
Returns
the consistent tangent operator: E_ijkl if not over-ridden

Reimplemented in TensorMechanicsPlasticTensileMulti, TensorMechanicsPlasticDruckerPragerHyperbolic, TensorMechanicsPlasticMeanCapTC, and TensorMechanicsPlasticJ2.

Definition at line 249 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticJ2::consistentTangentOperator(), TensorMechanicsPlasticDruckerPragerHyperbolic::consistentTangentOperator(), TensorMechanicsPlasticMeanCapTC::consistentTangentOperator(), and TensorMechanicsPlasticTensileMulti::consistentTangentOperator().

256 {
257  return E_ijkl;
258 }
RankTwoTensor TensorMechanicsPlasticWeakPlaneTensileN::dflowPotential_dintnl ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The derivative of the flow potential with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
Returns
dr_dintnl(i, j) = dr(i, j)/dintnl

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 83 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

85 {
86  return RankTwoTensor();
87 }
void TensorMechanicsPlasticModel::dflowPotential_dintnlV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< RankTwoTensor > &  dr_dintnl 
) const
virtualinherited

The derivative of the flow potential with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
[out]dr_dintnldr_dintnl[alpha](i, j) = dr[alpha](i, j)/dintnl

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 134 of file TensorMechanicsPlasticModel.C.

137 {
138  return dr_dintnl.assign(1, dflowPotential_dintnl(stress, intnl));
139 }
virtual RankTwoTensor dflowPotential_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of the flow potential with respect to the internal parameter.
RankFourTensor TensorMechanicsPlasticWeakPlaneTensileN::dflowPotential_dstress ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The derivative of the flow potential with respect to stress.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
Returns
dr_dstress(i, j, k, l) = dr(i, j)/dstress(k, l)

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 76 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

78 {
79  return RankFourTensor();
80 }
void TensorMechanicsPlasticModel::dflowPotential_dstressV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< RankFourTensor > &  dr_dstress 
) const
virtualinherited

The derivative of the flow potential with respect to stress.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
[out]dr_dstressdr_dstress[alpha](i, j, k, l) = dr[alpha](i, j)/dstress(k, l)

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 120 of file TensorMechanicsPlasticModel.C.

123 {
124  return dr_dstress.assign(1, dflowPotential_dstress(stress, intnl));
125 }
virtual RankFourTensor dflowPotential_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of the flow potential with respect to stress.
Real TensorMechanicsPlasticModel::dhardPotential_dintnl ( const RankTwoTensor &  stress,
Real  intnl 
) const
protectedvirtualinherited

The derivative of the hardening potential with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the hardening potentials
intnlinternal parameter
Returns
the derivative

Reimplemented in TensorMechanicsPlasticMeanCapTC.

Definition at line 169 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticModel::dhardPotential_dintnlV().

171 {
172  return 0.0;
173 }
void TensorMechanicsPlasticModel::dhardPotential_dintnlV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< Real > &  dh_dintnl 
) const
virtualinherited

The derivative of the hardening potential with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the hardening potentials
intnlinternal parameter
[out]dh_dintnldh_dintnl[alpha] = dh[alpha]/dintnl

Definition at line 175 of file TensorMechanicsPlasticModel.C.

178 {
179  dh_dintnl.resize(numberSurfaces(), dhardPotential_dintnl(stress, intnl));
180 }
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.
virtual Real dhardPotential_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of the hardening potential with respect to the internal parameter. ...
RankTwoTensor TensorMechanicsPlasticModel::dhardPotential_dstress ( const RankTwoTensor &  stress,
Real  intnl 
) const
protectedvirtualinherited

The derivative of the hardening potential with respect to stress.

Parameters
stressthe stress at which to calculate the hardening potentials
intnlinternal parameter
Returns
dh_dstress(i, j) = dh/dstress(i, j)

Reimplemented in TensorMechanicsPlasticMeanCapTC.

Definition at line 155 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticModel::dhardPotential_dstressV().

157 {
158  return RankTwoTensor();
159 }
void TensorMechanicsPlasticModel::dhardPotential_dstressV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< RankTwoTensor > &  dh_dstress 
) const
virtualinherited

The derivative of the hardening potential with respect to stress.

Parameters
stressthe stress at which to calculate the hardening potentials
intnlinternal parameter
[out]dh_dstressdh_dstress[alpha](i, j) = dh[alpha]/dstress(i, j)

Definition at line 161 of file TensorMechanicsPlasticModel.C.

164 {
165  dh_dstress.assign(numberSurfaces(), dhardPotential_dstress(stress, intnl));
166 }
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.
virtual RankTwoTensor dhardPotential_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of the hardening potential with respect to stress.
Real TensorMechanicsPlasticWeakPlaneTensile::dtensile_strength ( const Real  internal_param) const
protectedvirtualinherited

d(tensile strength)/d(internal_param) as a function of residual value, rate, and internal_param

Definition at line 90 of file TensorMechanicsPlasticWeakPlaneTensile.C.

Referenced by dyieldFunction_dintnl(), and TensorMechanicsPlasticWeakPlaneTensile::dyieldFunction_dintnl().

91 {
92  return _strength.derivative(internal_param);
93 }
virtual Real derivative(Real intnl) const
const TensorMechanicsHardeningModel & _strength
Yield function = _a * stress_zz - _strength;.
Real TensorMechanicsPlasticWeakPlaneTensileN::dyieldFunction_dintnl ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The derivative of yield function with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
Returns
the derivative

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 62 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

64 {
65  return -dtensile_strength(intnl);
66 }
virtual Real dtensile_strength(const Real internal_param) const
d(tensile strength)/d(internal_param) as a function of residual value, rate, and internal_param ...
void TensorMechanicsPlasticModel::dyieldFunction_dintnlV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< Real > &  df_dintnl 
) const
virtualinherited

The derivative of yield functions with respect to the internal parameter.

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
[out]df_dintnldf_dintnl[alpha] = df[alpha]/dintnl

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 93 of file TensorMechanicsPlasticModel.C.

96 {
97  return df_dintnl.assign(1, dyieldFunction_dintnl(stress, intnl));
98 }
virtual Real dyieldFunction_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of yield function with respect to the internal parameter.
RankTwoTensor TensorMechanicsPlasticWeakPlaneTensileN::dyieldFunction_dstress ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The derivative of yield function with respect to stress.

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
Returns
df_dstress(i, j) = dyieldFunction/dstress(i, j)

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 55 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

57 {
58  return _df_dsig;
59 }
RankTwoTensor _df_dsig
Flow direction, which is constant in this case.
void TensorMechanicsPlasticModel::dyieldFunction_dstressV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< RankTwoTensor > &  df_dstress 
) const
virtualinherited

The derivative of yield functions with respect to stress.

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
[out]df_dstressdf_dstress[alpha](i, j) = dyieldFunction[alpha]/dstress(i, j)

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 79 of file TensorMechanicsPlasticModel.C.

82 {
83  df_dstress.assign(1, dyieldFunction_dstress(stress, intnl));
84 }
virtual RankTwoTensor dyieldFunction_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of yield function with respect to stress.
void TensorMechanicsPlasticModel::execute ( )
inherited

Definition at line 42 of file TensorMechanicsPlasticModel.C.

43 {
44 }
void TensorMechanicsPlasticModel::finalize ( )
inherited

Definition at line 47 of file TensorMechanicsPlasticModel.C.

48 {
49 }
RankTwoTensor TensorMechanicsPlasticWeakPlaneTensileN::flowPotential ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The flow potential.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
Returns
the flow potential

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 69 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

71 {
72  return _df_dsig;
73 }
RankTwoTensor _df_dsig
Flow direction, which is constant in this case.
void TensorMechanicsPlasticModel::flowPotentialV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< RankTwoTensor > &  r 
) const
virtualinherited

The flow potentials.

Parameters
stressthe stress at which to calculate the flow potential
intnlinternal parameter
[out]rr[alpha] is the flow potential for the "alpha" yield function

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 106 of file TensorMechanicsPlasticModel.C.

109 {
110  return r.assign(1, flowPotential(stress, intnl));
111 }
virtual RankTwoTensor flowPotential(const RankTwoTensor &stress, Real intnl) const
The flow potential.
Real TensorMechanicsPlasticModel::hardPotential ( const RankTwoTensor &  stress,
Real  intnl 
) const
protectedvirtualinherited

The hardening potential.

Parameters
stressthe stress at which to calculate the hardening potential
intnlinternal parameter
Returns
the hardening potential

Reimplemented in TensorMechanicsPlasticMeanCapTC.

Definition at line 142 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticModel::hardPotentialV().

143 {
144  return -1.0;
145 }
void TensorMechanicsPlasticModel::hardPotentialV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< Real > &  h 
) const
virtualinherited

The hardening potential.

Parameters
stressthe stress at which to calculate the hardening potential
intnlinternal parameter
[out]hh[alpha] is the hardening potential for the "alpha" yield function

Definition at line 147 of file TensorMechanicsPlasticModel.C.

150 {
151  h.assign(numberSurfaces(), hardPotential(stress, intnl));
152 }
virtual Real hardPotential(const RankTwoTensor &stress, Real intnl) const
The hardening potential.
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.
void TensorMechanicsPlasticModel::initialize ( )
inherited

Definition at line 37 of file TensorMechanicsPlasticModel.C.

38 {
39 }
bool TensorMechanicsPlasticModel::KuhnTuckerSingleSurface ( Real  yf,
Real  dpm,
Real  dpm_tol 
) const
inherited

Returns true if the Kuhn-Tucker conditions for the single surface are satisfied.

Parameters
yfYield function value
dpmplastic multiplier
dpm_toltolerance on plastic multiplier: viz dpm>-dpm_tol means "dpm is non-negative"

Definition at line 243 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticMohrCoulombMulti::KuhnTuckerOK(), TensorMechanicsPlasticTensileMulti::KuhnTuckerOK(), and TensorMechanicsPlasticModel::returnMap().

244 {
245  return (dpm == 0 && yf <= _f_tol) || (dpm > -dpm_tol && yf <= _f_tol && yf >= -_f_tol);
246 }
const Real _f_tol
Tolerance on yield function.
std::string TensorMechanicsPlasticWeakPlaneTensileN::modelName ( ) const
overridevirtual

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 90 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

91 {
92  return "WeakPlaneTensileN";
93 }
unsigned TensorMechanicsPlasticModel::numberSurfaces ( ) const
virtualinherited
bool TensorMechanicsPlasticModel::returnMap ( const RankTwoTensor &  trial_stress,
Real  intnl_old,
const RankFourTensor &  E_ijkl,
Real  ep_plastic_tolerance,
RankTwoTensor &  returned_stress,
Real &  returned_intnl,
std::vector< Real > &  dpm,
RankTwoTensor &  delta_dp,
std::vector< Real > &  yf,
bool &  trial_stress_inadmissible 
) const
virtualinherited

Performs a custom return-map.

You may choose to over-ride this in your derived TensorMechanicsPlasticXXXX class, and you may implement the return-map algorithm in any way that suits you. Eg, using a Newton-Raphson approach, or a radial-return, etc. This may also be used as a quick way of ascertaining whether (trial_stress, intnl_old) is in fact admissible.

For over-riding this function, please note the following.

(1) Denoting the return value of the function by "successful_return", the only possible output values should be: (A) trial_stress_inadmissible=false, successful_return=true. That is, (trial_stress, intnl_old) is in fact admissible (in the elastic domain). (B) trial_stress_inadmissible=true, successful_return=false. That is (trial_stress, intnl_old) is inadmissible (outside the yield surface), and you didn't return to the yield surface. (C) trial_stress_inadmissible=true, successful_return=true. That is (trial_stress, intnl_old) is inadmissible (outside the yield surface), but you did return to the yield surface. The default implementation only handles case (A) and (B): it does not attempt to do a return-map algorithm.

(2) you must correctly signal "successful_return" using the return value of this function. Don't assume the calling function will do Kuhn-Tucker checking and so forth!

(3) In cases (A) and (B) you needn't set returned_stress, returned_intnl, delta_dp, or dpm. This is for computational efficiency.

(4) In cases (A) and (B), you MUST place the yield function values at (trial_stress, intnl_old) into yf so the calling function can use this information optimally. You will have already calculated these yield function values, which can be quite expensive, and it's not very optimal for the calling function to have to re-calculate them.

(5) In case (C), you need to set: returned_stress (the returned value of stress) returned_intnl (the returned value of the internal variable) delta_dp (the change in plastic strain) dpm (the plastic multipliers needed to bring about the return) yf (yield function values at the returned configuration)

(Note, if you over-ride returnMap, you will probably want to override consistentTangentOpertor too, otherwise it will default to E_ijkl.)

Parameters
trial_stressThe trial stress
intnl_oldValue of the internal parameter
E_ijklElasticity tensor
ep_plastic_toleranceTolerance defined by the user for the plastic strain
[out]returned_stressIn case (C): lies on the yield surface after returning and produces the correct plastic strain (normality condition). Otherwise: not defined
[out]returned_intnlIn case (C): the value of the internal parameter after returning. Otherwise: not defined
[out]dpmIn case (C): the plastic multipliers needed to bring about the return. Otherwise: not defined
[out]delta_dpIn case (C): The change in plastic strain induced by the return process. Otherwise: not defined
[out]yfIn case (C): the yield function at (returned_stress, returned_intnl). Otherwise: the yield function at (trial_stress, intnl_old)
[out]trial_stress_inadmissibleShould be set to false if the trial_stress is admissible, and true if the trial_stress is inadmissible. This can be used by the calling prorgram
Returns
true if a successful return (or a return-map not needed), false if the trial_stress is inadmissible but the return process failed

Reimplemented in TensorMechanicsPlasticTensileMulti, TensorMechanicsPlasticMohrCoulombMulti, TensorMechanicsPlasticDruckerPragerHyperbolic, TensorMechanicsPlasticMeanCapTC, and TensorMechanicsPlasticJ2.

Definition at line 216 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticJ2::returnMap(), TensorMechanicsPlasticDruckerPragerHyperbolic::returnMap(), TensorMechanicsPlasticMeanCapTC::returnMap(), TensorMechanicsPlasticMohrCoulombMulti::returnMap(), and TensorMechanicsPlasticTensileMulti::returnMap().

226 {
227  trial_stress_inadmissible = false;
228  yieldFunctionV(trial_stress, intnl_old, yf);
229 
230  for (unsigned sf = 0; sf < numberSurfaces(); ++sf)
231  if (yf[sf] > _f_tol)
232  trial_stress_inadmissible = true;
233 
234  // example of checking Kuhn-Tucker
235  std::vector<Real> dpm(numberSurfaces(), 0);
236  for (unsigned sf = 0; sf < numberSurfaces(); ++sf)
237  if (!KuhnTuckerSingleSurface(yf[sf], dpm[sf], 0))
238  return false;
239  return true;
240 }
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.
bool KuhnTuckerSingleSurface(Real yf, Real dpm, Real dpm_tol) const
Returns true if the Kuhn-Tucker conditions for the single surface are satisfied.
const Real _f_tol
Tolerance on yield function.
virtual void yieldFunctionV(const RankTwoTensor &stress, Real intnl, std::vector< Real > &f) const
Calculates the yield functions.
Real TensorMechanicsPlasticWeakPlaneTensile::tensile_strength ( const Real  internal_param) const
protectedvirtualinherited

tensile strength as a function of residual value, rate, and internal_param

Definition at line 84 of file TensorMechanicsPlasticWeakPlaneTensile.C.

Referenced by TensorMechanicsPlasticWeakPlaneTensile::activeConstraints(), yieldFunction(), and TensorMechanicsPlasticWeakPlaneTensile::yieldFunction().

85 {
86  return _strength.value(internal_param);
87 }
const TensorMechanicsHardeningModel & _strength
Yield function = _a * stress_zz - _strength;.
virtual Real value(Real intnl) const
bool TensorMechanicsPlasticModel::useCustomCTO ( ) const
virtualinherited

Returns false. You will want to override this in your derived class if you write a custom consistent tangent operator function.

Reimplemented in TensorMechanicsPlasticTensileMulti, TensorMechanicsPlasticMeanCapTC, TensorMechanicsPlasticDruckerPragerHyperbolic, and TensorMechanicsPlasticJ2.

Definition at line 210 of file TensorMechanicsPlasticModel.C.

211 {
212  return false;
213 }
bool TensorMechanicsPlasticModel::useCustomReturnMap ( ) const
virtualinherited

Returns false. You will want to override this in your derived class if you write a custom returnMap function.

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, TensorMechanicsPlasticTensileMulti, TensorMechanicsPlasticMeanCapTC, TensorMechanicsPlasticDruckerPragerHyperbolic, and TensorMechanicsPlasticJ2.

Definition at line 204 of file TensorMechanicsPlasticModel.C.

205 {
206  return false;
207 }
Real TensorMechanicsPlasticWeakPlaneTensileN::yieldFunction ( const RankTwoTensor &  stress,
Real  intnl 
) const
overrideprotectedvirtual

The following functions are what you should override when building single-plasticity models.

The yield function

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
Returns
the yield function

Reimplemented from TensorMechanicsPlasticWeakPlaneTensile.

Definition at line 44 of file TensorMechanicsPlasticWeakPlaneTensileN.C.

46 {
47  Real s22 = 0;
48  for (unsigned i = 0; i < 3; ++i)
49  for (unsigned j = 0; j < 3; ++j)
50  s22 += _rot(2, i) * _rot(2, j) * stress(i, j);
51  return s22 - tensile_strength(intnl);
52 }
RealTensorValue _rot
This rotation matrix rotates _input_n to (0, 0, 1)
virtual Real tensile_strength(const Real internal_param) const
tensile strength as a function of residual value, rate, and internal_param
void TensorMechanicsPlasticModel::yieldFunctionV ( const RankTwoTensor &  stress,
Real  intnl,
std::vector< Real > &  f 
) const
virtualinherited

Calculates the yield functions.

Note that for single-surface plasticity you don't want to override this - override the private yieldFunction below

Parameters
stressthe stress at which to calculate the yield function
intnlinternal parameter
[out]fthe yield functions

Reimplemented in TensorMechanicsPlasticMohrCoulombMulti, and TensorMechanicsPlasticTensileMulti.

Definition at line 64 of file TensorMechanicsPlasticModel.C.

Referenced by TensorMechanicsPlasticModel::returnMap().

67 {
68  f.assign(1, yieldFunction(stress, intnl));
69 }
virtual Real yieldFunction(const RankTwoTensor &stress, Real intnl) const
The following functions are what you should override when building single-plasticity models...

Member Data Documentation

const Real TensorMechanicsPlasticWeakPlaneTensile::_a
protectedinherited
RankTwoTensor TensorMechanicsPlasticWeakPlaneTensileN::_df_dsig
protected

Flow direction, which is constant in this case.

Definition at line 45 of file TensorMechanicsPlasticWeakPlaneTensileN.h.

Referenced by dyieldFunction_dstress(), flowPotential(), and TensorMechanicsPlasticWeakPlaneTensileN().

const Real TensorMechanicsPlasticModel::_f_tol
inherited
const Real TensorMechanicsPlasticModel::_ic_tol
inherited

Tolerance on internal constraint.

Definition at line 174 of file TensorMechanicsPlasticModel.h.

RealVectorValue TensorMechanicsPlasticWeakPlaneTensileN::_input_n
protected

Unit normal inputted by user.

Definition at line 42 of file TensorMechanicsPlasticWeakPlaneTensileN.h.

Referenced by TensorMechanicsPlasticWeakPlaneTensileN().

RealTensorValue TensorMechanicsPlasticWeakPlaneTensileN::_rot
protected

This rotation matrix rotates _input_n to (0, 0, 1)

Definition at line 48 of file TensorMechanicsPlasticWeakPlaneTensileN.h.

Referenced by TensorMechanicsPlasticWeakPlaneTensileN(), and yieldFunction().

const TensorMechanicsHardeningModel& TensorMechanicsPlasticWeakPlaneTensile::_strength
protectedinherited

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