Base class 3D elements. More...

#include <structural3delement.h>

Inheritance diagram for oofem::Structural3DElement:

Collaboration diagram for oofem::Structural3DElement:

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

virtual	~Structural3DElement ()
	Destructor. More...

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

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

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

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

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

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

void	giveMaterialOrientationAt (FloatArray &x, FloatArray &y, FloatArray &z, const FloatArray &lcoords)

virtual void	computeStressVector (FloatArray &answer, const FloatArray &strain, GaussPoint gp, TimeStep tStep)
	Computes the stress vector of receiver at given integration point, at time step tStep. More...

virtual void	computeConstitutiveMatrixAt (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep)
	Computes constitutive matrix of receiver. More...

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

virtual	~NLStructuralElement ()
	Destructor. More...

int	giveGeometryMode ()
	Returns the geometry mode describing the formulation used in the internal work 0 - Engineering (small deformation) stress-strain mode 1 - First Piola-Kirchhoff - Deformation gradient mode, P is defined as FS 2 - Second Piola-Kirchhoff - Green-Lagrange strain mode with deformation gradient as input (deprecated and not supported) More...

void	computeFirstPKStressVector (FloatArray &answer, GaussPoint gp, TimeStep tStep)
	Computes the first Piola-Kirchhoff stress tensor on Voigt format. More...

void	computeCauchyStressVector (FloatArray &answer, GaussPoint gp, TimeStep tStep)
	Computes the Cauchy stress tensor on Voigt format. More...

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

virtual void	computeInitialStressMatrix (FloatMatrix &answer, TimeStep *tStep)
	Computes the initial stiffness matrix of receiver. More...

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

virtual void	giveInternalForcesVector (FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord=0)
	Evaluates nodal representation of real internal forces. More...

void	giveInternalForcesVector_withIRulesAsSubcells (FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord=0)
	Evaluates nodal representation of real internal forces. More...

virtual void	computeDeformationGradientVector (FloatArray &answer, GaussPoint gp, TimeStep tStep)
	Computes the deformation gradient in Voigt form at integration point ip and at time step tStep. More...

double	computeCurrentVolume (TimeStep *tStep)
	Computes the current volume of element. More...

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

virtual const char *	giveClassName () const

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

virtual	~StructuralElement ()
	Destructor. 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 void	computeMassMatrix (FloatMatrix &answer, TimeStep *tStep)
	Computes mass matrix of receiver. More...

virtual void	computeLumpedMassMatrix (FloatMatrix &answer, TimeStep *tStep)
	Computes lumped mass matrix of receiver. More...

virtual void	computeConsistentMassMatrix (FloatMatrix &answer, TimeStep tStep, double &mass, const double ipDensity=NULL)
	Computes consistent mass matrix of receiver using numerical integration over element volume. More...

virtual void	giveMassMtrxIntegrationgMask (IntArray &answer)
	Returns mask indicating, which unknowns (their type and ordering is the same as element unknown vector) participate in mass matrix integration. More...

void	computeStiffnessMatrix_withIRulesAsSubcells (FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep)

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

virtual void	computeStrainVector (FloatArray &answer, GaussPoint gp, TimeStep tStep)
	Compute strain vector of receiver evaluated at given integration point at given time step from element displacement vector. More...

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

virtual void	computeResultingIPTemperatureAt (FloatArray &answer, TimeStep tStep, GaussPoint gp, ValueModeType mode)
	Computes at given time (tStep) the the resulting temperature component array. More...

virtual void	computeResultingIPEigenstrainAt (FloatArray &answer, TimeStep tStep, GaussPoint gp, ValueModeType mode)
	Computes at given time the resulting eigenstrain component array. More...

virtual int	adaptiveUpdate (TimeStep *tStep)
	Updates the internal state variables stored in all IPs according to already mapped state. 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	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 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...

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	computeBoundaryEdgeLoadVector (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 edge. More...

virtual void	computeEdgeNMatrix (FloatMatrix &answer, int boundaryID, const FloatArray &lcoords)
	computes edge interpolation matrix More...

virtual void	computeSurfaceNMatrix (FloatMatrix &answer, int boundaryID, const FloatArray &lcoords)
	Computes surface interpolation matrix. More...

StructuralCrossSection *	giveStructuralCrossSection ()
	Helper function which returns the structural cross-section for the element. More...

virtual void	createMaterialStatus ()

virtual void	computeNmatrixAt (const FloatArray &iLocCoord, FloatMatrix &answer)
	Computes interpolation matrix for element unknowns. More...

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

virtual void	giveNonlocalLocationArray (IntArray &locationArray, const UnknownNumberingScheme &us)
	Returns the "nonlocal" location array of receiver. More...

virtual void	addNonlocalStiffnessContributions (SparseMtrx &dest, const UnknownNumberingScheme &s, TimeStep *tStep)
	Adds the "nonlocal" contribution to stiffness matrix, to account for nonlocality of material model. More...

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

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

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	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	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 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 () const

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 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 Element_Geometry_Type	giveGeometryType () const
	Returns the element geometry type. 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...

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 int	computeGlobalCoordinates (FloatArray &answer, const FloatArray &lcoords)
	Computes the global coordinates from given element's local coordinates. 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	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...

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 Member Functions
virtual void	computeBmatrixAt (GaussPoint *gp, FloatMatrix &answer, int lowerIndx=1, int upperIndx=ALL_STRAINS)
	Computes the geometrical matrix of receiver in given integration point. More...

virtual void	computeBHmatrixAt (GaussPoint *gp, FloatMatrix &answer)
	Computes a matrix which, multiplied by the column matrix of nodal displacements, gives the displacement gradient stored by columns. More...

virtual void	computeGaussPoints ()
	Initializes the array of integration rules member variable. More...

virtual void	giveEdgeDofMapping (IntArray &answer, int iEdge) const
	Assembles edge dof mapping mask, which provides mapping between edge local DOFs and "global" element DOFs. More...

virtual double	computeEdgeVolumeAround (GaussPoint *gp, int iEdge)
	Computes volume related to integration point on local edge. More...

virtual int	computeLoadLEToLRotationMatrix (FloatMatrix &answer, int iEdge, GaussPoint *gp)
	Returns transformation matrix from local edge c.s to element local coordinate system of load vector components. More...

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

virtual void	computeSurfaceNMatrixAt (FloatMatrix &answer, int iSurf, GaussPoint *gp)

virtual void	giveSurfaceDofMapping (IntArray &answer, int) const
	Assembles surface dof mapping mask, which provides mapping between surface local DOFs and "global" element DOFs. More...

virtual double	computeSurfaceVolumeAround (GaussPoint *gp, int)
	Computes volume related to integration point on local surface. More...

virtual int	computeLoadLSToLRotationMatrix (FloatMatrix &answer, int, GaussPoint *gp)
	Returns transformation matrix from local surface c.s to element local coordinate system of load vector components. More...

Protected Member Functions inherited from oofem::NLStructuralElement
virtual int	checkConsistency ()
	Performs consistency check. More...

Protected Member Functions inherited from oofem::StructuralElement
virtual void	computeBodyLoadVectorAt (FloatArray &answer, Load load, TimeStep tStep, ValueModeType mode)
	Computes the load vector due to body load acting on receiver, at given time step. More...

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

void	condense (FloatMatrix stiff, FloatMatrix mass, FloatArray load, IntArray what)
	General service for condensation of stiffness and optionally load vector and mass or initial stress matrices of receiver. More...

virtual void	setupIRForMassMtrxIntegration (IntegrationRule &iRule)
	Setup Integration Rule Gauss Points for Mass Matrix integration. More...

virtual void	computePointLoadVectorAt (FloatArray &answer, Load load, TimeStep tStep, ValueModeType mode, bool global=true)
	Computes point load vector contribution of receiver for given load (should has BoundaryLoad Base). More...

virtual IntegrationRule *	GetSurfaceIntegrationRule (int order)

virtual int	computeLoadGToLRotationMtrx (FloatMatrix &answer)
	Returns transformation matrix from global coordinate system to local element coordinate system for element load vector components. More...

Protected Attributes
bool	matRotation

Protected Attributes inherited from oofem::NLStructuralElement
int	nlGeometry
	Flag indicating if geometrical nonlinearities apply. More...

Protected Attributes inherited from oofem::StructuralElement
std::unique_ptr< FloatArray >	initialDisplacements
	Initial displacement vector, describes the initial nodal displacements when element has been casted. 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...

Private Member Functions
double	dnx (int i, int arg2)

Detailed Description

Base class 3D elements.

Author: Jim Brouzoulis; Mikael Öhman

Definition at line 55 of file structural3delement.h.

Constructor & Destructor Documentation

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

Constructor.

Creates element with given number, belonging to given domain.

Parameters

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

Definition at line 43 of file structural3delement.C.

virtual oofem::Structural3DElement::~Structural3DElement ( )

inlinevirtual

Destructor.

Definition at line 68 of file structural3delement.h.

References ALL_STRAINS, computeBHmatrixAt(), computeBmatrixAt(), computeConstitutiveMatrixAt(), computeEdgeVolumeAround(), computeGaussPoints(), computeLoadLEToLRotationMatrix(), computeNumberOfDofs(), computeStressVector(), computeVolumeAround(), giveCharacteristicLength(), giveDofManDofIDMask(), giveEdgeDofMapping(), giveMaterialMode(), giveMaterialOrientationAt(), and initializeFrom().

Member Function Documentation

void oofem::Structural3DElement::computeBHmatrixAt	(	GaussPoint *	gp,
		FloatMatrix &	answer
	)

protectedvirtual

Computes a matrix which, multiplied by the column matrix of nodal displacements, gives the displacement gradient stored by columns.

The components of this matrix are derivatives of the shape functions, but they are arranged in a somewhat different way from the usual B matrix.

Parameters

gp	Integration point.
answer	BF matrix at this point.

Reimplemented from oofem::NLStructuralElement.

Reimplemented in oofem::SolidShell.

Definition at line 85 of file structural3delement.C.

References oofem::FloatMatrix::at(), oofem::FEInterpolation::evaldNdx(), oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), oofem::FloatMatrix::giveNumberOfRows(), oofem::FloatMatrix::resize(), and oofem::FloatMatrix::zero().

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::computeBmatrixAt	(	GaussPoint *	gp,
		FloatMatrix &	answer,
		int	lowerIndx = `1`,
		int	upperIndx = `ALL_STRAINS`
	)

protectedvirtual

Computes the geometrical matrix of receiver in given integration point.

The product of this matrix (assembled at given integration point) and element displacement vector is element strain vector. If lowerIndx and upperIndx parameters are specified, answer is formed only for strains within this interval. This will affects the size of answer.

Parameters

gp	Integration point for which answer is computed.
answer	Geometric matrix of receiver.
lowerIndx	If specified, answer is formed only for strain with index equal and greater than lowerIndx. This parameter has default value 1 (answer is formed from first strain).
upperIndx	If specified, answer is formed only for strain with index less and equal than upperIndx. This parameter has default value ALL_STRAINS (answer is formed for all strains).

Implements oofem::StructuralElement.

Reimplemented in oofem::SolidShell, and oofem::LSpaceBB.

Definition at line 59 of file structural3delement.C.

References oofem::FloatMatrix::at(), oofem::FEInterpolation::evaldNdx(), oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), oofem::FloatMatrix::giveNumberOfRows(), oofem::FloatMatrix::resize(), and oofem::FloatMatrix::zero().

Referenced by ~Structural3DElement().

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

virtual

Computes constitutive matrix of receiver.

Default implementation uses element cross section giveCharMaterialStiffnessMatrix service.

Parameters

answer	Constitutive matrix.
rMode	Material response mode of answer.
gp	Integration point for which constitutive matrix is computed.
tStep	Time step.

Implements oofem::StructuralElement.

Definition at line 174 of file structural3delement.C.

References giveMaterialOrientationAt(), oofem::GaussPoint::giveNaturalCoordinates(), oofem::StructuralCrossSection::giveStiffnessMatrix_3d(), oofem::StructuralElement::giveStructuralCrossSection(), matRotation, and oofem::FloatMatrix::rotatedWith().

Referenced by oofem::SolidShell::computeStiffnessMatrix(), and ~Structural3DElement().

double oofem::Structural3DElement::computeEdgeVolumeAround	(	GaussPoint *	gp,
		int	iEdge
	)

protectedvirtual

Computes volume related to integration point on local edge.

Parameters

gp	edge integration point
iEdge	edge number

Reimplemented from oofem::StructuralElement.

Definition at line 335 of file structural3delement.C.

References oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), and oofem::GaussPoint::giveWeight().

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::computeGaussPoints ( )

protectedvirtual

Initializes the array of integration rules member variable.

Element can have multiple integration rules for different tasks. For example structural element family class uses this feature to implement transparent support for reduced and selective integration of some strain components. Must be defined by terminator classes.

See also: IntegrationRule

Reimplemented from oofem::Element.

Reimplemented in oofem::QSpaceGrad, oofem::SolidShell, oofem::QTRSpaceGrad, and oofem::QWedgeGrad.

Definition at line 213 of file structural3delement.C.

References oofem::Element::giveCrossSection(), oofem::Element::integrationRulesArray, oofem::Element::numberOfGaussPoints, and oofem::CrossSection::setupIntegrationPoints().

Referenced by ~Structural3DElement().

int oofem::Structural3DElement::computeLoadLEToLRotationMatrix	(	FloatMatrix &	answer,
		int	iEdge,
		GaussPoint *	gp
	)

protectedvirtual

Returns transformation matrix from local edge c.s to element local coordinate system of load vector components.

Necessary, because integration must be done in local coordinate system of entity (edge or surface). If no transformation is necessary, answer is empty matrix (default);

Parameters

answer	Computed rotation matrix.
iEdge	Edge number.
gp	Integration point (point, where transformation is computed, useful for curved edges).

Returns: Nonzero if transformation matrix is not empty matrix, zero otherwise.

Todo:: how should this be supported

Reimplemented from oofem::StructuralElement.

Definition at line 348 of file structural3delement.C.

References OOFEM_ERROR.

Referenced by ~Structural3DElement().

int oofem::Structural3DElement::computeLoadLSToLRotationMatrix	(	FloatMatrix &	answer,
		int	iSurf,
		GaussPoint *	gp
	)

protectedvirtual

Returns transformation matrix from local surface c.s to element local coordinate system of load vector components.

Necessary, because integration must be done in local coordinate system of entity (edge or surface). If no transformation is necessary, answer is empty matrix (default);

Parameters

answer	Computed rotation matrix.
iSurf	Surface number.
gp	Integration point (point, where transformation is computed, useful for curved surfaces)

Returns: Nonzero if transformation matrix is not empty matrix, zero otherwise.

Reimplemented from oofem::StructuralElement.

Reimplemented in oofem::LSpace, oofem::QSpace, and oofem::Q27Space.

Definition at line 301 of file structural3delement.C.

References OOFEM_ERROR.

Referenced by testElementExtension().

int oofem::Structural3DElement::computeNumberOfDofs ( )

virtual

Computes or simply returns total number of element's local DOFs.

Must be defined by particular element.

Returns: Number of local DOFs of element.

Todo:: move one hiearchy up and generalize

Reimplemented from oofem::Element.

Reimplemented in oofem::QSpaceGrad, oofem::QTRSpaceGrad, and oofem::QWedgeGrad.

Definition at line 204 of file structural3delement.C.

References giveDofManDofIDMask(), oofem::Element::giveInterpolation(), oofem::FEInterpolation::giveNumberOfNodes(), and oofem::IntArray::giveSize().

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::computeStressVector	(	FloatArray &	answer,
		const FloatArray &	strain,
		GaussPoint *	gp,
		TimeStep *	tStep
	)

virtual

Computes the stress vector of receiver at given integration point, at time step tStep.

The nature of these stresses depends on the element's type.

Parameters

answer	Stress vector.
strain	Strain vector.
gp	Integration point.
tStep	Time step.

Todo:: This won't work properly with "useUpdatedGpRecord" (!)

Implements oofem::StructuralElement.

Definition at line 142 of file structural3delement.C.

References giveMaterialOrientationAt(), oofem::GaussPoint::giveNaturalCoordinates(), oofem::StructuralCrossSection::giveRealStress_3d(), oofem::StructuralElement::giveStructuralCrossSection(), and matRotation.

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::computeSurfaceNMatrixAt	(	FloatMatrix &	answer,
		int	iSurf,
		GaussPoint *	gp
	)

protectedvirtual

Definition at line 253 of file structural3delement.C.

References oofem::FloatMatrix::beNMatrixOf(), oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), and N.

Referenced by testElementExtension().

double oofem::Structural3DElement::computeSurfaceVolumeAround	(	GaussPoint *	gp,
		int	iSurf
	)

protectedvirtual

Computes volume related to integration point on local surface.

Parameters

gp	Surface integration point.
iSurf	Surface number.

Reimplemented from oofem::StructuralElement.

Definition at line 286 of file structural3delement.C.

References oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), and oofem::GaussPoint::giveWeight().

Referenced by testElementExtension().

double oofem::Structural3DElement::computeVolumeAround ( GaussPoint * gp )

virtual

Returns volume related to given integration point.

Used typically in subroutines, that perform integration over element volume. Should be implemented by particular elements.

See also: GaussPoint

Parameters

gp	Integration point for which volume is computed.

Returns: Volume for integration point.

Reimplemented from oofem::Element.

Definition at line 226 of file structural3delement.C.

References oofem::Element::giveInterpolation(), oofem::GaussPoint::giveNaturalCoordinates(), and oofem::GaussPoint::giveWeight().

Referenced by oofem::LTRSpace::computeLumpedMassMatrix(), oofem::SolidShell::computeStiffnessMatrix(), oofem::LTRSpace::drawSpecial(), oofem::LSpace::drawSpecial(), oofem::SolidShell::giveInternalForcesVector(), and ~Structural3DElement().

double oofem::Structural3DElement::dnx	(	int	i,
		int	arg2
	)

private

Referenced by oofem::QTRSpaceGrad::computeBkappaMatrixAt(), oofem::QWedgeGrad::computeBkappaMatrixAt(), oofem::QSpaceGrad::computeBkappaMatrixAt(), oofem::LSpaceBB::computeBmatrixAt(), and testElementExtension().

double oofem::Structural3DElement::giveCharacteristicLength ( const FloatArray & normalToCrackPlane )

virtual

Returns the size of element in the given direction, in some cases adjusted (e.g.

if the direction is perpendicular to a planar element). Required by material models relying on the crack-band approach to achieve objectivity with respect to the mesh size.

Parameters

normalToCrackPlane Normal to the expected crack band.

Returns: Element size corresponding to the given direction (expected width of the crack band).

Reimplemented from oofem::Element.

Definition at line 242 of file structural3delement.C.

References oofem::Element::giveLengthInDir().

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::giveDofManDofIDMask	(	int	inode,
		IntArray &	answer
	)		const

virtual

Returns dofmanager dof mask for node.

This mask defines the dofs which are used by element in node. Mask influences the code number ordering for particular node. Code numbers are ordered according to node order and dofs belonging to particular node are ordered according to this mask. If element requests dofs using node mask which are not in node then error is generated. This masking allows node to be shared by different elements with different dofs in same node. Elements local code numbers are extracted from node using this mask. Must be defined by particular element.

Parameters

inode	Mask is computed for local dofmanager with inode number.
answer	Mask for node.

Reimplemented from oofem::Element.

Reimplemented in oofem::QSpaceGrad, oofem::QTRSpaceGrad, and oofem::QWedgeGrad.

Definition at line 197 of file structural3delement.C.

Referenced by computeNumberOfDofs(), and ~Structural3DElement().

void oofem::Structural3DElement::giveEdgeDofMapping	(	IntArray &	answer,
		int	iEdge
	)		const

protectedvirtual

Assembles edge dof mapping mask, which provides mapping between edge local DOFs and "global" element DOFs.

Mask can be imagined as local edge code numbers used to localize local edge DOFs to element DOFs.

Parameters

answer	Edge DOF mapping.
iEdge	Edge number.

Reimplemented from oofem::StructuralElement.

Definition at line 315 of file structural3delement.C.

References oofem::IntArray::at(), oofem::Element::giveInterpolation(), oofem::IntArray::giveSize(), and oofem::IntArray::resize().

Referenced by ~Structural3DElement().

MaterialMode oofem::Structural3DElement::giveMaterialMode ( )

virtual

Returns material mode for receiver integration points.

Should be specialized.

Returns: Material mode of element.

Reimplemented from oofem::Element.

Reimplemented in oofem::QSpaceGrad, and oofem::QWedgeGrad.

Definition at line 113 of file structural3delement.C.

Referenced by ~Structural3DElement().

void oofem::Structural3DElement::giveMaterialOrientationAt	(	FloatArray &	x,
		FloatArray &	y,
		FloatArray &	z,
		const FloatArray &	lcoords
	)

Todo:: This is subject to change. I'm not sure which is the best way to define a local c.s.

Definition at line 120 of file structural3delement.C.

References oofem::FloatArray::beColumnOf(), oofem::FloatArray::beVectorProductOf(), oofem::Element::elemLocalCS, oofem::Element::giveInterpolation(), oofem::FEInterpolation::giveJacobianMatrixAt(), oofem::FloatMatrix::isNotEmpty(), and oofem::FloatArray::normalize().

Referenced by computeConstitutiveMatrixAt(), computeStressVector(), and ~Structural3DElement().

void oofem::Structural3DElement::giveSurfaceDofMapping	(	IntArray &	answer,
		int	iSurf
	)		const

protectedvirtual

Assembles surface dof mapping mask, which provides mapping between surface local DOFs and "global" element DOFs.

Mask can be imagined as local surface code numbers used to localize local DOFs to element DOFs.

Parameters

answer	Surface DOF mapping.
iSurf	Surface number

Reimplemented from oofem::StructuralElement.

Definition at line 268 of file structural3delement.C.

References oofem::IntArray::at(), oofem::Element::giveInterpolation(), oofem::IntArray::giveSize(), and oofem::IntArray::resize().

Referenced by testElementExtension().

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