OOFEM 3.0
Loading...
Searching...
No Matches
oofem::StructuralInterfaceMaterial Class Referenceabstract

#include <structuralinterfacematerial.h>

Inheritance diagram for oofem::StructuralInterfaceMaterial:
Collaboration diagram for oofem::StructuralInterfaceMaterial:

Public Member Functions

 StructuralInterfaceMaterial (int n, Domain *d)
virtual double giveFirstPKTraction_1d (double jump, double reducedF, GaussPoint *gp, TimeStep *tStep) const
virtual FloatArrayF< 2 > giveFirstPKTraction_2d (const FloatArrayF< 2 > &jump, const FloatMatrixF< 2, 2 > &reducedF, GaussPoint *gp, TimeStep *tStep) const
virtual FloatArrayF< 3 > giveFirstPKTraction_3d (const FloatArrayF< 3 > &jump, const FloatMatrixF< 3, 3 > &F, GaussPoint *gp, TimeStep *tStep) const
virtual double giveEngTraction_1d (double jump, GaussPoint *gp, TimeStep *tStep) const
virtual FloatArrayF< 2 > giveEngTraction_2d (const FloatArrayF< 2 > &jump, GaussPoint *gp, TimeStep *tStep) const
virtual FloatArrayF< 3 > giveEngTraction_3d (const FloatArrayF< 3 > &jump, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 1, 1 > give1dStiffnessMatrix_dTdj (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 2, 2 > give2dStiffnessMatrix_dTdj (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 3, 3 > give3dStiffnessMatrix_dTdj (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 1, 1 > give1dStiffnessMatrix_Eng (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 2, 2 > give2dStiffnessMatrix_Eng (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
virtual FloatMatrixF< 3, 3 > give3dStiffnessMatrix_Eng (MatResponseMode rMode, GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 1, 1 > give1dStiffnessMatrix_dTdj_Num (GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 2, 2 > give2dStiffnessMatrix_dTdj_Num (GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 3, 3 > give3dStiffnessMatrix_dTdj_Num (GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 1, 1 > give1dStiffnessMatrix_Eng_Num (GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 2, 2 > give2dStiffnessMatrix_Eng_Num (GaussPoint *gp, TimeStep *tStep) const
FloatMatrixF< 3, 3 > give3dStiffnessMatrix_Eng_Num (GaussPoint *gp, TimeStep *tStep) const
virtual bool hasAnalyticalTangentStiffness () const =0
void initializeFrom (InputRecord &ir) override
void giveInputRecord (DynamicInputRecord &input) override
virtual FloatArray giveInterfaceStrength ()
int giveIPValue (FloatArray &answer, GaussPoint *gp, InternalStateType type, TimeStep *tStep) override
Public Member Functions inherited from oofem::Material
 Material (int n, Domain *d)
virtual ~Material ()=default
 Destructor.
virtual bool isCharacteristicMtrxSymmetric (MatResponseMode rMode) const
virtual void giveCharacteristicMatrix (FloatMatrix &answer, MatResponseMode type, GaussPoint *gp, TimeStep *tStep) const
 Returns characteristic matrix of the receiver.
virtual void giveCharacteristicVector (FloatArray &answer, FloatArray &flux, MatResponseMode type, GaussPoint *gp, TimeStep *tStep) const
 Returns characteristic vector of the receiver.
virtual double giveCharacteristicValue (MatResponseMode type, GaussPoint *gp, TimeStep *tStep) const
 Returns characteristic value of the receiver.
virtual double give (int aProperty, GaussPoint *gp) const
virtual bool hasProperty (int aProperty, GaussPoint *gp) const
virtual void modifyProperty (int aProperty, double value, GaussPoint *gp)
double giveCastingTime () const
virtual bool isActivated (TimeStep *tStep) const
virtual bool hasMaterialModeCapability (MaterialMode mode) const
virtual bool hasCastingTimeSupport () const
virtual int setIPValue (const FloatArray &value, GaussPoint *gp, InternalStateType type)
void printYourself () override
 Prints receiver state on stdout. Useful for debugging.
virtual void saveIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
virtual void restoreIPContext (DataStream &stream, ContextMode mode, GaussPoint *gp)
int checkConsistency () override
virtual void restoreConsistency (GaussPoint *gp)
virtual int initMaterial (Element *element)
virtual MaterialStatusgiveStatus (GaussPoint *gp) const
virtual int packUnknowns (DataStream &buff, TimeStep *tStep, GaussPoint *ip)
virtual int unpackAndUpdateUnknowns (DataStream &buff, TimeStep *tStep, GaussPoint *ip)
virtual int estimatePackSize (DataStream &buff, GaussPoint *ip)
virtual double predictRelativeComputationalCost (GaussPoint *gp)
virtual double predictRelativeRedistributionCost (GaussPoint *gp)
virtual std::unique_ptr< MaterialStatusCreateStatus (GaussPoint *gp) const
virtual void initTempStatus (GaussPoint *gp) const
void saveContext (DataStream &stream, ContextMode mode) override
void restoreContext (DataStream &stream, ContextMode mode) override
Public Member Functions inherited from oofem::FEMComponent
 FEMComponent (int n, Domain *d)
virtual ~FEMComponent ()=default
 Virtual destructor.
virtual const char * giveClassName () const =0
virtual const char * giveInputRecordName () const =0
DomaingiveDomain () const
virtual void setDomain (Domain *d)
int giveNumber () const
void setNumber (int num)
virtual void updateLocalNumbering (EntityRenumberingFunctor &f)
virtual void initializeFrom (InputRecord &ir, int priority)
virtual void initializeFinish ()
virtual void postInitialize ()
 Performs post initialization steps. Called after all components are created and initialized.
virtual void printOutputAt (FILE *file, TimeStep *tStep)
virtual InterfacegiveInterface (InterfaceType t)
std::string errorInfo (const char *func) const
 Returns string for prepending output (used by error reporting macros).

Public Attributes

bool useNumericalTangent

Additional Inherited Members

Protected Attributes inherited from oofem::Material
Dictionary propertyDictionary
double castingTime
int preCastingTimeMat
 Material existing before casting time - optional parameter, zero by default.
Protected Attributes inherited from oofem::FEMComponent
int number
 Component number.
Domaindomain
 Link to domain object, useful for communicating with other FEM components.

Detailed Description

Abstract base class for all "structural" interface models. It declares common services provided by all interface material models. The implementation of these services is partly left on derived classes, which will implement constitutive model dependent part.

Structural material introduces following basic stress/strain modes

  • 3d state - all components of general stress/strain vector are generally nonzero. General 3d jump vector has following components {j_x, j_y, j_z}

Generally speaking, there are following major tasks, covered by declared services.

  • Computing engineering/first PK traction vector at integration point for given jump/discontinuity and updating its state (still temporary state, after overall equilibrium is reached).
  • Updating its state (final state), when equilibrium has been reached.
  • Storing/restoring its context to stream.
  • Returning its material properties.
Author
Jim Brouzoulis

Definition at line 74 of file structuralinterfacematerial.h.

Constructor & Destructor Documentation

◆ StructuralInterfaceMaterial()

Member Function Documentation

◆ give1dStiffnessMatrix_dTdj()

FloatMatrixF< 1, 1 > oofem::StructuralInterfaceMaterial::give1dStiffnessMatrix_dTdj ( MatResponseMode rMode,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

Gives the tangent: \( \frac{\partial T}{\partial j} \). Where T is the first PK traction and j is the spatial jump between the two sides, x(+) - x(-)

Parameters
answerThe computed tangent from the last evaluated first-PK-stress.
rModeMaterial mode.
gpGauss point.
tStepTime step.

Definition at line 126 of file structuralinterfacematerial.C.

References give3dStiffnessMatrix_dTdj_Num().

Referenced by oofem::StructuralInterfaceCrossSection::give1dStiffnessMatrix_dTdj().

◆ give1dStiffnessMatrix_dTdj_Num()

◆ give1dStiffnessMatrix_Eng()

FloatMatrixF< 1, 1 > oofem::StructuralInterfaceMaterial::give1dStiffnessMatrix_Eng ( MatResponseMode rMode,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ give1dStiffnessMatrix_Eng_Num()

◆ give2dStiffnessMatrix_dTdj()

FloatMatrixF< 2, 2 > oofem::StructuralInterfaceMaterial::give2dStiffnessMatrix_dTdj ( MatResponseMode rMode,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ give2dStiffnessMatrix_dTdj_Num()

◆ give2dStiffnessMatrix_Eng()

FloatMatrixF< 2, 2 > oofem::StructuralInterfaceMaterial::give2dStiffnessMatrix_Eng ( MatResponseMode rMode,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ give2dStiffnessMatrix_Eng_Num()

◆ give3dStiffnessMatrix_dTdj()

◆ give3dStiffnessMatrix_dTdj_Num()

◆ give3dStiffnessMatrix_Eng()

◆ give3dStiffnessMatrix_Eng_Num()

◆ giveEngTraction_1d()

double oofem::StructuralInterfaceMaterial::giveEngTraction_1d ( double jump,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ giveEngTraction_2d()

FloatArrayF< 2 > oofem::StructuralInterfaceMaterial::giveEngTraction_2d ( const FloatArrayF< 2 > & jump,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ giveEngTraction_3d()

◆ giveFirstPKTraction_1d()

double oofem::StructuralInterfaceMaterial::giveFirstPKTraction_1d ( double jump,
double reducedF,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

Computes the first Piola-Kirchoff traction vector for given total jump/gap and integration point. The total gap is computed from the displacement field at the given time step. The service should use previously reached equilibrium history variables. Also it should update temporary history variables in status according to newly reached state. The temporary history variables are moved into equilibrium ones after global structure equilibrium has been reached by iteration process.

Parameters
answerContains result.
gpIntegration point.
reducedFDeformation gradient in in reduced form.
tStepCurrent time step (most models are able to respond only when tStep is current time step).

Definition at line 149 of file structuralinterfacematerial.C.

References oofem::diag(), and giveFirstPKTraction_3d().

Referenced by give1dStiffnessMatrix_dTdj_Num(), and oofem::StructuralInterfaceCrossSection::giveFirstPKTraction_1d().

◆ giveFirstPKTraction_2d()

FloatArrayF< 2 > oofem::StructuralInterfaceMaterial::giveFirstPKTraction_2d ( const FloatArrayF< 2 > & jump,
const FloatMatrixF< 2, 2 > & reducedF,
GaussPoint * gp,
TimeStep * tStep ) const
virtual

◆ giveFirstPKTraction_3d()

◆ giveInputRecord()

void oofem::StructuralInterfaceMaterial::giveInputRecord ( DynamicInputRecord & input)
overridevirtual

Setups the input record string of receiver.

Parameters
inputDynamic input record to be filled by receiver.

Reimplemented from oofem::Material.

Definition at line 84 of file structuralinterfacematerial.C.

Referenced by oofem::IntMatBilinearCZFagerstrom::giveInputRecord().

◆ giveInterfaceStrength()

virtual FloatArray oofem::StructuralInterfaceMaterial::giveInterfaceStrength ( )
inlinevirtual

◆ giveIPValue()

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

Returns the integration point corresponding value in Reduced form.

Parameters
answerContain corresponding ip value, zero sized if not available.
gpIntegration point to which the value refers.
typeDetermines the type of internal variable.
tStepDetermines the time step.
Returns
Nonzero if the assignment can be done, zero if this type of variable is not supported.

Reimplemented from oofem::Material.

Definition at line 48 of file structuralinterfacematerial.C.

References oofem::FloatArray::at(), oofem::StructuralInterfaceMaterialStatus::giveDamage(), oofem::StructuralInterfaceMaterialStatus::giveF(), oofem::StructuralInterfaceMaterialStatus::giveFirstPKTraction(), oofem::StructuralInterfaceMaterialStatus::giveJump(), oofem::StructuralInterfaceMaterialStatus::giveNormal(), oofem::Material::giveStatus(), oofem::StructuralInterfaceMaterialStatus::giveTraction(), oofem::FloatArray::resize(), and oofem::to_voigt_form_33().

Referenced by oofem::Shell7BaseXFEM::giveMaxCZDamages().

◆ hasAnalyticalTangentStiffness()

◆ initializeFrom()

void oofem::StructuralInterfaceMaterial::initializeFrom ( InputRecord & ir)
overridevirtual

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. Note that initializeFrom may be called mutiple times.

See also
IR_GIVE_FIELD
IR_GIVE_OPTIONAL_FIELD
Parameters
irInput record to initialize from.
priorityPriority of the input record. This is used to determine the order of initialization

Reimplemented from oofem::Material.

Definition at line 77 of file structuralinterfacematerial.C.

References _IFT_StructuralInterfaceMaterial_useNumericalTangent, IR_GIVE_OPTIONAL_FIELD, and useNumericalTangent.

Member Data Documentation

◆ useNumericalTangent


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

This page is part of the OOFEM-3.0 documentation. Copyright Copyright (C) 1994-2025 Borek Patzak Bořek Patzák
Project e-mail: oofem@fsv.cvut.cz
Generated at for OOFEM by doxygen 1.15.0 written by Dimitri van Heesch, © 1997-2011