https://mooseframework.inl.gov
Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
SolidMechanicsPlasticTensile Class Reference

FiniteStrainTensile implements rate-independent associative tensile failure with hardening/softening in the finite-strain framework. More...

#include <SolidMechanicsPlasticTensile.h>

Inheritance diagram for SolidMechanicsPlasticTensile:
[legend]

Public Types

typedef DataFileName DataFileParameterType
 

Public Member Functions

 SolidMechanicsPlasticTensile (const InputParameters &parameters)
 
virtual std::string modelName () const override
 
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 void activeConstraints (const std::vector< Real > &f, const RankTwoTensor &stress, Real intnl, const RankFourTensor &Eijkl, std::vector< bool > &act, RankTwoTensor &returned_stress) const
 The active yield surfaces, given a vector of yield functions. 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...
 
SubProblemgetSubProblem () const
 
bool shouldDuplicateInitialExecution () const
 
virtual Real spatialValue (const Point &) const
 
virtual const std::vector< Point > spatialPoints () const
 
void gatherSum (T &value)
 
void gatherMax (T &value)
 
void gatherMin (T &value)
 
void gatherProxyValueMax (T1 &proxy, T2 &value)
 
void gatherProxyValueMin (T1 &proxy, T2 &value)
 
void setPrimaryThreadCopy (UserObject *primary)
 
UserObjectprimaryThreadCopy ()
 
std::set< UserObjectName > getDependObjects () const
 
virtual bool needThreadedCopy () const
 
const std::set< std::string > & getRequestedItems () override
 
const std::set< std::string > & getSuppliedItems () override
 
unsigned int systemNumber () const
 
virtual bool enabled () const
 
std::shared_ptr< MooseObjectgetSharedPtr ()
 
std::shared_ptr< const MooseObjectgetSharedPtr () const
 
MooseAppgetMooseApp () const
 
const std::string & type () const
 
virtual const std::string & name () const
 
std::string typeAndName () const
 
std::string errorPrefix (const std::string &error_type) const
 
void callMooseError (std::string msg, const bool with_prefix) const
 
MooseObjectParameterName uniqueParameterName (const std::string &parameter_name) const
 
const InputParametersparameters () const
 
MooseObjectName uniqueName () const
 
const T & getParam (const std::string &name) const
 
std::vector< std::pair< T1, T2 > > getParam (const std::string &param1, const std::string &param2) const
 
const T * queryParam (const std::string &name) const
 
const T & getRenamedParam (const std::string &old_name, const std::string &new_name) const
 
getCheckedPointerParam (const std::string &name, const std::string &error_string="") const
 
bool isParamValid (const std::string &name) const
 
bool isParamSetByUser (const std::string &nm) const
 
void paramError (const std::string &param, Args... args) const
 
void paramWarning (const std::string &param, Args... args) const
 
void paramInfo (const std::string &param, Args... args) const
 
void connectControllableParams (const std::string &parameter, const std::string &object_type, const std::string &object_name, const std::string &object_parameter) const
 
void mooseError (Args &&... args) const
 
void mooseErrorNonPrefixed (Args &&... args) const
 
void mooseDocumentedError (const std::string &repo_name, const unsigned int issue_num, Args &&... args) const
 
void mooseWarning (Args &&... args) const
 
void mooseWarningNonPrefixed (Args &&... args) const
 
void mooseDeprecated (Args &&... args) const
 
void mooseInfo (Args &&... args) const
 
std::string getDataFileName (const std::string &param) const
 
std::string getDataFileNameByName (const std::string &relative_path) const
 
std::string getDataFilePath (const std::string &relative_path) const
 
virtual void initialSetup ()
 
virtual void timestepSetup ()
 
virtual void jacobianSetup ()
 
virtual void residualSetup ()
 
virtual void customSetup (const ExecFlagType &)
 
const ExecFlagEnumgetExecuteOnEnum () const
 
UserObjectName getUserObjectName (const std::string &param_name) const
 
const T & getUserObject (const std::string &param_name, bool is_dependency=true) const
 
const T & getUserObjectByName (const UserObjectName &object_name, bool is_dependency=true) const
 
const UserObjectgetUserObjectBase (const std::string &param_name, bool is_dependency=true) const
 
const UserObjectgetUserObjectBaseByName (const UserObjectName &object_name, bool is_dependency=true) const
 
const std::vector< MooseVariableScalar *> & getCoupledMooseScalarVars ()
 
const std::set< TagID > & getScalarVariableCoupleableVectorTags () const
 
const std::set< TagID > & getScalarVariableCoupleableMatrixTags () const
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialProperty (const std::string &name, MaterialData &material_data, const unsigned int state=0)
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialProperty (const std::string &name, const unsigned int state=0)
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialProperty (const std::string &name, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialProperty (const std::string &name, MaterialData &material_data, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialProperty (const std::string &name, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialProperty (const std::string &name, const unsigned int state=0)
 
const ADMaterialProperty< T > & getADMaterialProperty (const std::string &name, MaterialData &material_data)
 
const ADMaterialProperty< T > & getADMaterialProperty (const std::string &name)
 
const ADMaterialProperty< T > & getADMaterialProperty (const std::string &name)
 
const MaterialProperty< T > & getMaterialPropertyOld (const std::string &name, MaterialData &material_data)
 
const MaterialProperty< T > & getMaterialPropertyOld (const std::string &name)
 
const MaterialProperty< T > & getMaterialPropertyOld (const std::string &name)
 
const MaterialProperty< T > & getMaterialPropertyOlder (const std::string &name, MaterialData &material_data)
 
const MaterialProperty< T > & getMaterialPropertyOlder (const std::string &name)
 
const MaterialProperty< T > & getMaterialPropertyOlder (const std::string &name)
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialPropertyByName (const MaterialPropertyName &name, MaterialData &material_data, const unsigned int state)
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialPropertyByName (const MaterialPropertyName &name, const unsigned int state=0)
 
const GenericMaterialProperty< T, is_ad > & getGenericMaterialPropertyByName (const MaterialPropertyName &name, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialPropertyByName (const MaterialPropertyName &name, MaterialData &material_data, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialPropertyByName (const MaterialPropertyName &name, const unsigned int state=0)
 
const MaterialProperty< T > & getMaterialPropertyByName (const MaterialPropertyName &name, const unsigned int state=0)
 
const ADMaterialProperty< T > & getADMaterialPropertyByName (const MaterialPropertyName &name, MaterialData &material_data)
 
const ADMaterialProperty< T > & getADMaterialPropertyByName (const MaterialPropertyName &name)
 
const ADMaterialProperty< T > & getADMaterialPropertyByName (const MaterialPropertyName &name)
 
const MaterialProperty< T > & getMaterialPropertyOldByName (const MaterialPropertyName &name, MaterialData &material_data)
 
const MaterialProperty< T > & getMaterialPropertyOldByName (const MaterialPropertyName &name)
 
const MaterialProperty< T > & getMaterialPropertyOldByName (const MaterialPropertyName &name)
 
const MaterialProperty< T > & getMaterialPropertyOlderByName (const MaterialPropertyName &name, MaterialData &material_data)
 
const MaterialProperty< T > & getMaterialPropertyOlderByName (const MaterialPropertyName &name)
 
const MaterialProperty< T > & getMaterialPropertyOlderByName (const MaterialPropertyName &name)
 
std::pair< const MaterialProperty< T > *, std::set< SubdomainID > > getBlockMaterialProperty (const MaterialPropertyName &name)
 
const GenericMaterialProperty< T, is_ad > & getGenericZeroMaterialProperty (const std::string &name)
 
const GenericMaterialProperty< T, is_ad > & getGenericZeroMaterialProperty ()
 
const GenericMaterialProperty< T, is_ad > & getGenericZeroMaterialPropertyByName (const std::string &prop_name)
 
const MaterialProperty< T > & getZeroMaterialProperty (Ts... args)
 
std::set< SubdomainIDgetMaterialPropertyBlocks (const std::string &name)
 
std::vector< SubdomainName > getMaterialPropertyBlockNames (const std::string &name)
 
std::set< BoundaryIDgetMaterialPropertyBoundaryIDs (const std::string &name)
 
std::vector< BoundaryName > getMaterialPropertyBoundaryNames (const std::string &name)
 
void checkBlockAndBoundaryCompatibility (std::shared_ptr< MaterialBase > discrete)
 
std::unordered_map< SubdomainID, std::vector< MaterialBase *> > buildRequiredMaterials (bool allow_stateful=true)
 
void statefulPropertiesAllowed (bool)
 
bool getMaterialPropertyCalled () const
 
virtual const std::unordered_set< unsigned int > & getMatPropDependencies () const
 
virtual void resolveOptionalProperties ()
 
const GenericMaterialProperty< T, is_ad > & getPossiblyConstantGenericMaterialPropertyByName (const MaterialPropertyName &prop_name, MaterialData &material_data, const unsigned int state)
 
bool isImplicit ()
 
Moose::StateArg determineState () const
 
virtual void threadJoin (const UserObject &) override
 
virtual void threadJoin (const UserObject &) override
 
virtual void subdomainSetup () override
 
virtual void subdomainSetup () override
 
bool hasUserObject (const std::string &param_name) const
 
bool hasUserObject (const std::string &param_name) const
 
bool hasUserObject (const std::string &param_name) const
 
bool hasUserObject (const std::string &param_name) const
 
bool hasUserObjectByName (const UserObjectName &object_name) const
 
bool hasUserObjectByName (const UserObjectName &object_name) const
 
bool hasUserObjectByName (const UserObjectName &object_name) const
 
bool hasUserObjectByName (const UserObjectName &object_name) const
 
const GenericOptionalMaterialProperty< T, is_ad > & getGenericOptionalMaterialProperty (const std::string &name, const unsigned int state=0)
 
const GenericOptionalMaterialProperty< T, is_ad > & getGenericOptionalMaterialProperty (const std::string &name, const unsigned int state=0)
 
const OptionalMaterialProperty< T > & getOptionalMaterialProperty (const std::string &name, const unsigned int state=0)
 
const OptionalMaterialProperty< T > & getOptionalMaterialProperty (const std::string &name, const unsigned int state=0)
 
const OptionalADMaterialProperty< T > & getOptionalADMaterialProperty (const std::string &name)
 
const OptionalADMaterialProperty< T > & getOptionalADMaterialProperty (const std::string &name)
 
const OptionalMaterialProperty< T > & getOptionalMaterialPropertyOld (const std::string &name)
 
const OptionalMaterialProperty< T > & getOptionalMaterialPropertyOld (const std::string &name)
 
const OptionalMaterialProperty< T > & getOptionalMaterialPropertyOlder (const std::string &name)
 
const OptionalMaterialProperty< T > & getOptionalMaterialPropertyOlder (const std::string &name)
 
MaterialBasegetMaterial (const std::string &name)
 
MaterialBasegetMaterial (const std::string &name)
 
MaterialBasegetMaterialByName (const std::string &name, bool no_warn=false)
 
MaterialBasegetMaterialByName (const std::string &name, bool no_warn=false)
 
bool hasMaterialProperty (const std::string &name)
 
bool hasMaterialProperty (const std::string &name)
 
bool hasMaterialPropertyByName (const std::string &name)
 
bool hasMaterialPropertyByName (const std::string &name)
 
bool hasADMaterialProperty (const std::string &name)
 
bool hasADMaterialProperty (const std::string &name)
 
bool hasADMaterialPropertyByName (const std::string &name)
 
bool hasADMaterialPropertyByName (const std::string &name)
 
bool hasGenericMaterialProperty (const std::string &name)
 
bool hasGenericMaterialProperty (const std::string &name)
 
bool hasGenericMaterialPropertyByName (const std::string &name)
 
bool hasGenericMaterialPropertyByName (const std::string &name)
 
const FunctiongetFunction (const std::string &name) const
 
const FunctiongetFunctionByName (const FunctionName &name) const
 
bool hasFunction (const std::string &param_name) const
 
bool hasFunctionByName (const FunctionName &name) const
 
bool isDefaultPostprocessorValue (const std::string &param_name, const unsigned int index=0) const
 
bool hasPostprocessor (const std::string &param_name, const unsigned int index=0) const
 
bool hasPostprocessorByName (const PostprocessorName &name) const
 
std::size_t coupledPostprocessors (const std::string &param_name) const
 
const PostprocessorName & getPostprocessorName (const std::string &param_name, const unsigned int index=0) const
 
const VectorPostprocessorValuegetVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name) const
 
const VectorPostprocessorValuegetVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name, bool needs_broadcast) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name, bool needs_broadcast) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name, bool needs_broadcast) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueOldByName (const VectorPostprocessorName &name, const std::string &vector_name) const
 
const VectorPostprocessorValuegetVectorPostprocessorValueOldByName (const VectorPostprocessorName &name, const std::string &vector_name, bool needs_broadcast) const
 
const ScatterVectorPostprocessorValuegetScatterVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name) const
 
const ScatterVectorPostprocessorValuegetScatterVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name) const
 
const ScatterVectorPostprocessorValuegetScatterVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name) const
 
const ScatterVectorPostprocessorValuegetScatterVectorPostprocessorValueOldByName (const VectorPostprocessorName &name, const std::string &vector_name) const
 
bool hasVectorPostprocessor (const std::string &param_name, const std::string &vector_name) const
 
bool hasVectorPostprocessor (const std::string &param_name) const
 
bool hasVectorPostprocessorByName (const VectorPostprocessorName &name, const std::string &vector_name) const
 
bool hasVectorPostprocessorByName (const VectorPostprocessorName &name) const
 
const VectorPostprocessorName & getVectorPostprocessorName (const std::string &param_name) const
 
T & getSampler (const std::string &name)
 
SamplergetSampler (const std::string &name)
 
T & getSamplerByName (const SamplerName &name)
 
SamplergetSamplerByName (const SamplerName &name)
 
virtual void meshChanged ()
 
virtual void meshDisplaced ()
 
PerfGraphperfGraph ()
 
const PostprocessorValuegetPostprocessorValue (const std::string &param_name, const unsigned int index=0) const
 
const PostprocessorValuegetPostprocessorValue (const std::string &param_name, const unsigned int index=0) const
 
const PostprocessorValuegetPostprocessorValueOld (const std::string &param_name, const unsigned int index=0) const
 
const PostprocessorValuegetPostprocessorValueOld (const std::string &param_name, const unsigned int index=0) const
 
const PostprocessorValuegetPostprocessorValueOlder (const std::string &param_name, const unsigned int index=0) const
 
const PostprocessorValuegetPostprocessorValueOlder (const std::string &param_name, const unsigned int index=0) const
 
virtual const PostprocessorValuegetPostprocessorValueByName (const PostprocessorName &name) const
 
virtual const PostprocessorValuegetPostprocessorValueByName (const PostprocessorName &name) const
 
const PostprocessorValuegetPostprocessorValueOldByName (const PostprocessorName &name) const
 
const PostprocessorValuegetPostprocessorValueOldByName (const PostprocessorName &name) const
 
const PostprocessorValuegetPostprocessorValueOlderByName (const PostprocessorName &name) const
 
const PostprocessorValuegetPostprocessorValueOlderByName (const PostprocessorName &name) const
 
bool isVectorPostprocessorDistributed (const std::string &param_name) const
 
bool isVectorPostprocessorDistributed (const std::string &param_name) const
 
bool isVectorPostprocessorDistributedByName (const VectorPostprocessorName &name) const
 
bool isVectorPostprocessorDistributedByName (const VectorPostprocessorName &name) const
 
const DistributiongetDistribution (const std::string &name) const
 
const T & getDistribution (const std::string &name) const
 
const DistributiongetDistribution (const std::string &name) const
 
const T & getDistribution (const std::string &name) const
 
const DistributiongetDistributionByName (const DistributionName &name) const
 
const T & getDistributionByName (const std::string &name) const
 
const DistributiongetDistributionByName (const DistributionName &name) const
 
const T & getDistributionByName (const std::string &name) const
 
const Parallel::Communicator & comm () const
 
processor_id_type n_processors () const
 
processor_id_type processor_id () const
 

Static Public Member Functions

static InputParameters validParams ()
 
static void sort (typename std::vector< T > &vector)
 
static void sortDFS (typename std::vector< T > &vector)
 
static void cyclicDependencyError (CyclicDependencyException< T2 > &e, const std::string &header)
 

Public Attributes

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

Static Public Attributes

static constexpr PropertyValue::id_type default_property_id
 
static constexpr PropertyValue::id_type zero_property_id
 
static constexpr auto SYSTEM
 
static constexpr auto NAME
 

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 smooth (const RankTwoTensor &stress) const
 returns the 'a' parameter - see doco for _tip_scheme More...
 
virtual Real dsmooth (const RankTwoTensor &stress) const
 returns the da/dstress_mean - see doco for _tip_scheme More...
 
virtual Real d2smooth (const RankTwoTensor &stress) const
 returns the d^2a/dstress_mean^2 - see doco for _tip_scheme 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...
 
virtual void addPostprocessorDependencyHelper (const PostprocessorName &name) const override
 
virtual void addVectorPostprocessorDependencyHelper (const VectorPostprocessorName &name) const override
 
virtual void addUserObjectDependencyHelper (const UserObject &uo) const override
 
void addReporterDependencyHelper (const ReporterName &reporter_name) override
 
const ReporterNamegetReporterName (const std::string &param_name) const
 
T & declareRestartableData (const std::string &data_name, Args &&... args)
 
ManagedValue< T > declareManagedRestartableDataWithContext (const std::string &data_name, void *context, Args &&... args)
 
const T & getRestartableData (const std::string &data_name) const
 
T & declareRestartableDataWithContext (const std::string &data_name, void *context, Args &&... args)
 
T & declareRecoverableData (const std::string &data_name, Args &&... args)
 
T & declareRestartableDataWithObjectName (const std::string &data_name, const std::string &object_name, Args &&... args)
 
T & declareRestartableDataWithObjectNameWithContext (const std::string &data_name, const std::string &object_name, void *context, Args &&... args)
 
std::string restartableName (const std::string &data_name) const
 
const T & getMeshProperty (const std::string &data_name, const std::string &prefix)
 
const T & getMeshProperty (const std::string &data_name)
 
bool hasMeshProperty (const std::string &data_name, const std::string &prefix) const
 
bool hasMeshProperty (const std::string &data_name, const std::string &prefix) const
 
bool hasMeshProperty (const std::string &data_name) const
 
bool hasMeshProperty (const std::string &data_name) const
 
std::string meshPropertyName (const std::string &data_name) const
 
PerfID registerTimedSection (const std::string &section_name, const unsigned int level) const
 
PerfID registerTimedSection (const std::string &section_name, const unsigned int level, const std::string &live_message, const bool print_dots=true) const
 
std::string timedSectionName (const std::string &section_name) const
 
bool isCoupledScalar (const std::string &var_name, unsigned int i=0) const
 
unsigned int coupledScalarComponents (const std::string &var_name) const
 
unsigned int coupledScalar (const std::string &var_name, unsigned int comp=0) const
 
libMesh::Order coupledScalarOrder (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarValue (const std::string &var_name, unsigned int comp=0) const
 
const ADVariableValueadCoupledScalarValue (const std::string &var_name, unsigned int comp=0) const
 
const GenericVariableValue< is_ad > & coupledGenericScalarValue (const std::string &var_name, unsigned int comp=0) const
 
const GenericVariableValue< false > & coupledGenericScalarValue (const std::string &var_name, const unsigned int comp) const
 
const GenericVariableValue< true > & coupledGenericScalarValue (const std::string &var_name, const unsigned int comp) const
 
const VariableValuecoupledVectorTagScalarValue (const std::string &var_name, TagID tag, unsigned int comp=0) const
 
const VariableValuecoupledMatrixTagScalarValue (const std::string &var_name, TagID tag, unsigned int comp=0) const
 
const VariableValuecoupledScalarValueOld (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarValueOlder (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDot (const std::string &var_name, unsigned int comp=0) const
 
const ADVariableValueadCoupledScalarDot (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDotDot (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDotOld (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDotDotOld (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDotDu (const std::string &var_name, unsigned int comp=0) const
 
const VariableValuecoupledScalarDotDotDu (const std::string &var_name, unsigned int comp=0) const
 
const MooseVariableScalargetScalarVar (const std::string &var_name, unsigned int comp) const
 
virtual void checkMaterialProperty (const std::string &name, const unsigned int state)
 
void markMatPropRequested (const std::string &)
 
MaterialPropertyName getMaterialPropertyName (const std::string &name) const
 
void checkExecutionStage ()
 
const T & getReporterValue (const std::string &param_name, const std::size_t time_index=0)
 
const T & getReporterValue (const std::string &param_name, ReporterMode mode, const std::size_t time_index=0)
 
const T & getReporterValue (const std::string &param_name, const std::size_t time_index=0)
 
const T & getReporterValue (const std::string &param_name, ReporterMode mode, const std::size_t time_index=0)
 
const T & getReporterValueByName (const ReporterName &reporter_name, const std::size_t time_index=0)
 
const T & getReporterValueByName (const ReporterName &reporter_name, ReporterMode mode, const std::size_t time_index=0)
 
const T & getReporterValueByName (const ReporterName &reporter_name, const std::size_t time_index=0)
 
const T & getReporterValueByName (const ReporterName &reporter_name, ReporterMode mode, const std::size_t time_index=0)
 
bool hasReporterValue (const std::string &param_name) const
 
bool hasReporterValue (const std::string &param_name) const
 
bool hasReporterValue (const std::string &param_name) const
 
bool hasReporterValue (const std::string &param_name) const
 
bool hasReporterValueByName (const ReporterName &reporter_name) const
 
bool hasReporterValueByName (const ReporterName &reporter_name) const
 
bool hasReporterValueByName (const ReporterName &reporter_name) const
 
bool hasReporterValueByName (const ReporterName &reporter_name) const
 
const GenericMaterialProperty< T, is_ad > * defaultGenericMaterialProperty (const std::string &name)
 
const GenericMaterialProperty< T, is_ad > * defaultGenericMaterialProperty (const std::string &name)
 
const MaterialProperty< T > * defaultMaterialProperty (const std::string &name)
 
const MaterialProperty< T > * defaultMaterialProperty (const std::string &name)
 
const ADMaterialProperty< T > * defaultADMaterialProperty (const std::string &name)
 
const ADMaterialProperty< T > * defaultADMaterialProperty (const std::string &name)
 

Static Protected Member Functions

static std::string meshPropertyName (const std::string &data_name, const std::string &prefix)
 

Protected Attributes

const SolidMechanicsHardeningModel_strength
 
MooseEnum _tip_scheme
 The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depends on the tip_scheme. More...
 
Real _small_smoother2
 Square of tip smoothing parameter to smooth the cone at mean_stress = T. More...
 
Real _cap_start
 smoothing parameter dictating when the 'cap' will start - see doco for _tip_scheme More...
 
Real _cap_rate
 dictates how quickly the 'cap' degenerates to a hemisphere - see doco for _tip_scheme More...
 
Real _tt
 edge smoothing parameter, in radians More...
 
Real _sin3tt
 sin(3*_tt) - useful for making comparisons with Lode angle More...
 
Real _lode_cutoff
 if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-loss More...
 
Real _ccc
 Abbo et al's C parameter. More...
 
Real _bbb
 Abbo et al's B parameter. More...
 
Real _aaa
 Abbo et al's A parameter. More...
 
SubProblem_subproblem
 
FEProblemBase_fe_problem
 
SystemBase_sys
 
const THREAD_ID _tid
 
Assembly_assembly
 
const Moose::CoordinateSystemType_coord_sys
 
const bool _duplicate_initial_execution
 
std::set< std::string > _depend_uo
 
const bool & _enabled
 
MooseApp_app
 
const std::string _type
 
const std::string _name
 
const InputParameters_pars
 
Factory_factory
 
ActionFactory_action_factory
 
const ExecFlagEnum_execute_enum
 
const ExecFlagType_current_execute_flag
 
MooseApp_restartable_app
 
const std::string _restartable_system_name
 
const THREAD_ID _restartable_tid
 
const bool _restartable_read_only
 
FEProblemBase_mci_feproblem
 
FEProblemBase_mdi_feproblem
 
MooseApp_pg_moose_app
 
const std::string _prefix
 
FEProblemBase_sc_fe_problem
 
const THREAD_ID _sc_tid
 
const Real_real_zero
 
const VariableValue_scalar_zero
 
const Point & _point_zero
 
const InputParameters_mi_params
 
const std::string _mi_name
 
const MooseObjectName _mi_moose_object_name
 
FEProblemBase_mi_feproblem
 
SubProblem_mi_subproblem
 
const THREAD_ID _mi_tid
 
const Moose::MaterialDataType _material_data_type
 
MaterialData_material_data
 
bool _stateful_allowed
 
bool _get_material_property_called
 
std::vector< std::unique_ptr< PropertyValue > > _default_properties
 
std::unordered_set< unsigned int_material_property_dependencies
 
const MaterialPropertyName _get_suffix
 
const bool _use_interpolated_state
 
const InputParameters_ti_params
 
FEProblemBase_ti_feproblem
 
bool _is_implicit
 
Real_t
 
const Real_t_old
 
int_t_step
 
Real_dt
 
Real_dt_old
 
bool _is_transient
 
const Parallel::Communicator & _communicator
 

Static Protected Attributes

static const std::string _interpolated_old
 
static const std::string _interpolated_older
 

Detailed Description

FiniteStrainTensile implements rate-independent associative tensile failure with hardening/softening in the finite-strain framework.

For 'hyperbolic' smoothing, the smoothing of the tip of the yield-surface cone is described in Zienkiewicz and Prande "Some useful forms of isotropic yield surfaces for soil and rock mechanics" (1977) In G Gudehus (editor) "Finite Elements in Geomechanics" Wile, Chichester, pp 179-190. For 'cap' smoothing, additional smoothing is performed. The smoothing of the edges of the cone is described in AJ Abbo, AV Lyamin, SW Sloan, JP Hambleton "A C2 continuous approximation to the Mohr-Coulomb yield surface" International Journal of Solids and Structures 48 (2011) 3001-3010

Definition at line 27 of file SolidMechanicsPlasticTensile.h.

Constructor & Destructor Documentation

◆ SolidMechanicsPlasticTensile()

SolidMechanicsPlasticTensile::SolidMechanicsPlasticTensile ( const InputParameters parameters)

Definition at line 64 of file SolidMechanicsPlasticTensile.C.

66  _strength(getUserObject<SolidMechanicsHardeningModel>("tensile_strength")),
67  _tip_scheme(getParam<MooseEnum>("tip_scheme")),
68  _small_smoother2(Utility::pow<2>(getParam<Real>("tensile_tip_smoother"))),
69  _cap_start(getParam<Real>("cap_start")),
70  _cap_rate(getParam<Real>("cap_rate")),
71  _tt(getParam<Real>("tensile_edge_smoother") * libMesh::pi / 180.0),
72  _sin3tt(std::sin(3.0 * _tt)),
73  _lode_cutoff(parameters.isParamValid("tensile_lode_cutoff")
74  ? getParam<Real>("tensile_lode_cutoff")
75  : 1.0e-5 * Utility::pow<2>(_f_tol))
76 
77 {
78  if (_lode_cutoff < 0)
79  mooseError("tensile_lode_cutoff must not be negative");
80  _ccc = (-std::cos(3.0 * _tt) * (std::cos(_tt) - std::sin(_tt) / std::sqrt(3.0)) -
81  3.0 * _sin3tt * (std::sin(_tt) + std::cos(_tt) / std::sqrt(3.0))) /
82  (18.0 * Utility::pow<3>(std::cos(3.0 * _tt)));
83  _bbb = (std::sin(6.0 * _tt) * (std::cos(_tt) - std::sin(_tt) / std::sqrt(3.0)) -
84  6.0 * std::cos(6.0 * _tt) * (std::sin(_tt) + std::cos(_tt) / std::sqrt(3.0))) /
85  (18.0 * Utility::pow<3>(std::cos(3.0 * _tt)));
86  _aaa = -std::sin(_tt) / std::sqrt(3.0) - _bbb * _sin3tt - _ccc * Utility::pow<2>(_sin3tt) +
87  std::cos(_tt);
88 }
MooseEnum _tip_scheme
The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depend...
Real _bbb
Abbo et al&#39;s B parameter.
Real _sin3tt
sin(3*_tt) - useful for making comparisons with Lode angle
Real _small_smoother2
Square of tip smoothing parameter to smooth the cone at mean_stress = T.
Real _cap_rate
dictates how quickly the &#39;cap&#39; degenerates to a hemisphere - see doco for _tip_scheme ...
SolidMechanicsPlasticModel(const InputParameters &parameters)
Real _lode_cutoff
if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-los...
const SolidMechanicsHardeningModel & _strength
const Real _f_tol
Tolerance on yield function.
Real _tt
edge smoothing parameter, in radians
Real _aaa
Abbo et al&#39;s A parameter.
void mooseError(Args &&... args) const
const InputParameters & parameters() const
Real _ccc
Abbo et al&#39;s C parameter.
Real _cap_start
smoothing parameter dictating when the &#39;cap&#39; will start - see doco for _tip_scheme ...
const Real pi
bool isParamValid(const std::string &name) const

Member Function Documentation

◆ activeConstraints()

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

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 in SolidMechanicsPlasticMohrCoulombMulti, SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticMeanCapTC, SolidMechanicsPlasticWeakPlaneShear, and SolidMechanicsPlasticWeakPlaneTensile.

Definition at line 186 of file SolidMechanicsPlasticModel.C.

192 {
193  mooseAssert(f.size() == numberSurfaces(),
194  "f incorrectly sized at " << f.size() << " in activeConstraints");
195  act.resize(numberSurfaces());
196  for (unsigned surface = 0; surface < numberSurfaces(); ++surface)
197  act[surface] = (f[surface] > _f_tol);
198 }
Real f(Real x)
Test function for Brents method.
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.
const Real _f_tol
Tolerance on yield function.

◆ consistentTangentOperator()

RankFourTensor SolidMechanicsPlasticModel::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 SolidMechanicsPlasticXXXX 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 SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticDruckerPragerHyperbolic, SolidMechanicsPlasticMeanCapTC, and SolidMechanicsPlasticJ2.

Definition at line 252 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticJ2::consistentTangentOperator(), SolidMechanicsPlasticDruckerPragerHyperbolic::consistentTangentOperator(), SolidMechanicsPlasticMeanCapTC::consistentTangentOperator(), and SolidMechanicsPlasticTensileMulti::consistentTangentOperator().

259 {
260  return E_ijkl;
261 }

◆ d2smooth()

Real SolidMechanicsPlasticTensile::d2smooth ( const RankTwoTensor stress) const
protectedvirtual

returns the d^2a/dstress_mean^2 - see doco for _tip_scheme

Definition at line 290 of file SolidMechanicsPlasticTensile.C.

Referenced by dflowPotential_dstress().

291 {
292  Real d2smoother2 = 0;
293  if (_tip_scheme == "cap")
294  {
295  Real x = stress.trace() / 3.0 - _cap_start;
296  Real p = 0;
297  Real dp_dx = 0;
298  Real d2p_dx2 = 0;
299  if (x > 0)
300  {
301  p = x * (1 - std::exp(-_cap_rate * x));
302  dp_dx = (1 - std::exp(-_cap_rate * x)) + x * _cap_rate * std::exp(-_cap_rate * x);
303  d2p_dx2 = 2.0 * _cap_rate * std::exp(-_cap_rate * x) -
304  x * Utility::pow<2>(_cap_rate) * std::exp(-_cap_rate * x);
305  }
306  d2smoother2 += 2.0 * Utility::pow<2>(dp_dx) + 2.0 * p * d2p_dx2;
307  }
308  return d2smoother2;
309 }
MooseEnum _tip_scheme
The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depend...
Real _cap_rate
dictates how quickly the &#39;cap&#39; degenerates to a hemisphere - see doco for _tip_scheme ...
const std::vector< double > x
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Real _cap_start
smoothing parameter dictating when the &#39;cap&#39; will start - see doco for _tip_scheme ...

◆ dflowPotential_dintnl()

RankTwoTensor SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 237 of file SolidMechanicsPlasticTensile.C.

239 {
240  return RankTwoTensor();
241 }

◆ dflowPotential_dintnlV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 137 of file SolidMechanicsPlasticModel.C.

140 {
141  return dr_dintnl.assign(1, dflowPotential_dintnl(stress, intnl));
142 }
virtual RankTwoTensor dflowPotential_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of the flow potential with respect to the internal parameter.

◆ dflowPotential_dstress()

RankFourTensor SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 160 of file SolidMechanicsPlasticTensile.C.

162 {
163  Real mean_stress = stress.trace() / 3.0;
164  RankTwoTensor dmean_stress = stress.dtrace() / 3.0;
165  Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
166  if (sin3Lode <= _sin3tt)
167  {
168  // the non-edge-smoothed version
169  std::vector<Real> eigvals;
170  std::vector<RankTwoTensor> deigvals;
171  std::vector<RankFourTensor> d2eigvals;
172  stress.dsymmetricEigenvalues(eigvals, deigvals);
173  stress.d2symmetricEigenvalues(d2eigvals);
174 
175  Real denom = std::sqrt(smooth(stress) + Utility::pow<2>(eigvals[2] - mean_stress));
176  Real denom3 = Utility::pow<3>(denom);
177  RankTwoTensor numer_part = deigvals[2] - dmean_stress;
178  RankTwoTensor numer_full =
179  0.5 * dsmooth(stress) * dmean_stress + (eigvals[2] - mean_stress) * numer_part;
180  Real d2smooth_over_denom = d2smooth(stress) / denom;
181 
182  RankFourTensor dr_dstress = (eigvals[2] - mean_stress) * d2eigvals[2] / denom;
183  for (unsigned i = 0; i < 3; ++i)
184  for (unsigned j = 0; j < 3; ++j)
185  for (unsigned k = 0; k < 3; ++k)
186  for (unsigned l = 0; l < 3; ++l)
187  {
188  dr_dstress(i, j, k, l) +=
189  0.5 * d2smooth_over_denom * dmean_stress(i, j) * dmean_stress(k, l);
190  dr_dstress(i, j, k, l) += numer_part(i, j) * numer_part(k, l) / denom;
191  dr_dstress(i, j, k, l) -= numer_full(i, j) * numer_full(k, l) / denom3;
192  }
193  return dr_dstress;
194  }
195  else
196  {
197  // the edge-smoothed version
198  RankTwoTensor dsin3Lode = stress.dsin3Lode(_lode_cutoff);
199  Real kk = _aaa + _bbb * sin3Lode + _ccc * Utility::pow<2>(sin3Lode);
200  RankTwoTensor dkk = (_bbb + 2.0 * _ccc * sin3Lode) * dsin3Lode;
201  RankFourTensor d2kk = (_bbb + 2.0 * _ccc * sin3Lode) * stress.d2sin3Lode(_lode_cutoff);
202  for (unsigned i = 0; i < 3; ++i)
203  for (unsigned j = 0; j < 3; ++j)
204  for (unsigned k = 0; k < 3; ++k)
205  for (unsigned l = 0; l < 3; ++l)
206  d2kk(i, j, k, l) += 2.0 * _ccc * dsin3Lode(i, j) * dsin3Lode(k, l);
207 
208  Real sibar2 = stress.secondInvariant();
209  RankTwoTensor dsibar2 = stress.dsecondInvariant();
210  RankFourTensor d2sibar2 = stress.d2secondInvariant();
211 
212  Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
213  Real denom3 = Utility::pow<3>(denom);
214  Real d2smooth_over_denom = d2smooth(stress) / denom;
215  RankTwoTensor numer_full =
216  0.5 * dsmooth(stress) * dmean_stress + 0.5 * dsibar2 * kk * kk + sibar2 * kk * dkk;
217 
218  RankFourTensor dr_dstress = (0.5 * d2sibar2 * Utility::pow<2>(kk) + sibar2 * kk * d2kk) / denom;
219  for (unsigned i = 0; i < 3; ++i)
220  for (unsigned j = 0; j < 3; ++j)
221  for (unsigned k = 0; k < 3; ++k)
222  for (unsigned l = 0; l < 3; ++l)
223  {
224  dr_dstress(i, j, k, l) +=
225  0.5 * d2smooth_over_denom * dmean_stress(i, j) * dmean_stress(k, l);
226  dr_dstress(i, j, k, l) +=
227  (dsibar2(i, j) * dkk(k, l) * kk + dkk(i, j) * dsibar2(k, l) * kk +
228  sibar2 * dkk(i, j) * dkk(k, l)) /
229  denom;
230  dr_dstress(i, j, k, l) -= numer_full(i, j) * numer_full(k, l) / denom3;
231  }
232  return dr_dstress;
233  }
234 }
RankTwoTensorTempl< Real > dsecondInvariant() const
RankFourTensorTempl< Real > d2secondInvariant() const
Real sin3Lode(const Real &r0, const Real &r0_value) const
void dsymmetricEigenvalues(std::vector< Real > &eigvals, std::vector< RankTwoTensorTempl< Real >> &deigvals) const
RankTwoTensorTempl< Real > dtrace() const
Real _bbb
Abbo et al&#39;s B parameter.
Real _sin3tt
sin(3*_tt) - useful for making comparisons with Lode angle
RankTwoTensorTempl< Real > dsin3Lode(const Real &r0) const
Real _lode_cutoff
if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-los...
void d2symmetricEigenvalues(std::vector< RankFourTensorTempl< Real >> &deriv) const
RankFourTensorTempl< Real > d2sin3Lode(const Real &r0) const
Real _aaa
Abbo et al&#39;s A parameter.
virtual Real d2smooth(const RankTwoTensor &stress) const
returns the d^2a/dstress_mean^2 - see doco for _tip_scheme
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
static const std::complex< double > j(0, 1)
Complex number "j" (also known as "i")
Real _ccc
Abbo et al&#39;s C parameter.
virtual Real smooth(const RankTwoTensor &stress) const
returns the &#39;a&#39; parameter - see doco for _tip_scheme
static const std::string k
Definition: NS.h:130
virtual Real dsmooth(const RankTwoTensor &stress) const
returns the da/dstress_mean - see doco for _tip_scheme

◆ dflowPotential_dstressV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 123 of file SolidMechanicsPlasticModel.C.

126 {
127  return dr_dstress.assign(1, dflowPotential_dstress(stress, intnl));
128 }
virtual RankFourTensor dflowPotential_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of the flow potential with respect to stress.

◆ dhardPotential_dintnl()

Real SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMeanCapTC.

Definition at line 172 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::dhardPotential_dintnlV().

174 {
175  return 0.0;
176 }

◆ dhardPotential_dintnlV()

void SolidMechanicsPlasticModel::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 178 of file SolidMechanicsPlasticModel.C.

181 {
182  dh_dintnl.resize(numberSurfaces(), dhardPotential_dintnl(stress, intnl));
183 }
virtual Real dhardPotential_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of the hardening potential with respect to the internal parameter. ...
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.

◆ dhardPotential_dstress()

RankTwoTensor SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMeanCapTC.

Definition at line 158 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::dhardPotential_dstressV().

160 {
161  return RankTwoTensor();
162 }

◆ dhardPotential_dstressV()

void SolidMechanicsPlasticModel::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 164 of file SolidMechanicsPlasticModel.C.

167 {
168  dh_dstress.assign(numberSurfaces(), dhardPotential_dstress(stress, intnl));
169 }
virtual RankTwoTensor dhardPotential_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of the hardening potential with respect to stress.
virtual unsigned int numberSurfaces() const
The number of yield surfaces for this plasticity model.

◆ dsmooth()

Real SolidMechanicsPlasticTensile::dsmooth ( const RankTwoTensor stress) const
protectedvirtual

returns the da/dstress_mean - see doco for _tip_scheme

Definition at line 271 of file SolidMechanicsPlasticTensile.C.

Referenced by dflowPotential_dstress(), and dyieldFunction_dstress().

272 {
273  Real dsmoother2 = 0;
274  if (_tip_scheme == "cap")
275  {
276  Real x = stress.trace() / 3.0 - _cap_start;
277  Real p = 0;
278  Real dp_dx = 0;
279  if (x > 0)
280  {
281  p = x * (1 - std::exp(-_cap_rate * x));
282  dp_dx = (1 - std::exp(-_cap_rate * x)) + x * _cap_rate * std::exp(-_cap_rate * x);
283  }
284  dsmoother2 += 2.0 * p * dp_dx;
285  }
286  return dsmoother2;
287 }
MooseEnum _tip_scheme
The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depend...
Real _cap_rate
dictates how quickly the &#39;cap&#39; degenerates to a hemisphere - see doco for _tip_scheme ...
const std::vector< double > x
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Real _cap_start
smoothing parameter dictating when the &#39;cap&#39; will start - see doco for _tip_scheme ...

◆ dtensile_strength()

Real SolidMechanicsPlasticTensile::dtensile_strength ( const Real  internal_param) const
protectedvirtual

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

Definition at line 250 of file SolidMechanicsPlasticTensile.C.

Referenced by dyieldFunction_dintnl().

251 {
252  return _strength.derivative(internal_param);
253 }
const SolidMechanicsHardeningModel & _strength
virtual Real derivative(Real intnl) const

◆ dyieldFunction_dintnl()

Real SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 146 of file SolidMechanicsPlasticTensile.C.

148 {
149  return -dtensile_strength(intnl);
150 }
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 ...

◆ dyieldFunction_dintnlV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 96 of file SolidMechanicsPlasticModel.C.

99 {
100  return df_dintnl.assign(1, dyieldFunction_dintnl(stress, intnl));
101 }
virtual Real dyieldFunction_dintnl(const RankTwoTensor &stress, Real intnl) const
The derivative of yield function with respect to the internal parameter.

◆ dyieldFunction_dstress()

RankTwoTensor SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 114 of file SolidMechanicsPlasticTensile.C.

Referenced by flowPotential().

116 {
117  Real mean_stress = stress.trace() / 3.0;
118  RankTwoTensor dmean_stress = stress.dtrace() / 3.0;
119  Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
120  if (sin3Lode <= _sin3tt)
121  {
122  // the non-edge-smoothed version
123  std::vector<Real> eigvals;
124  std::vector<RankTwoTensor> deigvals;
125  stress.dsymmetricEigenvalues(eigvals, deigvals);
126  Real denom = std::sqrt(smooth(stress) + Utility::pow<2>(eigvals[2] - mean_stress));
127  return dmean_stress + (0.5 * dsmooth(stress) * dmean_stress +
128  (eigvals[2] - mean_stress) * (deigvals[2] - dmean_stress)) /
129  denom;
130  }
131  else
132  {
133  // the edge-smoothed version
134  Real kk = _aaa + _bbb * sin3Lode + _ccc * Utility::pow<2>(sin3Lode);
135  RankTwoTensor dkk = (_bbb + 2.0 * _ccc * sin3Lode) * stress.dsin3Lode(_lode_cutoff);
136  Real sibar2 = stress.secondInvariant();
137  RankTwoTensor dsibar2 = stress.dsecondInvariant();
138  Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
139  return dmean_stress + (0.5 * dsmooth(stress) * dmean_stress +
140  0.5 * dsibar2 * Utility::pow<2>(kk) + sibar2 * kk * dkk) /
141  denom;
142  }
143 }
RankTwoTensorTempl< Real > dsecondInvariant() const
Real sin3Lode(const Real &r0, const Real &r0_value) const
void dsymmetricEigenvalues(std::vector< Real > &eigvals, std::vector< RankTwoTensorTempl< Real >> &deigvals) const
RankTwoTensorTempl< Real > dtrace() const
Real _bbb
Abbo et al&#39;s B parameter.
Real _sin3tt
sin(3*_tt) - useful for making comparisons with Lode angle
RankTwoTensorTempl< Real > dsin3Lode(const Real &r0) const
Real _lode_cutoff
if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-los...
Real _aaa
Abbo et al&#39;s A parameter.
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Real _ccc
Abbo et al&#39;s C parameter.
virtual Real smooth(const RankTwoTensor &stress) const
returns the &#39;a&#39; parameter - see doco for _tip_scheme
virtual Real dsmooth(const RankTwoTensor &stress) const
returns the da/dstress_mean - see doco for _tip_scheme

◆ dyieldFunction_dstressV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 82 of file SolidMechanicsPlasticModel.C.

85 {
86  df_dstress.assign(1, dyieldFunction_dstress(stress, intnl));
87 }
virtual RankTwoTensor dyieldFunction_dstress(const RankTwoTensor &stress, Real intnl) const
The derivative of yield function with respect to stress.

◆ execute()

void SolidMechanicsPlasticModel::execute ( )
virtualinherited

Implements GeneralUserObject.

Definition at line 45 of file SolidMechanicsPlasticModel.C.

46 {
47 }

◆ finalize()

void SolidMechanicsPlasticModel::finalize ( )
virtualinherited

Implements GeneralUserObject.

Definition at line 50 of file SolidMechanicsPlasticModel.C.

51 {
52 }

◆ flowPotential()

RankTwoTensor SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 153 of file SolidMechanicsPlasticTensile.C.

154 {
155  // This plasticity is associative so
156  return dyieldFunction_dstress(stress, intnl);
157 }
RankTwoTensor dyieldFunction_dstress(const RankTwoTensor &stress, Real intnl) const override
The derivative of yield function with respect to stress.

◆ flowPotentialV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 109 of file SolidMechanicsPlasticModel.C.

112 {
113  return r.assign(1, flowPotential(stress, intnl));
114 }
virtual RankTwoTensor flowPotential(const RankTwoTensor &stress, Real intnl) const
The flow potential.

◆ hardPotential()

Real SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMeanCapTC.

Definition at line 145 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::hardPotentialV().

146 {
147  return -1.0;
148 }

◆ hardPotentialV()

void SolidMechanicsPlasticModel::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 150 of file SolidMechanicsPlasticModel.C.

153 {
154  h.assign(numberSurfaces(), hardPotential(stress, intnl));
155 }
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.

◆ initialize()

void SolidMechanicsPlasticModel::initialize ( )
virtualinherited

Implements GeneralUserObject.

Definition at line 40 of file SolidMechanicsPlasticModel.C.

41 {
42 }

◆ KuhnTuckerSingleSurface()

bool SolidMechanicsPlasticModel::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 246 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticMohrCoulombMulti::KuhnTuckerOK(), SolidMechanicsPlasticTensileMulti::KuhnTuckerOK(), and SolidMechanicsPlasticModel::returnMap().

247 {
248  return (dpm == 0 && yf <= _f_tol) || (dpm > -dpm_tol && yf <= _f_tol && yf >= -_f_tol);
249 }
const Real _f_tol
Tolerance on yield function.

◆ modelName()

std::string SolidMechanicsPlasticTensile::modelName ( ) const
overridevirtual

Implements SolidMechanicsPlasticModel.

Definition at line 312 of file SolidMechanicsPlasticTensile.C.

313 {
314  return "Tensile";
315 }

◆ numberSurfaces()

unsigned SolidMechanicsPlasticModel::numberSurfaces ( ) const
virtualinherited

◆ returnMap()

bool SolidMechanicsPlasticModel::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 SolidMechanicsPlasticXXXX 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 SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticMohrCoulombMulti, SolidMechanicsPlasticDruckerPragerHyperbolic, SolidMechanicsPlasticMeanCapTC, and SolidMechanicsPlasticJ2.

Definition at line 219 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticJ2::returnMap(), SolidMechanicsPlasticDruckerPragerHyperbolic::returnMap(), SolidMechanicsPlasticMeanCapTC::returnMap(), SolidMechanicsPlasticMohrCoulombMulti::returnMap(), and SolidMechanicsPlasticTensileMulti::returnMap().

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

◆ smooth()

Real SolidMechanicsPlasticTensile::smooth ( const RankTwoTensor stress) const
protectedvirtual

returns the 'a' parameter - see doco for _tip_scheme

Definition at line 256 of file SolidMechanicsPlasticTensile.C.

Referenced by dflowPotential_dstress(), dyieldFunction_dstress(), and yieldFunction().

257 {
258  Real smoother2 = _small_smoother2;
259  if (_tip_scheme == "cap")
260  {
261  Real x = stress.trace() / 3.0 - _cap_start;
262  Real p = 0;
263  if (x > 0)
264  p = x * (1 - std::exp(-_cap_rate * x));
265  smoother2 += Utility::pow<2>(p);
266  }
267  return smoother2;
268 }
MooseEnum _tip_scheme
The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depend...
Real _small_smoother2
Square of tip smoothing parameter to smooth the cone at mean_stress = T.
Real _cap_rate
dictates how quickly the &#39;cap&#39; degenerates to a hemisphere - see doco for _tip_scheme ...
const std::vector< double > x
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Real _cap_start
smoothing parameter dictating when the &#39;cap&#39; will start - see doco for _tip_scheme ...

◆ tensile_strength()

Real SolidMechanicsPlasticTensile::tensile_strength ( const Real  internal_param) const
protectedvirtual

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

Definition at line 244 of file SolidMechanicsPlasticTensile.C.

Referenced by yieldFunction().

245 {
246  return _strength.value(internal_param);
247 }
virtual Real value(Real intnl) const
const SolidMechanicsHardeningModel & _strength

◆ useCustomCTO()

bool SolidMechanicsPlasticModel::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 SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticMeanCapTC, SolidMechanicsPlasticDruckerPragerHyperbolic, and SolidMechanicsPlasticJ2.

Definition at line 213 of file SolidMechanicsPlasticModel.C.

214 {
215  return false;
216 }

◆ useCustomReturnMap()

bool SolidMechanicsPlasticModel::useCustomReturnMap ( ) const
virtualinherited

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

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticMeanCapTC, SolidMechanicsPlasticDruckerPragerHyperbolic, and SolidMechanicsPlasticJ2.

Definition at line 207 of file SolidMechanicsPlasticModel.C.

208 {
209  return false;
210 }

◆ validParams()

InputParameters SolidMechanicsPlasticTensile::validParams ( )
static

Definition at line 21 of file SolidMechanicsPlasticTensile.C.

22 {
24  params.addRequiredParam<UserObjectName>(
25  "tensile_strength",
26  "A SolidMechanicsHardening UserObject that defines hardening of the tensile strength");
27  params.addRangeCheckedParam<Real>(
28  "tensile_edge_smoother",
29  25.0,
30  "tensile_edge_smoother>=0 & tensile_edge_smoother<=30",
31  "Smoothing parameter: the edges of the cone are smoothed by the given amount.");
32  MooseEnum tip_scheme("hyperbolic cap", "hyperbolic");
33  params.addParam<MooseEnum>(
34  "tip_scheme", tip_scheme, "Scheme by which the pyramid's tip will be smoothed.");
35  params.addRequiredRangeCheckedParam<Real>("tensile_tip_smoother",
36  "tensile_tip_smoother>=0",
37  "For the 'hyperbolic' tip_scheme, the pyramid vertex "
38  "will be smoothed by the given amount. For the 'cap' "
39  "tip_scheme, additional smoothing will occur. Typical "
40  "value is 0.1*tensile_strength");
41  params.addParam<Real>(
42  "cap_start",
43  0.0,
44  "For the 'cap' tip_scheme, smoothing is performed in the stress_mean > cap_start region");
45  params.addRangeCheckedParam<Real>("cap_rate",
46  0.0,
47  "cap_rate>=0",
48  "For the 'cap' tip_scheme, this controls how quickly the cap "
49  "degenerates to a hemisphere: small values mean a slow "
50  "degeneration to a hemisphere (and zero means the 'cap' will "
51  "be totally inactive). Typical value is 1/tensile_strength");
52  params.addParam<Real>("tensile_lode_cutoff",
53  "If the second invariant of stress is less than "
54  "this amount, the Lode angle is assumed to be zero. "
55  "This is to guard against precision-loss problems, "
56  "and this parameter should be set small. Default = "
57  "0.00001*((yield_Function_tolerance)^2)");
58  params.addClassDescription(
59  "Associative tensile plasticity with hardening/softening, and tensile_strength = 1");
60 
61  return params;
62 }
void addRequiredRangeCheckedParam(const std::string &name, const std::string &parsed_function, const std::string &doc_string)
void addParam(const std::string &name, const std::initializer_list< typename T::value_type > &value, const std::string &doc_string)
void addRequiredParam(const std::string &name, const std::string &doc_string)
static InputParameters validParams()
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
void addClassDescription(const std::string &doc_string)
void addRangeCheckedParam(const std::string &name, const T &value, const std::string &parsed_function, const std::string &doc_string)

◆ yieldFunction()

Real SolidMechanicsPlasticTensile::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 SolidMechanicsPlasticModel.

Definition at line 91 of file SolidMechanicsPlasticTensile.C.

92 {
93  Real mean_stress = stress.trace() / 3.0;
94  Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
95  if (sin3Lode <= _sin3tt)
96  {
97  // the non-edge-smoothed version
98  std::vector<Real> eigvals;
99  stress.symmetricEigenvalues(eigvals);
100  return mean_stress + std::sqrt(smooth(stress) + Utility::pow<2>(eigvals[2] - mean_stress)) -
101  tensile_strength(intnl);
102  }
103  else
104  {
105  // the edge-smoothed version
106  Real kk = _aaa + _bbb * sin3Lode + _ccc * Utility::pow<2>(sin3Lode);
107  Real sibar2 = stress.secondInvariant();
108  return mean_stress + std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk)) -
109  tensile_strength(intnl);
110  }
111 }
void symmetricEigenvalues(std::vector< Real > &eigvals) const
Real sin3Lode(const Real &r0, const Real &r0_value) const
Real _bbb
Abbo et al&#39;s B parameter.
Real _sin3tt
sin(3*_tt) - useful for making comparisons with Lode angle
virtual Real tensile_strength(const Real internal_param) const
tensile strength as a function of residual value, rate, and internal_param
Real _lode_cutoff
if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-los...
Real _aaa
Abbo et al&#39;s A parameter.
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
Real _ccc
Abbo et al&#39;s C parameter.
virtual Real smooth(const RankTwoTensor &stress) const
returns the &#39;a&#39; parameter - see doco for _tip_scheme

◆ yieldFunctionV()

void SolidMechanicsPlasticModel::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 SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 67 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::returnMap().

70 {
71  f.assign(1, yieldFunction(stress, intnl));
72 }
virtual Real yieldFunction(const RankTwoTensor &stress, Real intnl) const
The following functions are what you should override when building single-plasticity models...
Real f(Real x)
Test function for Brents method.

Member Data Documentation

◆ _aaa

Real SolidMechanicsPlasticTensile::_aaa
protected

◆ _bbb

Real SolidMechanicsPlasticTensile::_bbb
protected

◆ _cap_rate

Real SolidMechanicsPlasticTensile::_cap_rate
protected

dictates how quickly the 'cap' degenerates to a hemisphere - see doco for _tip_scheme

Definition at line 68 of file SolidMechanicsPlasticTensile.h.

Referenced by d2smooth(), dsmooth(), and smooth().

◆ _cap_start

Real SolidMechanicsPlasticTensile::_cap_start
protected

smoothing parameter dictating when the 'cap' will start - see doco for _tip_scheme

Definition at line 65 of file SolidMechanicsPlasticTensile.h.

Referenced by d2smooth(), dsmooth(), and smooth().

◆ _ccc

Real SolidMechanicsPlasticTensile::_ccc
protected

◆ _f_tol

const Real SolidMechanicsPlasticModel::_f_tol
inherited

◆ _ic_tol

const Real SolidMechanicsPlasticModel::_ic_tol
inherited

Tolerance on internal constraint.

Definition at line 173 of file SolidMechanicsPlasticModel.h.

◆ _lode_cutoff

Real SolidMechanicsPlasticTensile::_lode_cutoff
protected

if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-loss

Definition at line 77 of file SolidMechanicsPlasticTensile.h.

Referenced by dflowPotential_dstress(), dyieldFunction_dstress(), SolidMechanicsPlasticTensile(), and yieldFunction().

◆ _sin3tt

Real SolidMechanicsPlasticTensile::_sin3tt
protected

sin(3*_tt) - useful for making comparisons with Lode angle

Definition at line 74 of file SolidMechanicsPlasticTensile.h.

Referenced by dflowPotential_dstress(), dyieldFunction_dstress(), SolidMechanicsPlasticTensile(), and yieldFunction().

◆ _small_smoother2

Real SolidMechanicsPlasticTensile::_small_smoother2
protected

Square of tip smoothing parameter to smooth the cone at mean_stress = T.

Definition at line 62 of file SolidMechanicsPlasticTensile.h.

Referenced by smooth().

◆ _strength

const SolidMechanicsHardeningModel& SolidMechanicsPlasticTensile::_strength
protected

Definition at line 49 of file SolidMechanicsPlasticTensile.h.

Referenced by dtensile_strength(), and tensile_strength().

◆ _tip_scheme

MooseEnum SolidMechanicsPlasticTensile::_tip_scheme
protected

The yield function is modified to f = s_m + sqrt(a + s_bar^2 K^2) - tensile_strength where "a" depends on the tip_scheme.

Currently _tip_scheme is 'hyperbolic', where a = _small_smoother2 'cap' where a = _small_smoother2 + (p(stress_mean - _cap_start))^2 with the function p(x)=x(1-exp(-_cap_rate*x)) for x>0, and p=0 otherwise

Definition at line 59 of file SolidMechanicsPlasticTensile.h.

Referenced by d2smooth(), dsmooth(), and smooth().

◆ _tt

Real SolidMechanicsPlasticTensile::_tt
protected

edge smoothing parameter, in radians

Definition at line 71 of file SolidMechanicsPlasticTensile.h.

Referenced by SolidMechanicsPlasticTensile().


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