Mohr-Coulomb plasticity, nonassociative with hardening/softening. More...

#include <SolidMechanicsPlasticMohrCoulomb.h>

Inheritance diagram for SolidMechanicsPlasticMohrCoulomb:

Public Types
typedef DataFileName	DataFileParameterType

Public Member Functions
	SolidMechanicsPlasticMohrCoulomb (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...

SubProblem &	getSubProblem () 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)

UserObject *	primaryThreadCopy ()

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< MooseObject >	getSharedPtr ()

std::shared_ptr< const MooseObject >	getSharedPtr () const

MooseApp &	getMooseApp () 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 InputParameters &	parameters () 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

T	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 ExecFlagEnum &	getExecuteOnEnum () 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 UserObject &	getUserObjectBase (const std::string &param_name, bool is_dependency=true) const

const UserObject &	getUserObjectBaseByName (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< SubdomainID >	getMaterialPropertyBlocks (const std::string &name)

std::vector< SubdomainName >	getMaterialPropertyBlockNames (const std::string &name)

std::set< BoundaryID >	getMaterialPropertyBoundaryIDs (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)

MaterialBase &	getMaterial (const std::string &name)

MaterialBase &	getMaterial (const std::string &name)

MaterialBase &	getMaterialByName (const std::string &name, bool no_warn=false)

MaterialBase &	getMaterialByName (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 Function &	getFunction (const std::string &name) const

const Function &	getFunctionByName (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 VectorPostprocessorValue &	getVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name) const

const VectorPostprocessorValue &	getVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name, bool needs_broadcast) const

const VectorPostprocessorValue &	getVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name) const

const VectorPostprocessorValue &	getVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name, bool needs_broadcast) const

const VectorPostprocessorValue &	getVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name) const

const VectorPostprocessorValue &	getVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name, bool needs_broadcast) const

const VectorPostprocessorValue &	getVectorPostprocessorValueOldByName (const VectorPostprocessorName &name, const std::string &vector_name) const

const VectorPostprocessorValue &	getVectorPostprocessorValueOldByName (const VectorPostprocessorName &name, const std::string &vector_name, bool needs_broadcast) const

const ScatterVectorPostprocessorValue &	getScatterVectorPostprocessorValue (const std::string &param_name, const std::string &vector_name) const

const ScatterVectorPostprocessorValue &	getScatterVectorPostprocessorValueByName (const VectorPostprocessorName &name, const std::string &vector_name) const

const ScatterVectorPostprocessorValue &	getScatterVectorPostprocessorValueOld (const std::string &param_name, const std::string &vector_name) const

const ScatterVectorPostprocessorValue &	getScatterVectorPostprocessorValueOldByName (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)

Sampler &	getSampler (const std::string &name)

T &	getSamplerByName (const SamplerName &name)

Sampler &	getSamplerByName (const SamplerName &name)

virtual void	meshChanged ()

virtual void	meshDisplaced ()

PerfGraph &	perfGraph ()

const PostprocessorValue &	getPostprocessorValue (const std::string &param_name, const unsigned int index=0) const

const PostprocessorValue &	getPostprocessorValue (const std::string &param_name, const unsigned int index=0) const

const PostprocessorValue &	getPostprocessorValueOld (const std::string &param_name, const unsigned int index=0) const

const PostprocessorValue &	getPostprocessorValueOld (const std::string &param_name, const unsigned int index=0) const

const PostprocessorValue &	getPostprocessorValueOlder (const std::string &param_name, const unsigned int index=0) const

const PostprocessorValue &	getPostprocessorValueOlder (const std::string &param_name, const unsigned int index=0) const

virtual const PostprocessorValue &	getPostprocessorValueByName (const PostprocessorName &name) const

virtual const PostprocessorValue &	getPostprocessorValueByName (const PostprocessorName &name) const

const PostprocessorValue &	getPostprocessorValueOldByName (const PostprocessorName &name) const

const PostprocessorValue &	getPostprocessorValueOldByName (const PostprocessorName &name) const

const PostprocessorValue &	getPostprocessorValueOlderByName (const PostprocessorName &name) const

const PostprocessorValue &	getPostprocessorValueOlderByName (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 Distribution &	getDistribution (const std::string &name) const

const T &	getDistribution (const std::string &name) const

const Distribution &	getDistribution (const std::string &name) const

const T &	getDistribution (const std::string &name) const

const Distribution &	getDistributionByName (const DistributionName &name) const

const T &	getDistributionByName (const std::string &name) const

const Distribution &	getDistributionByName (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	cohesion (const Real internal_param) const
	cohesion as a function of internal parameter More...

virtual Real	dcohesion (const Real internal_param) const
	d(cohesion)/d(internal_param); More...

virtual Real	phi (const Real internal_param) const
	friction angle as a function of internal parameter More...

virtual Real	dphi (const Real internal_param) const
	d(phi)/d(internal_param); More...

virtual Real	psi (const Real internal_param) const
	dilation angle as a function of internal parameter More...

virtual Real	dpsi (const Real internal_param) const
	d(psi)/d(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 ReporterName &	getReporterName (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 VariableValue &	coupledScalarValue (const std::string &var_name, unsigned int comp=0) const

const ADVariableValue &	adCoupledScalarValue (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 VariableValue &	coupledVectorTagScalarValue (const std::string &var_name, TagID tag, unsigned int comp=0) const

const VariableValue &	coupledMatrixTagScalarValue (const std::string &var_name, TagID tag, unsigned int comp=0) const

const VariableValue &	coupledScalarValueOld (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarValueOlder (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDot (const std::string &var_name, unsigned int comp=0) const

const ADVariableValue &	adCoupledScalarDot (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDotDot (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDotOld (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDotDotOld (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDotDu (const std::string &var_name, unsigned int comp=0) const

const VariableValue &	coupledScalarDotDotDu (const std::string &var_name, unsigned int comp=0) const

const MooseVariableScalar *	getScalarVar (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 &	_cohesion
	Hardening model for cohesion. More...

const SolidMechanicsHardeningModel &	_phi
	Hardening model for phi. More...

const SolidMechanicsHardeningModel &	_psi
	Hardening model for psi. More...

MooseEnum	_tip_scheme
	The yield function is modified to f = s_msinphi + sqrt(a + s_bar^2 K^2) - Ccosphi 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	_costt
	cos(_tt) More...

Real	_sintt
	sin(_tt) More...

Real	_cos3tt
	cos(3*_tt) More...

Real	_sin3tt
	sin(3*_tt) - useful for making comparisons with Lode angle More...

Real	_cos6tt
	cos(6*_tt) More...

Real	_sin6tt
	sin(6*_tt) More...

Real	_lode_cutoff
	if secondInvariant < _lode_cutoff then set Lode angle to zero. This is to guard against precision-loss 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

Private Member Functions
void	abbo (const Real sin3lode, const Real sin_angle, Real &aaa, Real &bbb, Real &ccc) const
	Computes Abbo et al's A, B and C parameters. More...

void	dabbo (const Real sin3lode, const Real sin_angle, Real &daaa, Real &dbbb, Real &dccc) const
	Computes derivatives of Abbo et al's A, B and C parameters wrt sin_angle. More...

RankTwoTensor	df_dsig (const RankTwoTensor &stress, const Real sin_angle) const
	d(yieldFunction)/d(stress), but with the ability to put friction or dilation angle into the result More...

Detailed Description

Mohr-Coulomb plasticity, nonassociative with hardening/softening.

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 28 of file SolidMechanicsPlasticMohrCoulomb.h.

Constructor & Destructor Documentation

◆ SolidMechanicsPlasticMohrCoulomb()

SolidMechanicsPlasticMohrCoulomb::SolidMechanicsPlasticMohrCoulomb ( const InputParameters & parameters )

Definition at line 73 of file SolidMechanicsPlasticMohrCoulomb.C.

   : SolidMechanicsPlasticModel(parameters),
     _cohesion(getUserObject<SolidMechanicsHardeningModel>("cohesion")),
     _phi(getUserObject<SolidMechanicsHardeningModel>("friction_angle")),
     _psi(getUserObject<SolidMechanicsHardeningModel>("dilation_angle")),
     _tip_scheme(getParam<MooseEnum>("tip_scheme")),
     _small_smoother2(Utility::pow<2>(getParam<Real>("mc_tip_smoother"))),
     _cap_start(getParam<Real>("cap_start")),
     _cap_rate(getParam<Real>("cap_rate")),
     _tt(getParam<Real>("mc_edge_smoother") * libMesh::pi / 180.0),
     _costt(std::cos(_tt)),
     _sintt(std::sin(_tt)),
     _cos3tt(std::cos(3 * _tt)),
     _sin3tt(std::sin(3 * _tt)),
     _cos6tt(std::cos(6 * _tt)),
     _sin6tt(std::sin(6 * _tt)),
     _lode_cutoff(parameters.isParamValid("mc_lode_cutoff") ? getParam<Real>("mc_lode_cutoff")
                                                            : 1.0E-5 * Utility::pow<2>(_f_tol))
 
 {
   if (_lode_cutoff < 0)
     mooseError("mc_lode_cutoff must not be negative");
 
   // With arbitary UserObjects, it is impossible to check everything, and
   // I think this is the best I can do
   if (phi(0) < 0 || psi(0) < 0 || phi(0) > libMesh::pi / 2.0 || psi(0) > libMesh::pi / 2.0)
     mooseError("Mohr-Coulomb friction and dilation angles must lie in [0, Pi/2]");
   if (phi(0) < psi(0))
     mooseError("Mohr-Coulomb friction angle must not be less than Mohr-Coulomb dilation angle");
   if (cohesion(0) < 0)
     mooseError("Mohr-Coulomb cohesion must not be negative");
 
   // check Abbo et al's convexity constraint (Eqn c.18 in their paper)
   // With an arbitrary UserObject, it is impossible to check for all angles
   // I think the following is the best we can do
   Real sin_angle = std::sin(std::max(phi(0), psi(0)));
   sin_angle = std::max(sin_angle, std::sin(std::max(phi(1E6), psi(1E6))));
   Real rhs = std::sqrt(3) * (35 * std::sin(_tt) + 14 * std::sin(5 * _tt) - 5 * std::sin(7 * _tt)) /
              16 / Utility::pow<5>(std::cos(_tt)) / (11 - 10 * std::cos(2 * _tt));
   if (rhs <= sin_angle)
     mooseError("Mohr-Coulomb edge smoothing angle is too small and a non-convex yield surface will "
                "result.  Please choose a larger value");
 }

Member Function Documentation

◆ abbo()

void SolidMechanicsPlasticMohrCoulomb::abbo	(	const Real	sin3lode,
		const Real	sin_angle,
		Real &	aaa,
		Real &	bbb,
		Real &	ccc
	)		const

private

Computes Abbo et al's A, B and C parameters.

Parameters

	sin3lode	sin(3*(lode angle))
	sin_angle	sin(friction_angle) (for yield function), or sin(dilation_angle) (for potential function)
[out]	aaa	Abbo's A
[out]	bbb	Abbo's B
[out]	ccc	Abbo's C

Definition at line 413 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by df_dsig(), dflowPotential_dintnl(), dflowPotential_dstress(), dyieldFunction_dintnl(), and yieldFunction().

 {
   Real tmp1 = (sin3lode >= 0 ? _costt - sin_angle * _sintt / std::sqrt(3.0)
                              : _costt + sin_angle * _sintt / std::sqrt(3.0));
   Real tmp2 = (sin3lode >= 0 ? _sintt + sin_angle * _costt / std::sqrt(3.0)
                              : -_sintt + sin_angle * _costt / std::sqrt(3.0));
 
   ccc = -_cos3tt * tmp1;
   ccc += (sin3lode >= 0 ? -3 * _sin3tt * tmp2 : 3 * _sin3tt * tmp2);
   ccc /= 18 * Utility::pow<3>(_cos3tt);
 
   bbb = (sin3lode >= 0 ? _sin6tt * tmp1 : -_sin6tt * tmp1);
   bbb -= 6 * _cos6tt * tmp2;
   bbb /= 18 * Utility::pow<3>(_cos3tt);
 
   aaa = (sin3lode >= 0 ? -sin_angle * _sintt / std::sqrt(3.0) - bbb * _sin3tt
                        : sin_angle * _sintt / std::sqrt(3.0) + bbb * _sin3tt);
   aaa += -ccc * Utility::pow<2>(_sin3tt) + _costt;
 }

◆ 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

	f	values of the yield functions
	stress	stress tensor
	intnl	internal parameter
	Eijkl	elasticity tensor (stress = Eijkl*strain)
[out]	act	act[i] = true if the i_th yield function is active
[out]	returned_stress	Approximate value of the returned stress

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, SolidMechanicsPlasticTensileMulti, SolidMechanicsPlasticMeanCapTC, SolidMechanicsPlasticWeakPlaneShear, and SolidMechanicsPlasticWeakPlaneTensile.

Definition at line 186 of file SolidMechanicsPlasticModel.C.

 {
   mooseAssert(f.size() == numberSurfaces(),
               "f incorrectly sized at " << f.size() << " in activeConstraints");
   act.resize(numberSurfaces());
   for (unsigned surface = 0; surface < numberSurfaces(); ++surface)
     act[surface] = (f[surface] > _f_tol);
 }

◆ cohesion()

Real SolidMechanicsPlasticMohrCoulomb::cohesion ( const Real internal_param ) const

protectedvirtual

cohesion as a function of internal parameter

Definition at line 377 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dyieldFunction_dintnl(), SolidMechanicsPlasticMohrCoulomb(), and yieldFunction().

 {
   return _cohesion.value(internal_param);
 }

◆ 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_old	trial stress before returning
intnl_old	internal parameter before returning
stress	current returned stress state
intnl	internal parameter
E_ijkl	elasticity tensor
cumulative_pm	the 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().

 {
   return E_ijkl;
 }

◆ d2smooth()

Real SolidMechanicsPlasticMohrCoulomb::d2smooth ( const RankTwoTensor & stress ) const

protectedvirtual

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

Definition at line 489 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dflowPotential_dstress().

 {
   Real d2smoother2 = 0;
   if (_tip_scheme == "cap")
   {
     Real x = stress.trace() / 3.0 - _cap_start;
     Real p = 0;
     Real dp_dx = 0;
     Real d2p_dx2 = 0;
     if (x > 0)
     {
       p = x * (1 - std::exp(-_cap_rate * x));
       dp_dx = (1 - std::exp(-_cap_rate * x)) + x * _cap_rate * std::exp(-_cap_rate * x);
       d2p_dx2 = 2 * _cap_rate * std::exp(-_cap_rate * x) -
                 x * Utility::pow<2>(_cap_rate) * std::exp(-_cap_rate * x);
     }
     d2smoother2 += 2 * Utility::pow<2>(dp_dx) + 2 * p * d2p_dx2;
   }
   return d2smoother2;
 }

◆ dabbo()

void SolidMechanicsPlasticMohrCoulomb::dabbo	(	const Real	sin3lode,
		const Real	sin_angle,
		Real &	daaa,
		Real &	dbbb,
		Real &	dccc
	)		const

private

Computes derivatives of Abbo et al's A, B and C parameters wrt sin_angle.

Parameters

	sin3lode	sin(3*(lode angle))
	sin_angle	sin(friction_angle) (for yield function), or sin(dilation_angle) (for potential function)
[out]	daaa	d(Abbo's A)/d(sin_angle)
[out]	dbbb	d(Abbo's B)/d(sin_angle)
[out]	dccc	d(Abbo's C)/d(sin_angle)

Definition at line 435 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dflowPotential_dintnl(), and dyieldFunction_dintnl().

 {
   Real dtmp1 = (sin3lode >= 0 ? -_sintt / std::sqrt(3.0) : _sintt / std::sqrt(3.0));
   Real dtmp2 = _costt / std::sqrt(3.0);
 
   dccc = -_cos3tt * dtmp1;
   dccc += (sin3lode >= 0 ? -3 * _sin3tt * dtmp2 : 3 * _sin3tt * dtmp2);
   dccc /= 18 * Utility::pow<3>(_cos3tt);
 
   dbbb = (sin3lode >= 0 ? _sin6tt * dtmp1 : -_sin6tt * dtmp1);
   dbbb -= 6 * _cos6tt * dtmp2;
   dbbb /= 18 * Utility::pow<3>(_cos3tt);
 
   daaa = (sin3lode >= 0 ? -_sintt / std::sqrt(3.0) - dbbb * _sin3tt
                         : _sintt / std::sqrt(3.0) + dbbb * _sin3tt);
   daaa += -dccc * Utility::pow<2>(_sin3tt);
 }

◆ dcohesion()

Real SolidMechanicsPlasticMohrCoulomb::dcohesion ( const Real internal_param ) const

protectedvirtual

d(cohesion)/d(internal_param);

Definition at line 383 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dyieldFunction_dintnl().

 {
   return _cohesion.derivative(internal_param);
 }

◆ df_dsig()

RankTwoTensor SolidMechanicsPlasticMohrCoulomb::df_dsig	(	const RankTwoTensor &	stress,
		const Real	sin_angle
	)		const

private

d(yieldFunction)/d(stress), but with the ability to put friction or dilation angle into the result

Parameters

stress	the stress at which to calculate
sin_angle	either sin(friction angle) or sin(dilation angle)

Definition at line 149 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dyieldFunction_dstress(), and flowPotential().

 {
   Real mean_stress = stress.trace() / 3.0;
   RankTwoTensor dmean_stress = stress.dtrace() / 3.0;
   Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
   if (std::abs(sin3Lode) <= _sin3tt)
   {
     // the non-edge-smoothed version
     std::vector<Real> eigvals;
     std::vector<RankTwoTensor> deigvals;
     stress.dsymmetricEigenvalues(eigvals, deigvals);
     Real tmp = eigvals[2] - eigvals[0] + (eigvals[2] + eigvals[0] - 2.0 * mean_stress) * sin_angle;
     RankTwoTensor dtmp =
         deigvals[2] - deigvals[0] + (deigvals[2] + deigvals[0] - 2.0 * dmean_stress) * sin_angle;
     Real denom = std::sqrt(smooth(stress) + 0.25 * Utility::pow<2>(tmp));
     return dmean_stress * sin_angle +
            (0.5 * dsmooth(stress) * dmean_stress + 0.25 * tmp * dtmp) / denom;
   }
   else
   {
     // the edge-smoothed version
     Real aaa, bbb, ccc;
     abbo(sin3Lode, sin_angle, aaa, bbb, ccc);
     Real kk = aaa + bbb * sin3Lode + ccc * Utility::pow<2>(sin3Lode);
     RankTwoTensor dkk = (bbb + 2 * ccc * sin3Lode) * stress.dsin3Lode(_lode_cutoff);
     Real sibar2 = stress.secondInvariant();
     RankTwoTensor dsibar2 = stress.dsecondInvariant();
     Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
     return dmean_stress * sin_angle + (0.5 * dsmooth(stress) * dmean_stress +
                                        0.5 * dsibar2 * Utility::pow<2>(kk) + sibar2 * kk * dkk) /
                                           denom;
   }
 }

◆ dflowPotential_dintnl()

RankTwoTensor SolidMechanicsPlasticMohrCoulomb::dflowPotential_dintnl	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

overrideprotectedvirtual

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

Parameters

stress	the stress at which to calculate the flow potential
intnl	internal parameter

Returns: dr_dintnl(i, j) = dr(i, j)/dintnl

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 320 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   Real sin_angle = std::sin(psi(intnl));
   Real dsin_angle = std::cos(psi(intnl)) * dpsi(intnl);
 
   Real mean_stress = stress.trace() / 3.0;
   RankTwoTensor dmean_stress = stress.dtrace() / 3.0;
   Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
 
   if (std::abs(sin3Lode) <= _sin3tt)
   {
     // the non-edge-smoothed version
     std::vector<Real> eigvals;
     std::vector<RankTwoTensor> deigvals;
     stress.dsymmetricEigenvalues(eigvals, deigvals);
     Real tmp = eigvals[2] - eigvals[0] + (eigvals[2] + eigvals[0] - 2.0 * mean_stress) * sin_angle;
     Real dtmp_dintnl = (eigvals[2] + eigvals[0] - 2 * mean_stress) * dsin_angle;
     RankTwoTensor dtmp_dstress =
         deigvals[2] - deigvals[0] + (deigvals[2] + deigvals[0] - 2.0 * dmean_stress) * sin_angle;
     RankTwoTensor d2tmp_dstress_dintnl =
         (deigvals[2] + deigvals[0] - 2.0 * dmean_stress) * dsin_angle;
     Real denom = std::sqrt(smooth(stress) + 0.25 * Utility::pow<2>(tmp));
     return dmean_stress * dsin_angle + 0.25 * dtmp_dintnl * dtmp_dstress / denom +
            0.25 * tmp * d2tmp_dstress_dintnl / denom -
            0.5 * (dsmooth(stress) * dmean_stress + 0.5 * tmp * dtmp_dstress) * 0.25 * tmp *
                dtmp_dintnl / Utility::pow<3>(denom);
   }
   else
   {
     // the edge-smoothed version
     Real aaa, bbb, ccc;
     abbo(sin3Lode, sin_angle, aaa, bbb, ccc);
     Real kk = aaa + bbb * sin3Lode + ccc * Utility::pow<2>(sin3Lode);
 
     Real daaa, dbbb, dccc;
     dabbo(sin3Lode, sin_angle, daaa, dbbb, dccc);
     Real dkk_dintnl = (daaa + dbbb * sin3Lode + dccc * Utility::pow<2>(sin3Lode)) * dsin_angle;
     RankTwoTensor dkk_dstress = (bbb + 2 * ccc * sin3Lode) * stress.dsin3Lode(_lode_cutoff);
     RankTwoTensor d2kk_dstress_dintnl =
         (dbbb + 2 * dccc * sin3Lode) * stress.dsin3Lode(_lode_cutoff) * dsin_angle;
 
     Real sibar2 = stress.secondInvariant();
     RankTwoTensor dsibar2 = stress.dsecondInvariant();
     Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
 
     return dmean_stress * dsin_angle +
            (dsibar2 * kk * dkk_dintnl + sibar2 * dkk_dintnl * dkk_dstress +
             sibar2 * kk * d2kk_dstress_dintnl) /
                denom -
            (0.5 * dsmooth(stress) * dmean_stress + 0.5 * dsibar2 * Utility::pow<2>(kk) +
             sibar2 * kk * dkk_dstress) *
                sibar2 * kk * dkk_dintnl / Utility::pow<3>(denom);
   }
 }

◆ 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

	stress	the stress at which to calculate the flow potential
	intnl	internal parameter
[out]	dr_dintnl	dr_dintnl[alpha](i, j) = dr[alpha](i, j)/dintnl

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 137 of file SolidMechanicsPlasticModel.C.

 {
   return dr_dintnl.assign(1, dflowPotential_dintnl(stress, intnl));
 }

◆ dflowPotential_dstress()

RankFourTensor SolidMechanicsPlasticMohrCoulomb::dflowPotential_dstress	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

overrideprotectedvirtual

The derivative of the flow potential with respect to stress.

Parameters

stress	the stress at which to calculate the flow potential
intnl	internal parameter

Returns: dr_dstress(i, j, k, l) = dr(i, j)/dstress(k, l)

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 237 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   RankFourTensor dr_dstress;
   Real sin_angle = std::sin(psi(intnl));
   Real mean_stress = stress.trace() / 3.0;
   RankTwoTensor dmean_stress = stress.dtrace() / 3.0;
   Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
   if (std::abs(sin3Lode) <= _sin3tt)
   {
     // the non-edge-smoothed version
     std::vector<Real> eigvals;
     std::vector<RankTwoTensor> deigvals;
     std::vector<RankFourTensor> d2eigvals;
     stress.dsymmetricEigenvalues(eigvals, deigvals);
     stress.d2symmetricEigenvalues(d2eigvals);
 
     Real tmp = eigvals[2] - eigvals[0] + (eigvals[2] + eigvals[0] - 2.0 * mean_stress) * sin_angle;
     RankTwoTensor dtmp =
         deigvals[2] - deigvals[0] + (deigvals[2] + deigvals[0] - 2.0 * dmean_stress) * sin_angle;
     Real denom = std::sqrt(smooth(stress) + 0.25 * Utility::pow<2>(tmp));
     Real denom3 = Utility::pow<3>(denom);
     Real d2smooth_over_denom = d2smooth(stress) / denom;
     RankTwoTensor numer = dsmooth(stress) * dmean_stress + 0.5 * tmp * dtmp;
 
     dr_dstress = 0.25 * tmp *
                  (d2eigvals[2] - d2eigvals[0] + (d2eigvals[2] + d2eigvals[0]) * sin_angle) / denom;
 
     for (unsigned i = 0; i < 3; ++i)
       for (unsigned j = 0; j < 3; ++j)
         for (unsigned k = 0; k < 3; ++k)
           for (unsigned l = 0; l < 3; ++l)
           {
             dr_dstress(i, j, k, l) +=
                 0.5 * d2smooth_over_denom * dmean_stress(i, j) * dmean_stress(k, l);
             dr_dstress(i, j, k, l) += 0.25 * dtmp(i, j) * dtmp(k, l) / denom;
             dr_dstress(i, j, k, l) -= 0.25 * numer(i, j) * numer(k, l) / denom3;
           }
   }
   else
   {
     // the edge-smoothed version
     Real aaa, bbb, ccc;
     abbo(sin3Lode, sin_angle, aaa, bbb, ccc);
     RankTwoTensor dsin3Lode = stress.dsin3Lode(_lode_cutoff);
     Real kk = aaa + bbb * sin3Lode + ccc * Utility::pow<2>(sin3Lode);
     RankTwoTensor dkk = (bbb + 2 * ccc * sin3Lode) * dsin3Lode;
     RankFourTensor d2kk = (bbb + 2 * ccc * sin3Lode) * stress.d2sin3Lode(_lode_cutoff);
     for (unsigned i = 0; i < 3; ++i)
       for (unsigned j = 0; j < 3; ++j)
         for (unsigned k = 0; k < 3; ++k)
           for (unsigned l = 0; l < 3; ++l)
             d2kk(i, j, k, l) += 2 * ccc * dsin3Lode(i, j) * dsin3Lode(k, l);
 
     Real sibar2 = stress.secondInvariant();
     RankTwoTensor dsibar2 = stress.dsecondInvariant();
     RankFourTensor d2sibar2 = stress.d2secondInvariant();
 
     Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
     Real denom3 = Utility::pow<3>(denom);
     Real d2smooth_over_denom = d2smooth(stress) / denom;
     RankTwoTensor numer_full =
         0.5 * dsmooth(stress) * dmean_stress + 0.5 * dsibar2 * kk * kk + sibar2 * kk * dkk;
 
     dr_dstress = (0.5 * d2sibar2 * Utility::pow<2>(kk) + sibar2 * kk * d2kk) / denom;
     for (unsigned i = 0; i < 3; ++i)
       for (unsigned j = 0; j < 3; ++j)
         for (unsigned k = 0; k < 3; ++k)
           for (unsigned l = 0; l < 3; ++l)
           {
             dr_dstress(i, j, k, l) +=
                 0.5 * d2smooth_over_denom * dmean_stress(i, j) * dmean_stress(k, l);
             dr_dstress(i, j, k, l) +=
                 (dsibar2(i, j) * dkk(k, l) * kk + dkk(i, j) * dsibar2(k, l) * kk +
                  sibar2 * dkk(i, j) * dkk(k, l)) /
                 denom;
             dr_dstress(i, j, k, l) -= numer_full(i, j) * numer_full(k, l) / denom3;
           }
   }
   return dr_dstress;
 }

◆ 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

	stress	the stress at which to calculate the flow potential
	intnl	internal parameter
[out]	dr_dstress	dr_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.

 {
   return dr_dstress.assign(1, dflowPotential_dstress(stress, intnl));
 }

◆ 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

stress	the stress at which to calculate the hardening potentials
intnl	internal parameter

Returns: the derivative

Reimplemented in SolidMechanicsPlasticMeanCapTC.

Definition at line 172 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::dhardPotential_dintnlV().

 {
   return 0.0;
 }

◆ 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

	stress	the stress at which to calculate the hardening potentials
	intnl	internal parameter
[out]	dh_dintnl	dh_dintnl[alpha] = dh[alpha]/dintnl

Definition at line 178 of file SolidMechanicsPlasticModel.C.

 {
   dh_dintnl.resize(numberSurfaces(), dhardPotential_dintnl(stress, intnl));
 }

◆ dhardPotential_dstress()

RankTwoTensor SolidMechanicsPlasticModel::dhardPotential_dstress	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

protectedvirtualinherited

The derivative of the hardening potential with respect to stress.

Parameters

stress	the stress at which to calculate the hardening potentials
intnl	internal 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().

 {
   return RankTwoTensor();
 }

◆ 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

	stress	the stress at which to calculate the hardening potentials
	intnl	internal parameter
[out]	dh_dstress	dh_dstress[alpha](i, j) = dh[alpha]/dstress(i, j)

Definition at line 164 of file SolidMechanicsPlasticModel.C.

 {
   dh_dstress.assign(numberSurfaces(), dhardPotential_dstress(stress, intnl));
 }

◆ dphi()

Real SolidMechanicsPlasticMohrCoulomb::dphi ( const Real internal_param ) const

protectedvirtual

d(phi)/d(internal_param);

Definition at line 395 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dyieldFunction_dintnl().

 {
   return _phi.derivative(internal_param);
 }

◆ dpsi()

Real SolidMechanicsPlasticMohrCoulomb::dpsi ( const Real internal_param ) const

protectedvirtual

d(psi)/d(internal_param);

Definition at line 407 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dflowPotential_dintnl().

 {
   return _psi.derivative(internal_param);
 }

◆ dsmooth()

Real SolidMechanicsPlasticMohrCoulomb::dsmooth ( const RankTwoTensor & stress ) const

protectedvirtual

returns the da/dstress_mean - see doco for _tip_scheme

Definition at line 470 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by df_dsig(), dflowPotential_dintnl(), and dflowPotential_dstress().

 {
   Real dsmoother2 = 0;
   if (_tip_scheme == "cap")
   {
     Real x = stress.trace() / 3.0 - _cap_start;
     Real p = 0;
     Real dp_dx = 0;
     if (x > 0)
     {
       p = x * (1 - std::exp(-_cap_rate * x));
       dp_dx = (1 - std::exp(-_cap_rate * x)) + x * _cap_rate * std::exp(-_cap_rate * x);
     }
     dsmoother2 += 2 * p * dp_dx;
   }
   return dsmoother2;
 }

◆ dyieldFunction_dintnl()

Real SolidMechanicsPlasticMohrCoulomb::dyieldFunction_dintnl	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

overrideprotectedvirtual

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

Parameters

stress	the stress at which to calculate the yield function
intnl	internal parameter

Returns: the derivative

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 192 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   Real sin_angle = std::sin(phi(intnl));
   Real cos_angle = std::cos(phi(intnl));
   Real dsin_angle = cos_angle * dphi(intnl);
   Real dcos_angle = -sin_angle * dphi(intnl);
 
   Real mean_stress = stress.trace() / 3.0;
   Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
   if (std::abs(sin3Lode) <= _sin3tt)
   {
     // the non-edge-smoothed version
     std::vector<Real> eigvals;
     stress.symmetricEigenvalues(eigvals);
     Real tmp = eigvals[2] - eigvals[0] + (eigvals[2] + eigvals[0] - 2 * mean_stress) * sin_angle;
     Real dtmp = (eigvals[2] + eigvals[0] - 2 * mean_stress) * dsin_angle;
     Real denom = std::sqrt(smooth(stress) + 0.25 * Utility::pow<2>(tmp));
     return mean_stress * dsin_angle + 0.25 * tmp * dtmp / denom - dcohesion(intnl) * cos_angle -
            cohesion(intnl) * dcos_angle;
   }
   else
   {
     // the edge-smoothed version
     Real aaa, bbb, ccc;
     abbo(sin3Lode, sin_angle, aaa, bbb, ccc);
     Real daaa, dbbb, dccc;
     dabbo(sin3Lode, sin_angle, daaa, dbbb, dccc);
     Real kk = aaa + bbb * sin3Lode + ccc * Utility::pow<2>(sin3Lode);
     Real dkk = (daaa + dbbb * sin3Lode + dccc * Utility::pow<2>(sin3Lode)) * dsin_angle;
     Real sibar2 = stress.secondInvariant();
     Real denom = std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk));
     return mean_stress * dsin_angle + sibar2 * kk * dkk / denom - dcohesion(intnl) * cos_angle -
            cohesion(intnl) * dcos_angle;
   }
 }

◆ 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

	stress	the stress at which to calculate the yield function
	intnl	internal parameter
[out]	df_dintnl	df_dintnl[alpha] = df[alpha]/dintnl

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 96 of file SolidMechanicsPlasticModel.C.

 {
   return df_dintnl.assign(1, dyieldFunction_dintnl(stress, intnl));
 }

◆ dyieldFunction_dstress()

RankTwoTensor SolidMechanicsPlasticMohrCoulomb::dyieldFunction_dstress	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

overrideprotectedvirtual

The derivative of yield function with respect to stress.

Parameters

stress	the stress at which to calculate the yield function
intnl	internal parameter

Returns: df_dstress(i, j) = dyieldFunction/dstress(i, j)

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 184 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   Real sinphi = std::sin(phi(intnl));
   return df_dsig(stress, sinphi);
 }

◆ 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

	stress	the stress at which to calculate the yield function
	intnl	internal parameter
[out]	df_dstress	df_dstress[alpha](i, j) = dyieldFunction[alpha]/dstress(i, j)

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 82 of file SolidMechanicsPlasticModel.C.

 {
   df_dstress.assign(1, dyieldFunction_dstress(stress, intnl));
 }

◆ 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 SolidMechanicsPlasticMohrCoulomb::flowPotential	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

overrideprotectedvirtual

The flow potential.

Parameters

stress	the stress at which to calculate the flow potential
intnl	internal parameter

Returns: the flow potential

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 230 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   Real sinpsi = std::sin(psi(intnl));
   return df_dsig(stress, sinpsi);
 }

◆ flowPotentialV()

void SolidMechanicsPlasticModel::flowPotentialV	(	const RankTwoTensor &	stress,
		Real	intnl,
		std::vector< RankTwoTensor > &	r
	)		const

virtualinherited

The flow potentials.

Parameters

	stress	the stress at which to calculate the flow potential
	intnl	internal parameter
[out]	r	r[alpha] is the flow potential for the "alpha" yield function

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 109 of file SolidMechanicsPlasticModel.C.

 {
   return r.assign(1, flowPotential(stress, intnl));
 }

◆ hardPotential()

Real SolidMechanicsPlasticModel::hardPotential	(	const RankTwoTensor &	stress,
		Real	intnl
	)		const

protectedvirtualinherited

The hardening potential.

Parameters

stress	the stress at which to calculate the hardening potential
intnl	internal parameter

Returns: the hardening potential

Reimplemented in SolidMechanicsPlasticMeanCapTC.

Definition at line 145 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::hardPotentialV().

 {
   return -1.0;
 }

◆ hardPotentialV()

void SolidMechanicsPlasticModel::hardPotentialV	(	const RankTwoTensor &	stress,
		Real	intnl,
		std::vector< Real > &	h
	)		const

virtualinherited

The hardening potential.

Parameters

	stress	the stress at which to calculate the hardening potential
	intnl	internal parameter
[out]	h	h[alpha] is the hardening potential for the "alpha" yield function

Definition at line 150 of file SolidMechanicsPlasticModel.C.

 {
   h.assign(numberSurfaces(), hardPotential(stress, intnl));
 }

◆ 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

yf	Yield function value
dpm	plastic multiplier
dpm_tol	tolerance 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().

 {
   return (dpm == 0 && yf <= _f_tol) || (dpm > -dpm_tol && yf <= _f_tol && yf >= -_f_tol);
 }

◆ modelName()

std::string SolidMechanicsPlasticMohrCoulomb::modelName ( ) const

overridevirtual

Implements SolidMechanicsPlasticModel.

Definition at line 511 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   return "MohrCoulomb";
 }

◆ numberSurfaces()

unsigned SolidMechanicsPlasticModel::numberSurfaces ( ) const

virtualinherited

The number of yield surfaces for this plasticity model.

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 55 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::activeConstraints(), SolidMechanicsPlasticModel::dhardPotential_dintnlV(), SolidMechanicsPlasticModel::dhardPotential_dstressV(), SolidMechanicsPlasticModel::hardPotentialV(), and SolidMechanicsPlasticModel::returnMap().

 {
   return 1;
 }

◆ phi()

Real SolidMechanicsPlasticMohrCoulomb::phi ( const Real internal_param ) const

protectedvirtual

friction angle as a function of internal parameter

Definition at line 389 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dyieldFunction_dintnl(), dyieldFunction_dstress(), SolidMechanicsPlasticMohrCoulomb(), and yieldFunction().

 {
   return _phi.value(internal_param);
 }

◆ psi()

Real SolidMechanicsPlasticMohrCoulomb::psi ( const Real internal_param ) const

protectedvirtual

dilation angle as a function of internal parameter

Definition at line 401 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by dflowPotential_dintnl(), dflowPotential_dstress(), flowPotential(), and SolidMechanicsPlasticMohrCoulomb().

 {
   return _psi.value(internal_param);
 }

◆ 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_stress	The trial stress
	intnl_old	Value of the internal parameter
	E_ijkl	Elasticity tensor
	ep_plastic_tolerance	Tolerance defined by the user for the plastic strain
[out]	returned_stress	In case (C): lies on the yield surface after returning and produces the correct plastic strain (normality condition). Otherwise: not defined
[out]	returned_intnl	In case (C): the value of the internal parameter after returning. Otherwise: not defined
[out]	dpm	In case (C): the plastic multipliers needed to bring about the return. Otherwise: not defined
[out]	delta_dp	In case (C): The change in plastic strain induced by the return process. Otherwise: not defined
[out]	yf	In case (C): the yield function at (returned_stress, returned_intnl). Otherwise: the yield function at (trial_stress, intnl_old)
[out]	trial_stress_inadmissible	Should 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().

 {
   trial_stress_inadmissible = false;
   yieldFunctionV(trial_stress, intnl_old, yf);
 
   for (unsigned sf = 0; sf < numberSurfaces(); ++sf)
     if (yf[sf] > _f_tol)
       trial_stress_inadmissible = true;
 
   // example of checking Kuhn-Tucker
   std::vector<Real> dpm(numberSurfaces(), 0);
   for (unsigned sf = 0; sf < numberSurfaces(); ++sf)
     if (!KuhnTuckerSingleSurface(yf[sf], dpm[sf], 0))
       return false;
   return true;
 }

◆ smooth()

Real SolidMechanicsPlasticMohrCoulomb::smooth ( const RankTwoTensor & stress ) const

protectedvirtual

returns the 'a' parameter - see doco for _tip_scheme

Definition at line 455 of file SolidMechanicsPlasticMohrCoulomb.C.

Referenced by df_dsig(), dflowPotential_dintnl(), dflowPotential_dstress(), dyieldFunction_dintnl(), and yieldFunction().

 {
   Real smoother2 = _small_smoother2;
   if (_tip_scheme == "cap")
   {
     Real x = stress.trace() / 3.0 - _cap_start;
     Real p = 0;
     if (x > 0)
       p = x * (1 - std::exp(-_cap_rate * x));
     smoother2 += Utility::pow<2>(p);
   }
   return smoother2;
 }

◆ 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.

 {
   return false;
 }

◆ 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.

 {
   return false;
 }

◆ validParams()

InputParameters SolidMechanicsPlasticMohrCoulomb::validParams ( )

static

Definition at line 21 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   InputParameters params = SolidMechanicsPlasticModel::validParams();
   params.addRequiredParam<UserObjectName>(
       "cohesion",
       "A SolidMechanicsHardening UserObject that defines hardening of the cohesion.  "
       "Physically the cohesion should not be negative.");
   params.addRequiredParam<UserObjectName>(
       "friction_angle",
       "A SolidMechanicsHardening UserObject that defines hardening of the "
       "friction angle (in radians).  Physically the friction angle should be "
       "between 0 and 90deg.");
   params.addRequiredParam<UserObjectName>(
       "dilation_angle",
       "A SolidMechanicsHardening UserObject that defines hardening of the "
       "dilation angle (in radians).  Usually the dilation angle is not greater "
       "than the friction angle, and it is between 0 and 90deg.");
   params.addRangeCheckedParam<Real>(
       "mc_edge_smoother",
       25.0,
       "mc_edge_smoother>=0 & mc_edge_smoother<=30",
       "Smoothing parameter: the edges of the cone are smoothed by the given amount.");
   MooseEnum tip_scheme("hyperbolic cap", "hyperbolic");
   params.addParam<MooseEnum>(
       "tip_scheme", tip_scheme, "Scheme by which the pyramid's tip will be smoothed.");
   params.addRequiredRangeCheckedParam<Real>("mc_tip_smoother",
                                             "mc_tip_smoother>=0",
                                             "Smoothing parameter: the cone vertex at mean = "
                                             "cohesion*cot(friction_angle), will be smoothed by "
                                             "the given amount.  Typical value is 0.1*cohesion");
   params.addParam<Real>(
       "cap_start",
       0.0,
       "For the 'cap' tip_scheme, smoothing is performed in the stress_mean > cap_start region");
   params.addRangeCheckedParam<Real>("cap_rate",
                                     0.0,
                                     "cap_rate>=0",
                                     "For the 'cap' tip_scheme, this controls how quickly the cap "
                                     "degenerates to a hemisphere: small values mean a slow "
                                     "degeneration to a hemisphere (and zero means the 'cap' will "
                                     "be totally inactive).  Typical value is 1/tensile_strength");
   params.addParam<Real>("mc_lode_cutoff",
                         "If the second invariant of stress is less than this "
                         "amount, the Lode angle is assumed to be zero.  This is "
                         "to gaurd against precision-loss problems, and this "
                         "parameter should be set small.  Default = "
                         "0.00001*((yield_Function_tolerance)^2)");
   params.addClassDescription("Non-associative Mohr-Coulomb plasticity with hardening/softening");
 
   return params;
 }

◆ yieldFunction()

Real SolidMechanicsPlasticMohrCoulomb::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

stress	the stress at which to calculate the yield function
intnl	internal parameter

Returns: the yield function

Reimplemented from SolidMechanicsPlasticModel.

Definition at line 119 of file SolidMechanicsPlasticMohrCoulomb.C.

 {
   Real mean_stress = stress.trace() / 3.0;
   Real sinphi = std::sin(phi(intnl));
   Real cosphi = std::cos(phi(intnl));
   Real sin3Lode = stress.sin3Lode(_lode_cutoff, 0);
   if (std::abs(sin3Lode) <= _sin3tt)
   {
     // the non-edge-smoothed version
     std::vector<Real> eigvals;
     stress.symmetricEigenvalues(eigvals);
     return mean_stress * sinphi +
            std::sqrt(smooth(stress) +
                      0.25 * Utility::pow<2>(eigvals[2] - eigvals[0] +
                                             (eigvals[2] + eigvals[0] - 2 * mean_stress) * sinphi)) -
            cohesion(intnl) * cosphi;
   }
   else
   {
     // the edge-smoothed version
     Real aaa, bbb, ccc;
     abbo(sin3Lode, sinphi, aaa, bbb, ccc);
     Real kk = aaa + bbb * sin3Lode + ccc * Utility::pow<2>(sin3Lode);
     Real sibar2 = stress.secondInvariant();
     return mean_stress * sinphi + std::sqrt(smooth(stress) + sibar2 * Utility::pow<2>(kk)) -
            cohesion(intnl) * cosphi;
   }
 }

◆ 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

	stress	the stress at which to calculate the yield function
	intnl	internal parameter
[out]	f	the yield functions

Reimplemented in SolidMechanicsPlasticMohrCoulombMulti, and SolidMechanicsPlasticTensileMulti.

Definition at line 67 of file SolidMechanicsPlasticModel.C.

Referenced by SolidMechanicsPlasticModel::returnMap().

 {
   f.assign(1, yieldFunction(stress, intnl));
 }

Member Data Documentation

◆ _cap_rate

Real SolidMechanicsPlasticMohrCoulomb::_cap_rate

protected

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

Definition at line 76 of file SolidMechanicsPlasticMohrCoulomb.h.

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

◆ _cap_start

Real SolidMechanicsPlasticMohrCoulomb::_cap_start

protected

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

Definition at line 73 of file SolidMechanicsPlasticMohrCoulomb.h.

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

◆ _cohesion

const SolidMechanicsHardeningModel& SolidMechanicsPlasticMohrCoulomb::_cohesion

protected

Hardening model for cohesion.

Definition at line 51 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by cohesion(), and dcohesion().

◆ _cos3tt

Real SolidMechanicsPlasticMohrCoulomb::_cos3tt

protected

cos(3*_tt)

Definition at line 88 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), and dabbo().

◆ _cos6tt

Real SolidMechanicsPlasticMohrCoulomb::_cos6tt

protected

cos(6*_tt)

Definition at line 94 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), and dabbo().

◆ _costt

Real SolidMechanicsPlasticMohrCoulomb::_costt

protected

cos(_tt)

Definition at line 82 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), and dabbo().

◆ _f_tol

const Real SolidMechanicsPlasticModel::_f_tol

inherited

Tolerance on yield function.

Definition at line 170 of file SolidMechanicsPlasticModel.h.

◆ _ic_tol

const Real SolidMechanicsPlasticModel::_ic_tol

inherited

Tolerance on internal constraint.

Definition at line 173 of file SolidMechanicsPlasticModel.h.

◆ _lode_cutoff

Real SolidMechanicsPlasticMohrCoulomb::_lode_cutoff

protected

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

Definition at line 100 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by df_dsig(), dflowPotential_dintnl(), dflowPotential_dstress(), dyieldFunction_dintnl(), SolidMechanicsPlasticMohrCoulomb(), and yieldFunction().

◆ _phi

const SolidMechanicsHardeningModel& SolidMechanicsPlasticMohrCoulomb::_phi

protected

Hardening model for phi.

Definition at line 54 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by dphi(), and phi().

◆ _psi

const SolidMechanicsHardeningModel& SolidMechanicsPlasticMohrCoulomb::_psi

protected

Hardening model for psi.

Definition at line 57 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by dpsi(), and psi().

◆ _sin3tt

Real SolidMechanicsPlasticMohrCoulomb::_sin3tt

protected

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

Definition at line 91 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), dabbo(), df_dsig(), dflowPotential_dintnl(), dflowPotential_dstress(), dyieldFunction_dintnl(), and yieldFunction().

◆ _sin6tt

Real SolidMechanicsPlasticMohrCoulomb::_sin6tt

protected

sin(6*_tt)

Definition at line 97 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), and dabbo().

◆ _sintt

Real SolidMechanicsPlasticMohrCoulomb::_sintt

protected

sin(_tt)

Definition at line 85 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by abbo(), and dabbo().

◆ _small_smoother2

Real SolidMechanicsPlasticMohrCoulomb::_small_smoother2

protected

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

Definition at line 70 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by smooth().

◆ _tip_scheme

MooseEnum SolidMechanicsPlasticMohrCoulomb::_tip_scheme

protected

The yield function is modified to f = s_m*sinphi + sqrt(a + s_bar^2 K^2) - C*cosphi 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 67 of file SolidMechanicsPlasticMohrCoulomb.h.

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

◆ _tt

Real SolidMechanicsPlasticMohrCoulomb::_tt

protected

edge smoothing parameter, in radians

Definition at line 79 of file SolidMechanicsPlasticMohrCoulomb.h.

Referenced by SolidMechanicsPlasticMohrCoulomb().

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

solid_mechanics/include/userobjects/SolidMechanicsPlasticMohrCoulomb.h
solid_mechanics/src/userobjects/SolidMechanicsPlasticMohrCoulomb.C

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

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ SolidMechanicsPlasticMohrCoulomb()

Member Function Documentation

◆ abbo()

◆ activeConstraints()

◆ cohesion()

◆ consistentTangentOperator()

◆ d2smooth()

◆ dabbo()

◆ dcohesion()

◆ df_dsig()

◆ dflowPotential_dintnl()

◆ dflowPotential_dintnlV()

◆ dflowPotential_dstress()

◆ dflowPotential_dstressV()

◆ dhardPotential_dintnl()

◆ dhardPotential_dintnlV()

◆ dhardPotential_dstress()

◆ dhardPotential_dstressV()

◆ dphi()

◆ dpsi()

◆ dsmooth()

◆ dyieldFunction_dintnl()

◆ dyieldFunction_dintnlV()

◆ dyieldFunction_dstress()

◆ dyieldFunction_dstressV()

◆ execute()

◆ finalize()

◆ flowPotential()

◆ flowPotentialV()

◆ hardPotential()

◆ hardPotentialV()

◆ initialize()

◆ KuhnTuckerSingleSurface()

◆ modelName()

◆ numberSurfaces()

◆ phi()

◆ psi()

◆ returnMap()

◆ smooth()

◆ useCustomCTO()

◆ useCustomReturnMap()

◆ validParams()

◆ yieldFunction()

◆ yieldFunctionV()

Member Data Documentation

◆ _cap_rate

◆ _cap_start

◆ _cohesion

◆ _cos3tt

◆ _cos6tt

◆ _costt

◆ _f_tol

◆ _ic_tol

◆ _lode_cutoff

◆ _phi

◆ _psi

◆ _sin3tt

◆ _sin6tt

◆ _sintt

◆ _small_smoother2

◆ _tip_scheme

◆ _tt