Simple isotropic damage based model for 2d and 3d interface elements. More...

#include <isointerfacedamage02.h>

Inheritance diagram for oofem::IsoInterfaceDamageMaterial_2:

Collaboration diagram for oofem::IsoInterfaceDamageMaterial_2:

Public Member Functions
	IsoInterfaceDamageMaterial_2 (int n, Domain *d)
	Constructor. More...

virtual	~IsoInterfaceDamageMaterial_2 ()
	Destructor. More...

virtual int	hasNonLinearBehaviour ()
	Returns nonzero if receiver is non linear. More...

virtual bool	hasAnalyticalTangentStiffness () const
	Tells if the model has implemented analytical tangent stiffness. More...

virtual const char *	giveInputRecordName () const

virtual const char *	giveClassName () const

virtual void	giveEngTraction_3d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, TimeStep tStep)

virtual void	give3dStiffnessMatrix_Eng (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)

virtual int	giveIPValue (FloatArray &answer, GaussPoint gp, InternalStateType type, TimeStep tStep)
	Returns the integration point corresponding value in Reduced form. More...

virtual void	computeEquivalentStrain (double &kappa, const FloatArray &strain, GaussPoint gp, TimeStep tStep)
	Computes the equivalent strain measure from given strain vector (full form). More...

virtual void	computeDamageParam (double &omega, double kappa, const FloatArray &strain, GaussPoint *gp)
	computes the value of damage parameter omega, based on given value of equivalent strain. More...

virtual IRResultType	initializeFrom (InputRecord *ir)
	Initializes receiver according to object description stored in input record. More...

virtual void	giveInputRecord (DynamicInputRecord &input)
	Setups the input record string of receiver. More...

virtual MaterialStatus *	CreateStatus (GaussPoint *gp) const
	Creates new copy of associated status and inserts it into given integration point. More...

Public Member Functions inherited from oofem::StructuralInterfaceMaterial
	StructuralInterfaceMaterial (int n, Domain *d)
	Constructor. More...

virtual	~StructuralInterfaceMaterial ()
	Destructor. More...

virtual void	giveFirstPKTraction_1d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, const FloatMatrix &reducedF, TimeStep tStep)
	Computes the first Piola-Kirchoff traction vector for given total jump/gap and integration point. More...

virtual void	giveFirstPKTraction_2d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, const FloatMatrix &reducedF, TimeStep tStep)

virtual void	giveFirstPKTraction_3d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, const FloatMatrix &F, TimeStep tStep)

virtual void	giveEngTraction_1d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, TimeStep tStep)

virtual void	giveEngTraction_2d (FloatArray &answer, GaussPoint gp, const FloatArray &jump, TimeStep tStep)

virtual void	give1dStiffnessMatrix_dTdj (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)
	Gives the tangent: $\frac{\partial T}{\partial j}$ . More...

virtual void	give2dStiffnessMatrix_dTdj (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)

virtual void	give3dStiffnessMatrix_dTdj (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)

virtual void	give1dStiffnessMatrix_Eng (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)

virtual void	give2dStiffnessMatrix_Eng (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)

void	give1dStiffnessMatrix_dTdj_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

void	give2dStiffnessMatrix_dTdj_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

void	give3dStiffnessMatrix_dTdj_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

void	give1dStiffnessMatrix_Eng_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

void	give2dStiffnessMatrix_Eng_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

void	give3dStiffnessMatrix_Eng_Num (FloatMatrix &answer, GaussPoint gp, TimeStep tStep)

virtual FloatArray	giveInterfaceStrength ()

Public Member Functions inherited from oofem::Material
	Material (int n, Domain *d)
	Constructor. More...

virtual	~Material ()
	Destructor. More...

virtual bool	isCharacteristicMtrxSymmetric (MatResponseMode rMode)
	Returns true if stiffness matrix of receiver is symmetric Default implementation returns true. More...

virtual double	give (int aProperty, GaussPoint *gp)
	Returns the value of material property 'aProperty'. More...

virtual bool	hasProperty (int aProperty, GaussPoint *gp)
	Returns true if 'aProperty' exists on material. More...

virtual void	modifyProperty (int aProperty, double value, GaussPoint *gp)
	Modify 'aProperty', which already exists on material. More...

double	giveCastingTime ()

virtual bool	isActivated (TimeStep *tStep)

virtual int	hasMaterialModeCapability (MaterialMode mode)
	Tests if material supports material mode. More...

virtual int	hasCastingTimeSupport ()
	Tests if material supports casting time. More...

virtual void	printYourself ()
	Prints receiver state on stdout. Useful for debugging. More...

virtual contextIOResultType	saveIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
	Stores integration point state to output stream. More...

virtual contextIOResultType	restoreIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
	Reads integration point state to output stream. More...

virtual int	checkConsistency ()
	Allows programmer to test some internal data, before computation begins. More...

virtual int	initMaterial (Element *element)
	Optional function to call specific procedures when initializing a material. More...

virtual MaterialStatus *	giveStatus (GaussPoint *gp) const
	Returns material status of receiver in given integration point. More...

virtual int	packUnknowns (DataStream &buff, TimeStep tStep, GaussPoint ip)
	Pack all necessary data of integration point (according to element parallel_mode) into given communication buffer. More...

virtual int	unpackAndUpdateUnknowns (DataStream &buff, TimeStep tStep, GaussPoint ip)
	Unpack and updates all necessary data of given integration point (according to element parallel_mode) into given communication buffer. More...

virtual int	estimatePackSize (DataStream &buff, GaussPoint *ip)
	Estimates the necessary pack size to hold all packed data of receiver. More...

virtual double	predictRelativeComputationalCost (GaussPoint *gp)
	Returns the weight representing relative computational cost of receiver The reference material model is linear isotropic material - its weight is set to 1.0 The other material models should compare to this reference model. More...

virtual double	predictRelativeRedistributionCost (GaussPoint *gp)
	Returns the relative redistribution cost of the receiver. More...

virtual void	initTempStatus (GaussPoint *gp)
	Initializes temporary variables stored in integration point status at the beginning of new time step. More...

virtual int	setIPValue (const FloatArray &value, GaussPoint *gp, InternalStateType type)
	Sets the value of a certain variable at a given integration point to the given value. More...

Public Member Functions inherited from oofem::FEMComponent
	FEMComponent (int n, Domain *d)
	Regular constructor, creates component with given number and belonging to given domain. More...

virtual	~FEMComponent ()
	Virtual destructor. More...

Domain *	giveDomain () const

virtual void	setDomain (Domain *d)
	Sets associated Domain. More...

int	giveNumber () const

void	setNumber (int num)
	Sets number of receiver. More...

virtual void	updateLocalNumbering (EntityRenumberingFunctor &f)
	Local renumbering support. More...

virtual contextIOResultType	saveContext (DataStream &stream, ContextMode mode, void *obj=NULL)
	Stores receiver state to output stream. More...

virtual contextIOResultType	restoreContext (DataStream &stream, ContextMode mode, void *obj=NULL)
	Restores the receiver state previously written in stream. More...

virtual void	printOutputAt (FILE file, TimeStep tStep)
	Prints output of receiver to stream, for given time step. More...

virtual Interface *	giveInterface (InterfaceType t)
	Interface requesting service. More...

std::string	errorInfo (const char *func) const
	Returns string for prepending output (used by error reporting macros). More...

Protected Attributes
double	kn
	Elastic properties (normal moduli). More...

double	ks
	Shear moduli. More...

double	ft
	Tension strength. More...

double	e0
	Limit elastic deformation. More...

double	maxOmega
	Maximum limit on omega. The purpose is elimination of a too compliant material which may cause convergency problems. Set to something like 0.99 if needed. More...

std::string	tablename
	Name of table file. More...

FloatArray	damages
	Damages read from the second column in the table file. More...

FloatArray	strains
	Strains read from the first column in the table file. More...

Protected Attributes inherited from oofem::Material
Dictionary	propertyDictionary
	Property dictionary. More...

double	castingTime
	Casting time. More...

Protected Attributes inherited from oofem::FEMComponent
int	number
	Component number. More...

Domain *	domain
	Link to domain object, useful for communicating with other FEM components. More...

Additional Inherited Members
Public Attributes inherited from oofem::StructuralInterfaceMaterial
bool	useNumericalTangent

Detailed Description

Simple isotropic damage based model for 2d and 3d interface elements.

In 2d, the interface elements are used to model contact layer between element edges. The generalized strain vector contains two relative displacements (in normal and shear direction). The generalized stress vector contains corresponding tractions in normal and tangent direction.

In 3d, the interface elements are used to model contact layer between element surfaces. The generalized strain vector contains two relative displacements (in normal and shear direction). The generalized stress vector contains corresponding tractions in normal and tangent direction

The behaviour of the model is elastic, described by normal and shear stiffness components. Isotropic damage is initiated when the stress reaches the tensile strength. Damage evolution is governed by normal component of generalized strain vector (normal relative displacement) by a table given by a file that relates the normal displacement to the damage. A linear interpolation is made between the values given in the table. If the strain is greater than the largest value in the table the largest damage in the table will be used.

Differences between this class and IsoInterfaceDamageMaterial written by:

Author: Kristoffer Carlsson

Definition at line 125 of file isointerfacedamage02.h.

Constructor & Destructor Documentation

oofem::IsoInterfaceDamageMaterial_2::IsoInterfaceDamageMaterial_2	(	int	n,
		Domain *	d
	)

Constructor.

Definition at line 50 of file isointerfacedamage02.C.

References maxOmega.

oofem::IsoInterfaceDamageMaterial_2::~IsoInterfaceDamageMaterial_2 ( )

virtual

Destructor.

Definition at line 56 of file isointerfacedamage02.C.

Member Function Documentation

void oofem::IsoInterfaceDamageMaterial_2::computeDamageParam	(	double &	omega,
		double	kappa,
		const FloatArray &	strain,
		GaussPoint *	gp
	)

virtual

computes the value of damage parameter omega, based on given value of equivalent strain.

Parameters

[out]	omega	Contains result.
	kappa	Equivalent strain measure.
	strain	Total strain vector in full form. (unnecessary?)
	gp	Integration point.

Definition at line 265 of file isointerfacedamage02.C.

References oofem::FloatArray::at(), damages, e0, oofem::FloatArray::givePointer(), oofem::FloatArray::giveSize(), and strains.

Referenced by giveEngTraction_3d().

void oofem::IsoInterfaceDamageMaterial_2::computeEquivalentStrain	(	double &	kappa,
		const FloatArray &	strain,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Computes the equivalent strain measure from given strain vector (full form).

Parameters

[out]	kappa	Return parameter containing the corresponding equivalent strain.
	strain	Total strain vector in full form.
	gp	Integration point.
	tStep	Time step.

Definition at line 259 of file isointerfacedamage02.C.

References oofem::FloatArray::at(), and oofem::macbra().

virtual MaterialStatus* oofem::IsoInterfaceDamageMaterial_2::CreateStatus ( GaussPoint * gp ) const

inlinevirtual

Creates new copy of associated status and inserts it into given integration point.

Parameters

gp	Integration point where newly created status will be stored.

Returns: Reference to new status.

Reimplemented from oofem::Material.

Definition at line 183 of file isointerfacedamage02.h.

References oofem::FEMComponent::domain, and oofem::IsoInterfaceDamageMaterialStatus_2::IsoInterfaceDamageMaterialStatus_2().

void oofem::IsoInterfaceDamageMaterial_2::give3dStiffnessMatrix_Eng	(	FloatMatrix &	answer,
		MatResponseMode	rMode,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

virtual const char* oofem::IsoInterfaceDamageMaterial_2::giveClassName ( ) const

inlinevirtual

Returns: Class name of the receiver.

Reimplemented from oofem::StructuralInterfaceMaterial.

Definition at line 155 of file isointerfacedamage02.h.

References oofem::FEMComponent::giveInputRecord(), oofem::IntegrationPointStatus::gp, oofem::MaterialStatus::initializeFrom(), oofem::StructuralInterfaceMaterialStatus::jump, and oofem::IsoInterfaceDamageMaterialStatus_2::kappa.

void oofem::IsoInterfaceDamageMaterial_2::giveEngTraction_3d	(	FloatArray &	answer,
		GaussPoint *	gp,
		const FloatArray &	jump,
		TimeStep *	tStep
	)

virtual

Reimplemented from oofem::StructuralInterfaceMaterial.

Definition at line 60 of file isointerfacedamage02.C.

References oofem::FloatArray::at(), oofem::FloatArray::beProductOf(), computeDamageParam(), give3dStiffnessMatrix_Eng(), oofem::IsoInterfaceDamageMaterialStatus_2::giveDamage(), oofem::IsoInterfaceDamageMaterialStatus_2::giveKappa(), oofem::Material::giveStatus(), oofem::StructuralInterfaceMaterialStatus::letTempJumpBe(), oofem::StructuralInterfaceMaterialStatus::letTempTractionBe(), oofem::macbra(), oofem::IsoInterfaceDamageMaterialStatus_2::setTempDamage(), oofem::IsoInterfaceDamageMaterialStatus_2::setTempKappa(), and oofem::FloatMatrix::times().

void oofem::IsoInterfaceDamageMaterial_2::giveInputRecord ( DynamicInputRecord & input )

virtual

Setups the input record string of receiver.

Parameters

input Dynamic input record to be filled by receiver.

Reimplemented from oofem::StructuralInterfaceMaterial.

Definition at line 246 of file isointerfacedamage02.C.

References _IFT_IsoInterfaceDamageMaterial_2_ft, _IFT_IsoInterfaceDamageMaterial_2_kn, _IFT_IsoInterfaceDamageMaterial_2_ks, _IFT_IsoInterfaceDamageMaterial_2_maxOmega, _IFT_IsoInterfaceDamageMaterial_2_tablename, ft, oofem::StructuralInterfaceMaterial::giveInputRecord(), kn, ks, maxOmega, oofem::DynamicInputRecord::setField(), and tablename.

virtual const char* oofem::IsoInterfaceDamageMaterial_2::giveInputRecordName ( ) const

inlinevirtual

Returns: Input record name of the receiver.

Implements oofem::FEMComponent.

Definition at line 154 of file isointerfacedamage02.h.

References _IFT_IsoInterfaceDamageMaterial_2_Name.

int oofem::IsoInterfaceDamageMaterial_2::giveIPValue	(	FloatArray &	answer,
		GaussPoint *	gp,
		InternalStateType	type,
		TimeStep *	tStep
	)

virtual

Returns the integration point corresponding value in Reduced form.

Parameters

answer	Contain corresponding ip value, zero sized if not available.
gp	Integration point to which the value refers.
type	Determines the type of internal variable.
tStep	Determines the time step.

Returns: Nonzero if the assignment can be done, zero if this type of variable is not supported.

Reimplemented from oofem::StructuralInterfaceMaterial.

Definition at line 154 of file isointerfacedamage02.C.

References oofem::FloatArray::at(), oofem::IsoInterfaceDamageMaterialStatus_2::giveDamage(), oofem::StructuralInterfaceMaterial::giveIPValue(), oofem::IsoInterfaceDamageMaterialStatus_2::giveKappa(), oofem::Material::giveStatus(), oofem::IsoInterfaceDamageMaterialStatus_2::giveTempDamage(), oofem::FloatArray::resize(), and oofem::FloatArray::zero().

virtual bool oofem::IsoInterfaceDamageMaterial_2::hasAnalyticalTangentStiffness ( ) const

inlinevirtual

Tells if the model has implemented analytical tangent stiffness.

If not, the tangent must be computed numerically.

Implements oofem::StructuralInterfaceMaterial.

Definition at line 152 of file isointerfacedamage02.h.

virtual int oofem::IsoInterfaceDamageMaterial_2::hasNonLinearBehaviour ( )

inlinevirtual

Returns nonzero if receiver is non linear.

Reimplemented from oofem::Material.

Definition at line 151 of file isointerfacedamage02.h.

IRResultType oofem::IsoInterfaceDamageMaterial_2::initializeFrom ( InputRecord * ir )

virtual

Initializes receiver according to object description stored in input record.

This function is called immediately after creating object using constructor. Input record can be imagined as data record in component database belonging to receiver. Receiver may use value-name extracting functions to extract particular field from record.

See also: IR_GIVE_FIELD; IR_GIVE_OPTIONAL_FIELD

Parameters

ir	Input record to initialize from.

Returns: IRResultType

Reimplemented from oofem::StructuralInterfaceMaterial.

Definition at line 186 of file isointerfacedamage02.C.

References _IFT_IsoInterfaceDamageMaterial_2_ft, _IFT_IsoInterfaceDamageMaterial_2_kn, _IFT_IsoInterfaceDamageMaterial_2_ks, _IFT_IsoInterfaceDamageMaterial_2_maxOmega, _IFT_IsoInterfaceDamageMaterial_2_tablename, oofem::FloatArray::add(), damages, e0, ft, oofem::StructuralInterfaceMaterial::initializeFrom(), IR_GIVE_FIELD, IR_GIVE_OPTIONAL_FIELD, kn, ks, oofem::max(), maxOmega, oofem::min(), OOFEM_ERROR, oofem::FloatArray::resize(), strains, and tablename.

Member Data Documentation

FloatArray oofem::IsoInterfaceDamageMaterial_2::damages

protected

Damages read from the second column in the table file.

Definition at line 141 of file isointerfacedamage02.h.

Referenced by computeDamageParam(), and initializeFrom().

double oofem::IsoInterfaceDamageMaterial_2::e0

protected

Limit elastic deformation.

Definition at line 135 of file isointerfacedamage02.h.

Referenced by computeDamageParam(), give3dStiffnessMatrix_Eng(), and initializeFrom().

double oofem::IsoInterfaceDamageMaterial_2::ft

protected

Tension strength.

Definition at line 133 of file isointerfacedamage02.h.

Referenced by give3dStiffnessMatrix_Eng(), giveInputRecord(), and initializeFrom().

double oofem::IsoInterfaceDamageMaterial_2::kn

protected

Elastic properties (normal moduli).

Definition at line 129 of file isointerfacedamage02.h.

Referenced by give3dStiffnessMatrix_Eng(), giveInputRecord(), and initializeFrom().

double oofem::IsoInterfaceDamageMaterial_2::ks

protected

Shear moduli.

Definition at line 131 of file isointerfacedamage02.h.

Referenced by give3dStiffnessMatrix_Eng(), giveInputRecord(), and initializeFrom().

double oofem::IsoInterfaceDamageMaterial_2::maxOmega

protected

Maximum limit on omega. The purpose is elimination of a too compliant material which may cause convergency problems. Set to something like 0.99 if needed.

Definition at line 137 of file isointerfacedamage02.h.

Referenced by give3dStiffnessMatrix_Eng(), giveInputRecord(), initializeFrom(), and IsoInterfaceDamageMaterial_2().