Abstract base class for all structural interface elements. More...

#include <structuralinterfaceelement.h>

Inheritance diagram for oofem::StructuralInterfaceElement:

Collaboration diagram for oofem::StructuralInterfaceElement:

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

virtual	~StructuralInterfaceElement ()
	Destructor. More...

virtual int	computeGlobalCoordinates (FloatArray &answer, const FloatArray &lcoords)
	Computes the global coordinates from given element's local coordinates. More...

virtual void	giveCharacteristicMatrix (FloatMatrix &answer, CharType, TimeStep *tStep)
	Computes characteristic matrix of receiver of requested type in given time step. More...

virtual void	giveCharacteristicVector (FloatArray &answer, CharType type, ValueModeType mode, TimeStep *tStep)
	Computes characteristic vector of receiver of requested type in given time step. More...

virtual FEInterpolation *	giveInterpolation () const

virtual void	computeStiffnessMatrix (FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep)
	Computes the stiffness/tangent matrix of receiver. More...

virtual void	giveInternalForcesVector (FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord=0)
	Returns equivalent nodal forces vectors. More...

virtual void	computeTraction (FloatArray &traction, IntegrationPoint ip, const FloatArray &jump, TimeStep tStep)

virtual void	computeSpatialJump (FloatArray &answer, GaussPoint gp, TimeStep tStep)

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

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

virtual void	updateInternalState (TimeStep *tStep)
	Updates element state after equilibrium in time step has been reached. More...

virtual void	updateYourself (TimeStep *tStep)
	Updates element state after equilibrium in time step has been reached. More...

virtual int	checkConsistency ()
	Performs consistency check. 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 const char *	giveClassName () const

StructuralInterfaceCrossSection *	giveInterfaceCrossSection ()

virtual double	computeAreaAround (GaussPoint *gp)=0

virtual Element_Geometry_Type	giveGeometryType () const
	Returns the element geometry type. More...

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

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

virtual void	giveStiffnessMatrix_Eng (FloatMatrix &answer, MatResponseMode rMode, IntegrationPoint ip, TimeStep tStep)

virtual void	giveStiffnessMatrix_dTdj (FloatMatrix &answer, MatResponseMode rMode, IntegrationPoint ip, TimeStep tStep)

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

	Element (const Element &src)=delete

Element &	operator= (const Element &src)=delete

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

virtual void	drawYourself (oofegGraphicContext &gc, TimeStep *tStep)

virtual void	drawAnnotation (oofegGraphicContext &gc, TimeStep *tStep)

virtual void	drawRawGeometry (oofegGraphicContext &gc, TimeStep *tStep)

virtual void	drawDeformedGeometry (oofegGraphicContext &gc, TimeStep *tStep, UnknownType)

virtual void	drawScalar (oofegGraphicContext &gc, TimeStep *tStep)

virtual void	drawSpecial (oofegGraphicContext &gc, TimeStep *tStep)

virtual void	giveLocalIntVarMaxMin (oofegGraphicContext &gc, TimeStep *tStep, double &emin, double &emax)

virtual int	giveInternalStateAtNode (FloatArray &answer, InternalStateType type, InternalStateMode mode, int node, TimeStep *tStep)
	Returns internal state variable (like stress,strain) at node of element in Reduced form, the way how is obtained is dependent on InternalValueType. More...

virtual int	giveInternalStateAtSide (FloatArray &answer, InternalStateType type, InternalStateMode mode, int side, TimeStep *tStep)
	Returns internal state variable (like stress,strain) at side of element in Reduced form If side is possessing DOFs, otherwise recover techniques will not work due to absence of side-shape functions. More...

virtual void	showSparseMtrxStructure (CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep)
	Shows sparse structure. More...

virtual void	showExtendedSparseMtrxStructure (CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep)
	Shows extended sparse structure (for example, due to nonlocal interactions for tangent stiffness) More...

int	giveLabel () const

int	giveGlobalNumber () const

void	setGlobalNumber (int num)
	Sets receiver globally unique number. More...

elementParallelMode	giveParallelMode () const
	Return elementParallelMode of receiver. More...

void	setParallelMode (elementParallelMode _mode)
	Sets parallel mode of element. More...

virtual elementParallelMode	giveKnotSpanParallelMode (int) const
	Returns the parallel mode for particular knot span of the receiver. More...

int	packUnknowns (DataStream &buff, TimeStep *tStep)
	Pack all necessary data of element (according to its parallel_mode) integration points into given communication buffer. More...

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

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

const IntArray *	givePartitionList () const
	Returns partition list of receiver. More...

void	setPartitionList (IntArray &pl)
	Sets partition list of receiver. More...

virtual double	predictRelativeComputationalCost ()
	Returns the weight representing relative computational cost of receiver The reference element is triangular plane stress element with linear approximation, single integration point and linear isotropic material. More...

virtual double	giveRelativeSelfComputationalCost ()
	Returns the weight representing relative computational cost of receiver The reference element is triangular plane stress element. More...

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

IntArray *	giveBodyLoadArray ()
	Returns array containing load numbers of loads acting on element. More...

IntArray *	giveBoundaryLoadArray ()
	Returns array containing load numbers of boundary loads acting on element. 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...

void	giveLocationArray (IntArray &locationArray, const UnknownNumberingScheme &s, IntArray *dofIds=NULL) const
	Returns the location array (array of code numbers) of receiver for given numbering scheme. More...

void	giveLocationArray (IntArray &locationArray, const IntArray &dofIDMask, const UnknownNumberingScheme &s, IntArray *dofIds=NULL) const

virtual void	giveBoundaryLocationArray (IntArray &locationArray, const IntArray &bNodes, const UnknownNumberingScheme &s, IntArray *dofIds=NULL)
	Returns the location array for the boundary of the element. More...

virtual void	giveBoundaryLocationArray (IntArray &locationArray, const IntArray &bNodes, const IntArray &dofIDMask, const UnknownNumberingScheme &s, IntArray *dofIds=NULL)

virtual int	giveNumberOfDofs ()

virtual int	giveNumberOfInternalDofManagers () const

virtual DofManager *	giveInternalDofManager (int i) const
	Returns i-th internal element dof manager of the receiver. More...

virtual double	giveCharacteristicValue (CharType type, TimeStep *tStep)
	Computes characteristic value of receiver of requested type in given time step. More...

virtual void	computeLoadVector (FloatArray &answer, BodyLoad load, CharType type, ValueModeType mode, TimeStep tStep)
	Computes the contribution of the given body load (volumetric). More...

virtual void	computeBoundarySurfaceLoadVector (FloatArray &answer, BoundaryLoad load, int boundary, CharType type, ValueModeType mode, TimeStep tStep, bool global=true)
	Computes the contribution of the given load at the given boundary surface in global coordinate system. More...

virtual void	computeTangentFromSurfaceLoad (FloatMatrix &answer, SurfaceLoad load, int boundary, MatResponseMode rmode, TimeStep tStep)
	Computes the tangent contribution of the given load at the given boundary. More...

virtual void	computeTangentFromEdgeLoad (FloatMatrix &answer, EdgeLoad load, int boundary, MatResponseMode rmode, TimeStep tStep)
	Computes the tangent contribution of the given load at the given boundary. More...

virtual void	computeBoundaryEdgeLoadVector (FloatArray &answer, BoundaryLoad load, int edge, CharType type, ValueModeType mode, TimeStep tStep, bool global=true)
	Computes the contribution of the given load at the given boundary edge. More...

const IntArray &	giveBodyLoadList () const
	Returns receiver list of bodyloads. More...

const IntArray &	giveBoundaryLoadList () const
	Returns receiver list of boundary loads. More...

void	computeVectorOf (ValueModeType u, TimeStep *tStep, FloatArray &answer)
	Returns local vector of unknowns. More...

void	computeVectorOf (const IntArray &dofIDMask, ValueModeType u, TimeStep *tStep, FloatArray &answer, bool padding=false)

void	computeBoundaryVectorOf (const IntArray &bNodes, const IntArray &dofIDMask, ValueModeType u, TimeStep *tStep, FloatArray &answer, bool padding=false)
	Boundary version of computeVectorOf. More...

void	computeVectorOf (PrimaryField &field, const IntArray &dofIDMask, ValueModeType u, TimeStep *tStep, FloatArray &answer, bool padding=false)
	Returns local vector of unknowns. More...

void	computeVectorOfPrescribed (ValueModeType u, TimeStep *tStep, FloatArray &answer)
	Returns local vector of prescribed unknowns. More...

void	computeVectorOfPrescribed (const IntArray &dofIDMask, ValueModeType type, TimeStep *tStep, FloatArray &answer)
	Returns local vector of prescribed unknowns. More...

virtual int	computeNumberOfDofs ()
	Computes or simply returns total number of element's local DOFs. More...

virtual int	computeNumberOfGlobalDofs ()
	Computes the total number of element's global dofs. More...

int	computeNumberOfPrimaryMasterDofs ()
	Computes the total number of element's primary master DOFs. More...

virtual bool	computeGtoLRotationMatrix (FloatMatrix &answer)
	Returns transformation matrix from global c.s. More...

virtual bool	giveRotationMatrix (FloatMatrix &answer)
	Transformation matrices updates rotation matrix between element-local and primary DOFs, taking into account nodal c.s. More...

virtual bool	computeDofTransformationMatrix (FloatMatrix &answer, const IntArray &nodes, bool includeInternal)
	Returns transformation matrix for DOFs from global coordinate system to local coordinate system in nodes. More...

virtual void	giveDofManDofIDMask (int inode, IntArray &answer) const
	Returns dofmanager dof mask for node. More...

virtual void	giveInternalDofManDofIDMask (int inode, IntArray &answer) const
	Returns internal dofmanager dof mask for node. More...

virtual void	giveElementDofIDMask (IntArray &answer) const
	Returns element dof mask for node. More...

virtual void	computeField (ValueModeType mode, TimeStep *tStep, const FloatArray &lcoords, FloatArray &answer)
	Computes the unknown vector interpolated at the specified local coordinates. More...

virtual double	computeVolumeAround (GaussPoint *gp)
	Returns volume related to given integration point. More...

virtual double	computeVolumeAreaOrLength ()
	Computes the volume, area or length of the element depending on its spatial dimension. More...

double	computeMeanSize ()
	Computes the size of the element defined as its length. More...

virtual double	computeVolume ()
	Computes the volume. More...

virtual double	computeArea ()
	Computes the area (zero for all but 2d geometries). More...

virtual double	computeLength ()
	Computes the length (zero for all but 1D geometries) More...

virtual void	giveBoundaryEdgeNodes (IntArray &bNodes, int boundary)
	Returns list of receiver boundary nodes for given edge. More...

virtual void	giveBoundarySurfaceNodes (IntArray &bNodes, int boundary)
	Returns list of receiver boundary nodes for given surface. More...

virtual IntegrationRule *	giveBoundaryEdgeIntegrationRule (int order, int boundary)
	Returns boundary edge integration rule. More...

virtual IntegrationRule *	giveBoundarySurfaceIntegrationRule (int order, int boundary)
	Returns boundary surface integration rule. More...

int	giveDofManagerNumber (int i) const
	Translates local to global indices for dof managers. More...

const IntArray &	giveDofManArray () const

void	addDofManager (DofManager *dMan)

DofManager *	giveDofManager (int i) const

Node *	giveNode (int i) const
	Returns reference to the i-th node of element. More...

virtual ElementSide *	giveSide (int i) const
	Returns reference to the i-th side of element. More...

virtual FEInterpolation *	giveInterpolation (DofIDItem id) const
	Returns the interpolation for the specific dof id. More...

virtual Material *	giveMaterial ()

int	giveMaterialNumber () const

CrossSection *	giveCrossSection ()

void	setMaterial (int matIndx)
	Sets the material of receiver. More...

virtual void	setCrossSection (int csIndx)
	Sets the cross section model of receiver. More...

virtual int	giveNumberOfDofManagers () const

virtual int	giveNumberOfNodes () const
	Returns number of nodes of receiver. More...

void	setDofManagers (const IntArray &dmans)
	Sets receiver dofManagers. More...

void	setBodyLoads (const IntArray &bodyLoads)
	Sets receiver bodyLoadArray. More...

void	setIntegrationRules (std::vector< std::unique_ptr< IntegrationRule > > irlist)
	Sets integration rules. More...

virtual integrationDomain	giveIntegrationDomain () const
	Returns integration domain for receiver, used to initialize integration point over receiver volume. More...

virtual MaterialMode	giveMaterialMode ()
	Returns material mode for receiver integration points. More...

virtual int	giveIntegrationRuleLocalCodeNumbers (IntArray &answer, IntegrationRule &ie)
	Assembles the code numbers of given integration element (sub-patch) This is done by obtaining list of nonzero shape functions and by collecting the code numbers of nodes corresponding to these shape functions. More...

int	giveRegionNumber ()

virtual void	postInitialize ()
	Performs post initialization steps. More...

virtual void	initializeYourself (TimeStep *timeStepWhenICApply)
	Initialization according to state given by initial conditions. More...

virtual bool	isActivated (TimeStep *tStep)

virtual bool	isCast (TimeStep *tStep)

virtual void	initForNewStep ()
	Initializes receivers state to new time step. More...

virtual int	giveSpatialDimension ()
	Returns the element spatial dimension (1, 2, or 3). More...

virtual int	giveNumberOfBoundarySides ()

virtual int	giveDefaultIntegrationRule () const
	Returns id of default integration rule. More...

virtual IntegrationRule *	giveDefaultIntegrationRulePtr ()
	Access method for default integration rule. More...

int	giveNumberOfIntegrationRules ()

virtual IntegrationRule *	giveIntegrationRule (int i)

std::vector< std::unique_ptr< IntegrationRule > > &	giveIntegrationRulesArray ()

int	giveGlobalIPValue (FloatArray &answer, GaussPoint gp, InternalStateType type, TimeStep tStep)

virtual double	giveLengthInDir (const FloatArray &normalToCrackPlane)
	Default implementation returns length of element projection into specified direction. More...

virtual double	giveCharacteristicLength (const FloatArray &normalToCrackPlane)
	Returns the size of element in the given direction, in some cases adjusted (e.g. More...

double	giveCharacteristicLengthForPlaneElements (const FloatArray &normalToCrackPlane)
	Returns the size of element in the given direction if the direction is in the XY plane, otherwise gives the mean size defined as the square root of the element area. More...

double	giveCharacteristicLengthForAxisymmElements (const FloatArray &normalToCrackPlane)
	Returns the size of an axisymmetric element in the given direction if the direction is in the XY plane, otherwise gives the mean distance vrom the symmetry axis multiplied by pi. More...

virtual double	giveCharacteristicSize (GaussPoint *gp, FloatArray &normalToCrackPlane, ElementCharSizeMethod method)
	Returns characteristic element size for a given integration point and given direction. More...

virtual double	giveParentElSize () const
	Returns the size (length, area or volume depending on element type) of the parent element. More...

virtual void	updateBeforeNonlocalAverage (TimeStep *tStep)
	Updates internal element state (in all integration points of receiver) before nonlocal averaging takes place. More...

virtual bool	computeLocalCoordinates (FloatArray &answer, const FloatArray &gcoords)
	Computes the element local coordinates from given global coordinates. More...

virtual int	giveLocalCoordinateSystem (FloatMatrix &answer)
	Returns local coordinate system of receiver Required by material models with ortho- and anisotrophy. More...

virtual void	computeMidPlaneNormal (FloatArray &answer, const GaussPoint *gp)
	Computes mid-plane normal of receiver at integration point. More...

virtual int	adaptiveMap (Domain oldd, TimeStep tStep)
	Initializes the internal state variables stored in all IPs according to state in given domain. More...

virtual int	mapStateVariables (Domain &iOldDom, const TimeStep &iTStep)
	Maps the internal state variables stored in all IPs from the old domain to the new domain. More...

virtual int	adaptiveUpdate (TimeStep *tStep)
	Updates the internal state variables stored in all IPs according to already mapped state. More...

virtual int	adaptiveFinish (TimeStep *tStep)
	Finishes the mapping for given time step. More...

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

template<class T >
void	ipEvaluator (T src, void(T::f)(GaussPoint *gp))
	Integration point evaluator, loops over receiver IP's and calls given function (passed as f parameter) on them. The IP is parameter to function f. More...

template<class T , class S >
void	ipEvaluator (T src, void(T::f)(GaussPoint *, S &), S &_val)
	Integration point evaluator, loops over receiver IP's and calls given function (passed as f parameter) on them. The IP is parameter to function f as well as additional array. 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...

virtual const char *	giveInputRecordName () const =0

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	printYourself ()
	Prints receiver state on stdout. Useful for debugging. More...

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

Protected Member Functions
virtual void	computeNmatrixAt (GaussPoint *gp, FloatMatrix &answer)=0
	Computes modified interpolation matrix (N) for the element which multiplied with the unknowns vector (u) produces the spatial jump. More...

virtual void	computeTransformationMatrixAt (GaussPoint *gp, FloatMatrix &answer)=0

virtual int	giveNumberOfIPForMassMtrxIntegration ()
	Return desired number of integration points for consistent mass matrix computation, if required. More...

virtual int	testCrossSectionExtension (CrossSectExtension ext)

virtual int	testElementExtension (ElementExtension ext)
	Tests if the element implements required extension. More...

Protected Member Functions inherited from oofem::Element
virtual void	computeGaussPoints ()
	Initializes the array of integration rules member variable. More...

Protected Attributes
FloatArray	initialDisplacements
	Initial displacement vector, describes the initial nodal displacements when element has been casted. More...

FEInterpolation *	interpolation

int	nlGeometry
	Flag indicating if geometrical nonlinearities apply. More...

Protected Attributes inherited from oofem::Element
int	numberOfDofMans
	Number of dofmanagers. More...

IntArray	dofManArray
	Array containing dofmanager numbers. More...

int	material
	Number of associated material. More...

int	crossSection
	Number of associated cross section. More...

IntArray	bodyLoadArray
	Array containing indexes of loads (body loads and boundary loads are kept separately), that apply on receiver. More...

IntArray	boundaryLoadArray

std::vector< std::unique_ptr< IntegrationRule > >	integrationRulesArray
	List of integration rules of receiver (each integration rule contains associated integration points also). More...

FloatMatrix	elemLocalCS
	Transformation material matrix, used in orthotropic and anisotropic materials, global->local transformation. More...

int	activityTimeFunction
	Element activity time function. If defined, nonzero value indicates active receiver, zero value inactive element. More...

int	globalNumber
	In parallel mode, globalNumber contains globally unique DoFManager number. More...

int	numberOfGaussPoints
	Number of integration points as specified by nip. More...

elementParallelMode	parallel_mode
	Determines the parallel mode of the element. More...

IntArray	partitions
	List of partition sharing the shared element or remote partition containing remote element counterpart. 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...

Detailed Description

Abstract base class for all structural interface elements.

It declares a common interface available to all derived elements. The implementation of these services is partly left to the derived classes, some general services are implemented here (but they can be overload by more efficient element implementations). The general implementation provided here is intended for both linear and nonlinear computations.

Definition at line 64 of file structuralinterfaceelement.h.

Constructor & Destructor Documentation

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

Constructor.

Creates structural element with given number, belonging to given domain.

Parameters

n	Element number.
d	Domain to which new material will belong.

Definition at line 52 of file structuralinterfaceelement.C.

oofem::StructuralInterfaceElement::~StructuralInterfaceElement ( )

virtual

Destructor.

Definition at line 59 of file structuralinterfaceelement.C.

Member Function Documentation

int oofem::StructuralInterfaceElement::checkConsistency ( )

virtual

Performs consistency check.

This method is called at startup for all elements in particular domain. This method is intended to check data compatibility. Particular element types should test if compatible material and crossSection both with required capabilities are specified. Derived classes should provide their own analysis specific tests. Some printed input if incompatibility is found should be provided (error or warning member functions). Method can be also used to initialize some variables, since this is invoked after all domain components are instanciated.

Returns: Zero value if check fail, otherwise nonzero.

Reimplemented from oofem::Element.

Definition at line 283 of file structuralinterfaceelement.C.

References oofem::StructuralInterfaceCrossSection::checkConsistency(), giveClassName(), oofem::Element::giveCrossSection(), giveInterfaceCrossSection(), OOFEM_WARNING, and testCrossSectionExtension().

Referenced by giveInterface().

virtual double oofem::StructuralInterfaceElement::computeAreaAround ( GaussPoint * gp )

pure virtual

Implemented in oofem::IntElPoint, oofem::IntElLine1, oofem::IntElLine1PhF, oofem::IntElLine1PF, and oofem::IntElSurfTr1.

Referenced by computeStiffnessMatrix(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_dd(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_ud(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_uu(), giveClassName(), giveInternalForcesVector(), oofem::StructuralInterfaceElementPhF::giveInternalForcesVector_d(), and oofem::StructuralInterfaceElementPhF::giveInternalForcesVector_u().

int oofem::StructuralInterfaceElement::computeGlobalCoordinates	(	FloatArray &	answer,
		const FloatArray &	lcoords
	)

virtual

Computes the global coordinates from given element's local coordinates.

Parameters

answer	Requested global coordinates.
lcoords	Local coordinates.

Returns: Nonzero if successful, zero otherwise.

Reimplemented from oofem::Element.

Reimplemented in oofem::IntElPoint, oofem::IntElLine1IntPen, and oofem::IntElSurfTr1.

Definition at line 62 of file structuralinterfaceelement.C.

References oofem::FloatArray::add(), oofem::FloatArray::at(), oofem::FEInterpolation::evalN(), oofem::DofManager::giveCoordinates(), oofem::Element::giveDofManager(), giveInterpolation(), oofem::Element::giveNumberOfNodes(), N, oofem::FloatArray::resize(), and oofem::FloatArray::zero().

Referenced by oofem::IntElLine2::drawScalar(), and oofem::IntElLine1::drawScalar().

virtual void oofem::StructuralInterfaceElement::computeNmatrixAt	(	GaussPoint *	gp,
		FloatMatrix &	answer
	)

protectedpure virtual

Computes modified interpolation matrix (N) for the element which multiplied with the unknowns vector (u) produces the spatial jump.

Parameters

gp	Integration point for which answer is assembled.
answer	Interpolation matrix evaluated at gp.

Implemented in oofem::IntElLine1PF, oofem::IntElPoint, oofem::IntElLine1, oofem::IntElLine1IntPen, oofem::IntElLine1PhF, oofem::IntElSurfTr1, and oofem::IntElLine2.

Referenced by computeSpatialJump(), computeStiffnessMatrix(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_ud(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_uu(), giveInternalForcesVector(), oofem::StructuralInterfaceElementPhF::giveInternalForcesVector_u(), and giveStiffnessMatrix_dTdj().

void oofem::StructuralInterfaceElement::computeSpatialJump	(	FloatArray &	answer,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Definition at line 120 of file structuralinterfaceelement.C.

References oofem::FloatArray::beProductOf(), computeNmatrixAt(), oofem::Element::computeVectorOf(), oofem::FloatArray::giveSize(), initialDisplacements, oofem::Element::isActivated(), N, oofem::FloatArray::resize(), oofem::FloatArray::subtract(), and oofem::FloatArray::zero().

Referenced by giveInterpolation(), updateInternalState(), and oofem::StructuralInterfaceElementPhF::updateInternalState().

void oofem::StructuralInterfaceElement::computeStiffnessMatrix	(	FloatMatrix &	answer,
		MatResponseMode	rMode,
		TimeStep *	tStep
	)

virtual

Computes the stiffness/tangent matrix of receiver.

Default implementation computes element stiffness using $K=\int_{\Gamma} N^{\mathrm{T}} D N \mathrm{d}V$ formulae, where $ N $ is the element geometric matrix such that $ j = N a $ and $ D $ is the stiffness matrix of the interface material. Numerical integration procedure uses integrationRulesArray for numerical integration.

The geometrical matrix is obtained using computeNmatrixAt service and the constitutive matrix is obtained using computeConstitutiveMatrixAt service.

For higher numerical performance, only one half of stiffness matrix is computed and answer is then symmetrized. Therefore, if element matrix will be generally nonsymmetric, one must specialize this method. Finally, the result is transformed into global coordinate system (or nodal coordinate system, if it is defined).

Parameters

answer	Computed stiffness matrix (symmetric).
rMode	Response mode.
tStep	Time step.

Reimplemented in oofem::IntElLine1PF, oofem::StructuralInterfaceElementPhF, oofem::IntElLine2IntPen, and oofem::IntElLine1IntPen.

Definition at line 81 of file structuralinterfaceelement.C.

References oofem::FloatMatrix::beProductOf(), oofem::FloatMatrix::clear(), computeAreaAround(), computeNmatrixAt(), computeTransformationMatrixAt(), oofem::Element::giveCrossSection(), oofem::Element::giveDefaultIntegrationRulePtr(), giveStiffnessMatrix_dTdj(), giveStiffnessMatrix_Eng(), oofem::CrossSection::isCharacteristicMtrxSymmetric(), N, nlGeometry, OOFEM_ERROR, oofem::FloatMatrix::plusProductSymmUpper(), oofem::FloatMatrix::plusProductUnsym(), oofem::FloatMatrix::rotatedWith(), and oofem::FloatMatrix::symmetrized().

Referenced by giveCharacteristicMatrix(), and giveInterpolation().

void oofem::StructuralInterfaceElement::computeTraction	(	FloatArray &	traction,
		IntegrationPoint *	ip,
		const FloatArray &	jump,
		TimeStep *	tStep
	)

virtual

virtual void oofem::StructuralInterfaceElement::computeTransformationMatrixAt	(	GaussPoint *	gp,
		FloatMatrix &	answer
	)

protectedpure virtual

Implemented in oofem::IntElPoint, oofem::IntElLine1, oofem::IntElLine1PhF, oofem::IntElLine1PF, and oofem::IntElSurfTr1.

Referenced by computeStiffnessMatrix(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_uu(), computeTraction(), oofem::StructuralInterfaceElementPhF::computeTraction(), and giveStiffnessMatrix_dTdj().

void oofem::StructuralInterfaceElement::giveCharacteristicMatrix	(	FloatMatrix &	answer,
		CharType	type,
		TimeStep *	tStep
	)

virtual

Computes characteristic matrix of receiver of requested type in given time step.

Parameters

answer	Requested characteristic matrix (stiffness, tangent, ...). If element has no capability to compute requested type of characteristic matrix error function is invoked.
type	Id of characteristic component requested.
tStep	Time step when answer is computed.

Reimplemented from oofem::Element.

Definition at line 217 of file structuralinterfaceelement.C.

References oofem::__CharTypeToString(), computeStiffnessMatrix(), and OOFEM_ERROR.

void oofem::StructuralInterfaceElement::giveCharacteristicVector	(	FloatArray &	answer,
		CharType	type,
		ValueModeType	mode,
		TimeStep *	tStep
	)

virtual

Computes characteristic vector of receiver of requested type in given time step.

If element has no capability to compute requested type of characteristic vector error function is invoked.

Parameters

answer	Requested characteristic vector.
type	Id of characteristic component requested.
mode	Determines mode of answer.
tStep	Time step when answer is computed.

Reimplemented from oofem::Element.

Definition at line 235 of file structuralinterfaceelement.C.

References oofem::__CharTypeToString(), oofem::FloatArray::clear(), giveInternalForcesVector(), and OOFEM_ERROR.

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

inlinevirtual

Returns: Class name of the receiver.

Reimplemented from oofem::Element.

Reimplemented in oofem::StructuralInterfaceElementPhF, oofem::IntElLine1, oofem::IntElLine1PF, oofem::IntElLine1PhF, oofem::IntElLine2, oofem::IntElLine2IntPen, and oofem::IntElLine1IntPen.

Definition at line 137 of file structuralinterfaceelement.h.

References computeAreaAround(), and giveInterfaceCrossSection().

Referenced by checkConsistency().

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

virtual

Todo:: Should probably convert to 2nd PK traction to be consistent with continuum elements.

Todo:: compute F properly

Reimplemented in oofem::IntElPoint, oofem::IntElLine1, oofem::IntElLine1PF, and oofem::IntElSurfTr1.

Definition at line 320 of file structuralinterfaceelement.C.

References oofem::FloatMatrix::beUnitMatrix(), and giveFirstPKTraction().

Referenced by computeTraction(), and giveGeometryType().

virtual void oofem::StructuralInterfaceElement::giveFirstPKTraction	(	FloatArray &	answer,
		GaussPoint *	gp,
		const FloatArray &	jump,
		const FloatMatrix &	F,
		TimeStep *	tStep
	)

inlinevirtual

Definition at line 146 of file structuralinterfaceelement.h.

References giveStiffnessMatrix_Eng(), and OOFEM_ERROR.

Referenced by computeTraction(), and giveEngTraction().

virtual Element_Geometry_Type oofem::StructuralInterfaceElement::giveGeometryType ( ) const

inlinevirtual

Returns the element geometry type.

This information is assumed to be of general interest, but it is required only for some specialized tasks.

Returns: Geometry type of element.

Reimplemented from oofem::Element.

Reimplemented in oofem::IntElLine1PF, oofem::IntElLine1, oofem::IntElLine1IntPen, oofem::IntElLine1PhF, oofem::IntElPoint, oofem::IntElSurfTr1, and oofem::IntElLine2.

Definition at line 142 of file structuralinterfaceelement.h.

References giveEngTraction().

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

virtual

Setups the input record string of receiver.

Parameters

input Dynamic input record to be filled by receiver.

Reimplemented from oofem::Element.

Definition at line 307 of file structuralinterfaceelement.C.

References oofem::Element::giveInputRecord().

Referenced by giveInterface().

virtual Interface* oofem::StructuralInterfaceElement::giveInterface ( InterfaceType t )

inlinevirtual

Interface requesting service.

See also: InterfaceType

Returns: Requested interface if implemented, otherwise NULL.

Reimplemented from oofem::FEMComponent.

Definition at line 127 of file structuralinterfaceelement.h.

References checkConsistency(), giveInputRecord(), initializeFrom(), updateInternalState(), and updateYourself().

StructuralInterfaceCrossSection * oofem::StructuralInterfaceElement::giveInterfaceCrossSection ( )

Definition at line 313 of file structuralinterfaceelement.C.

References oofem::Element::giveCrossSection().

Referenced by checkConsistency(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_dd(), giveClassName(), oofem::IntElSurfTr1::giveEngTraction(), oofem::IntElLine1PhF::giveEngTraction(), oofem::IntElLine1PF::giveEngTraction(), oofem::IntElLine1::giveEngTraction(), oofem::IntElPoint::giveEngTraction(), oofem::StructuralInterfaceElementPhF::giveInternalForcesVector_d(), oofem::IntElSurfTr1::giveStiffnessMatrix_Eng(), oofem::IntElLine1PhF::giveStiffnessMatrix_Eng(), oofem::IntElLine1PF::giveStiffnessMatrix_Eng(), oofem::IntElLine1::giveStiffnessMatrix_Eng(), and oofem::IntElPoint::giveStiffnessMatrix_Eng().

void oofem::StructuralInterfaceElement::giveInternalForcesVector	(	FloatArray &	answer,
		TimeStep *	tStep,
		int	useUpdatedGpRecord = `0`
	)

virtual

Returns equivalent nodal forces vectors.

Useful for nonlinear analysis. Default implementation computes result as $F=\int_v B^{\mathrm{T}} \sigma \mathrm{d}V$ , where $\sigma$ is the real element stress vector obtained using computeStressVector service (if useUpdatedGpRecord=0) or (if useUpdatedGpRecord=1) from integration point status. The geometric matrix is obtained using computeBmatrixAt service. Integration is performed using default integration rule, which should produce always valid results, assuming that strains used for computation of stresses are valid.

Parameters

answer	Internal nodal forces vector.
tStep	Time step.
useUpdatedGpRecord	If equal to zero, the stresses in integration points are computed (slow but safe), else if nonzero the stresses are taken directly from integration point status (should be derived from StructuralMaterialStatus) (fast, but engineering model must ensure valid status data in each integration point).

Reimplemented in oofem::StructuralInterfaceElementPhF, oofem::IntElLine1PF, oofem::IntElLine2IntPen, and oofem::IntElLine1IntPen.

Definition at line 146 of file structuralinterfaceelement.C.

References oofem::FloatArray::beProductOf(), oofem::FloatArray::clear(), computeAreaAround(), computeNmatrixAt(), computeTraction(), oofem::Element::computeVectorOf(), oofem::Element::giveDefaultIntegrationRulePtr(), oofem::FloatArray::giveSize(), initialDisplacements, N, oofem::FloatArray::plusProduct(), and oofem::FloatArray::subtract().

Referenced by giveCharacteristicVector(), and giveInterpolation().

virtual FEInterpolation* oofem::StructuralInterfaceElement::giveInterpolation ( ) const

inlinevirtual

Returns: Interpolation of the element geometry, or NULL if none exist.

Reimplemented from oofem::Element.

Reimplemented in oofem::IntElLine1, oofem::IntElLine1PhF, oofem::IntElLine2, and oofem::IntElLine1PF.

Definition at line 88 of file structuralinterfaceelement.h.

References computeSpatialJump(), computeStiffnessMatrix(), computeTraction(), giveInternalForcesVector(), giveIPValue(), and interpolation.

Referenced by oofem::StructuralInterfaceElementPhF::computeBd_matrixAt(), oofem::IntElLine1PF::computeDamageAt(), oofem::StructuralInterfaceElementPhF::computeDamageAt(), computeGlobalCoordinates(), oofem::StructuralInterfaceElementPhF::computeNd_matrixAt(), oofem::IntElLine1PF::computeNd_vectorAt(), and oofem::StructuralInterfaceElementPhF::giveInternalForcesVector_d().

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

virtual

Returns the integration point corresponding value in full form.

Parameters

answer	Contain corresponding integration point value, zero sized if not available.
gp	Integration point to check.
type	Determines the type of internal variable.
tStep	Time step.

Returns: Nonzero if o.k, zero otherwise.

Todo:: Which "error type" should be used? Why are there several? I don't see the point of this enum when there could be different function calls just as well (and different IST values)

Reimplemented from oofem::Element.

Definition at line 295 of file structuralinterfaceelement.C.

References oofem::Element::giveIPValue().

Referenced by oofem::IntElLine2::drawScalar(), oofem::IntElLine1::drawScalar(), oofem::IntElPoint::drawScalar(), and giveInterpolation().

virtual int oofem::StructuralInterfaceElement::giveNumberOfIPForMassMtrxIntegration ( )

inlineprotectedvirtual

Return desired number of integration points for consistent mass matrix computation, if required.

Returns: Number of integration points for mass matrix.

Todo:: not sure if we should allow these elements to have mass - JB

Definition at line 175 of file structuralinterfaceelement.h.

virtual void oofem::StructuralInterfaceElement::giveStiffnessMatrix_dTdj	(	FloatMatrix &	answer,
		MatResponseMode	rMode,
		IntegrationPoint *	ip,
		TimeStep *	tStep
	)

inlinevirtual

Definition at line 152 of file structuralinterfaceelement.h.

References computeNmatrixAt(), computeTransformationMatrixAt(), and OOFEM_ERROR.

Referenced by oofem::IntElLine1IntPen::computeStiffnessMatrix(), oofem::IntElLine2IntPen::computeStiffnessMatrix(), computeStiffnessMatrix(), oofem::IntElLine1PF::computeStiffnessMatrix_uu(), and giveStiffnessMatrix_Eng().

void oofem::StructuralInterfaceElement::giveStiffnessMatrix_Eng	(	FloatMatrix &	answer,
		MatResponseMode	rMode,
		IntegrationPoint *	ip,
		TimeStep *	tStep
	)

virtual

Todo:: dT1dj = d(F*T2)/dj = dF/dj*T2 + F*dT2/dj - should we assume dFdj = 0? Otherwise it will be very complex!

Reimplemented in oofem::IntElPoint, oofem::IntElLine1, oofem::IntElLine1PF, oofem::IntElLine1PhF, and oofem::IntElSurfTr1.

Definition at line 333 of file structuralinterfaceelement.C.

References giveStiffnessMatrix_dTdj().

Referenced by computeStiffnessMatrix(), oofem::StructuralInterfaceElementPhF::computeStiffnessMatrix_uu(), and giveFirstPKTraction().

IRResultType oofem::StructuralInterfaceElement::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::Element.

Reimplemented in oofem::IntElLine1, oofem::IntElPoint, oofem::IntElSurfTr1, oofem::IntElLine1PF, oofem::IntElLine1PhF, oofem::IntElLine2, and oofem::IntElLine2IntPen.

Definition at line 302 of file structuralinterfaceelement.C.

References oofem::Element::initializeFrom().

Referenced by giveInterface(), oofem::IntElLine2IntPen::initializeFrom(), oofem::IntElLine1PhF::initializeFrom(), oofem::IntElLine1PF::initializeFrom(), oofem::IntElSurfTr1::initializeFrom(), oofem::IntElPoint::initializeFrom(), and oofem::IntElLine1::initializeFrom().

virtual int oofem::StructuralInterfaceElement::testCrossSectionExtension ( CrossSectExtension ext )

inlineprotectedvirtual

Definition at line 177 of file structuralinterfaceelement.h.

References oofem::CS_StructuralInterfaceCapability.

Referenced by checkConsistency().

virtual int oofem::StructuralInterfaceElement::testElementExtension ( ElementExtension ext )

inlineprotectedvirtual

Tests if the element implements required extension.

ElementExtension type defines the list of all available element extensions.

Parameters

ext	Extension to be tested.

Returns: Nonzero if extension supported.

See also: ElementExtension

Reimplemented from oofem::Element.

Reimplemented in oofem::IntElLine1, oofem::IntElLine1PhF, and oofem::IntElLine1PF.

Definition at line 178 of file structuralinterfaceelement.h.

void oofem::StructuralInterfaceElement::updateInternalState ( TimeStep * tStep )

virtual

Updates element state after equilibrium in time step has been reached.

Default implementation updates all integration rules defined by integrationRulesArray member variable. Doing this, all integration points and their material statuses are updated also. All temporary history variables, which now describe equilibrium state are copied into equilibrium ones. The existing internal state is used for update.

Parameters

tStep Time step for newly reached state.

See also: Material::updateYourself; IntegrationRule::updateYourself; GaussPoint::updateYourself; Element::updateInternalState

Reimplemented from oofem::Element.

Reimplemented in oofem::StructuralInterfaceElementPhF.

Definition at line 268 of file structuralinterfaceelement.C.

References computeSpatialJump(), computeTraction(), and oofem::Element::integrationRulesArray.

Referenced by giveInterface().

void oofem::StructuralInterfaceElement::updateYourself ( TimeStep * tStep )

virtual

Updates element state after equilibrium in time step has been reached.

Default implementation updates all integration rules defined by integrationRulesArray member variable. Doing this, all integration points and their material statuses are updated also. All temporary history variables, which now describe equilibrium state are copied into equilibrium ones. The existing internal state is used for update.

Parameters

tStep Time step for newly reached state.