#include <springelement.h>

Inheritance diagram for oofem::SpringElement:

Collaboration diagram for oofem::SpringElement:

Public Types
enum	SpringElementType { SE_1D_SPRING = 0 , SE_2D_SPRING_XY = 1 , SE_2D_SPRING_XZ = 2 , SE_2D_TORSIONALSPRING_XZ = 3 , SE_3D_SPRING = 4 , SE_3D_TORSIONALSPRING = 5 }
	Defines type of spring element (longitudinal/rotational) spring. More...

Public Member Functions
	SpringElement (int n, Domain *d)
virtual	~SpringElement ()
void	computeLumpedMassMatrix (FloatMatrix &answer, TimeStep *tStep) override
void	computeMassMatrix (FloatMatrix &answer, TimeStep *tStep) override
void	computeStiffnessMatrix (FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep) override
void	computeInitialStressMatrix (FloatMatrix &answer, TimeStep *tStep) override
void	giveInternalForcesVector (FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord=0) override
int	computeNumberOfDofs () override
int	computeNumberOfGlobalDofs () override
void	giveDofManDofIDMask (int inode, IntArray &answer) const override
void	updateInternalState (TimeStep *tStep) override
void	updateYourself (TimeStep *tStep) override
int	checkConsistency () override
void	printOutputAt (FILE file, TimeStep tStep) override
bool	isCast (TimeStep *tStep) override
const char *	giveInputRecordName () const override
const char *	giveClassName () const override
void	initializeFrom (InputRecord &ir, int priority) override
Element_Geometry_Type	giveGeometryType () const override
Public Member Functions inherited from oofem::StructuralElement
	StructuralElement (int n, Domain *d)
virtual	~StructuralElement ()
	Destructor.
void	giveCharacteristicMatrix (FloatMatrix &answer, CharType, TimeStep *tStep) override
void	giveCharacteristicVector (FloatArray &answer, CharType type, ValueModeType mode, TimeStep *tStep) override
virtual void	computeConsistentMassMatrix (FloatMatrix &answer, TimeStep tStep, double &mass, const double ipDensity=NULL)
virtual void	giveMassMtrxIntegrationgMask (IntArray &answer)
void	computeStiffnessMatrix_withIRulesAsSubcells (FloatMatrix &answer, MatResponseMode rMode, TimeStep *tStep)
virtual void	computeLumpedInitialStressMatrix (FloatMatrix &answer, TimeStep *tStep)
void	computeField (ValueModeType mode, TimeStep *tStep, const FloatArray &lcoords, FloatArray &answer) override
virtual void	giveInternalForcesVector_withIRulesAsSubcells (FloatArray &answer, TimeStep *tStep, int useUpdatedGpRecord=0)
virtual void	computeStrainVector (FloatArray &answer, GaussPoint gp, TimeStep tStep)
int	giveIPValue (FloatArray &answer, GaussPoint gp, InternalStateType type, TimeStep tStep) override
virtual void	computeResultingIPTemperatureAt (FloatArray &answer, TimeStep tStep, GaussPoint gp, ValueModeType mode)
virtual void	computeResultingIPEigenstrainAt (FloatArray &answer, TimeStep tStep, GaussPoint gp, ValueModeType mode)
void	updateBeforeNonlocalAverage (TimeStep *tStep) override
virtual void	giveNonlocalLocationArray (IntArray &locationArray, const UnknownNumberingScheme &us)
virtual void	addNonlocalStiffnessContributions (SparseMtrx &dest, const UnknownNumberingScheme &s, TimeStep *tStep)
int	adaptiveUpdate (TimeStep *tStep) override
void	updateInternalState (TimeStep *tStep) override
void	updateYourself (TimeStep *tStep) override
int	checkConsistency () override
void	giveInputRecord (DynamicInputRecord &input) override
const char *	giveClassName () const override
int	giveInternalStateAtNode (FloatArray &answer, InternalStateType type, InternalStateMode mode, int node, TimeStep *tStep) override
void	showSparseMtrxStructure (CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep) override
	Shows sparse structure.
void	showExtendedSparseMtrxStructure (CharType mtrx, oofegGraphicContext &gc, TimeStep *tStep) override
	Shows extended sparse structure (for example, due to nonlocal interactions for tangent stiffness).
void	computeLoadVector (FloatArray &answer, BodyLoad load, CharType type, ValueModeType mode, TimeStep tStep) override
void	computeBoundarySurfaceLoadVector (FloatArray &answer, BoundaryLoad load, int boundary, CharType type, ValueModeType mode, TimeStep tStep, bool global=true) override
void	computeBoundaryEdgeLoadVector (FloatArray &answer, BoundaryLoad load, int boundary, CharType type, ValueModeType mode, TimeStep tStep, bool global=true) override
virtual void	computeEdgeNMatrix (FloatMatrix &answer, int boundaryID, const FloatArray &lcoords)
	computes edge interpolation matrix
virtual void	computeSurfaceNMatrix (FloatMatrix &answer, int boundaryID, const FloatArray &lcoords)
StructuralCrossSection *	giveStructuralCrossSection ()
	Helper function which returns the structural cross-section for the element.
virtual void	createMaterialStatus ()
Public Member Functions inherited from oofem::Element
	Element (int n, Domain *aDomain)
	Element (const Element &src)=delete
Element &	operator= (const Element &src)=delete
virtual	~Element ()
	Virtual destructor.
void	giveLocationArray (IntArray &locationArray, const UnknownNumberingScheme &s, IntArray *dofIds=NULL) const
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)
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
virtual void	setInternalDofManager (int num, std::unique_ptr< DofManager > dm)
virtual double	giveCharacteristicValue (CharType type, TimeStep *tStep)
virtual void	computeTangentFromSurfaceLoad (FloatMatrix &answer, BoundaryLoad load, int boundary, MatResponseMode rmode, TimeStep tStep)
virtual void	computeTangentFromEdgeLoad (FloatMatrix &answer, BoundaryLoad load, int boundary, MatResponseMode rmode, TimeStep tStep)
const IntArray &	giveBodyLoadList () const
const IntArray &	giveBoundaryLoadList () const
void	computeVectorOf (ValueModeType u, TimeStep *tStep, FloatArray &answer)
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)
void	computeVectorOf (PrimaryField &field, const IntArray &dofIDMask, ValueModeType u, TimeStep *tStep, FloatArray &answer, bool padding=false)
void	computeVectorOfPrescribed (ValueModeType u, TimeStep *tStep, FloatArray &answer)
void	computeVectorOfPrescribed (const IntArray &dofIDMask, ValueModeType type, TimeStep *tStep, FloatArray &answer)
int	computeNumberOfPrimaryMasterDofs ()
virtual bool	giveRotationMatrix (FloatMatrix &answer)
virtual bool	computeDofTransformationMatrix (FloatMatrix &answer, const IntArray &nodes, bool includeInternal)
virtual void	giveInternalDofManDofIDMask (int inode, IntArray &answer) const
virtual void	giveElementDofIDMask (IntArray &answer) const
virtual double	computeVolumeAround (GaussPoint *gp)
virtual double	computeVolumeAreaOrLength ()
	Computes the volume, area or length of the element depending on its spatial dimension.
double	computeMeanSize ()
virtual double	computeVolume ()
virtual double	computeArea ()
virtual double	computeLength ()
virtual IntArray	giveBoundaryEdgeNodes (int boundary, bool includeHierarchical=false) const
virtual IntArray	giveBoundarySurfaceNodes (int boundary, bool includeHierarchical=false) const
virtual IntArray	giveBoundaryNodes (int boundary) const
virtual std::unique_ptr< IntegrationRule >	giveBoundaryEdgeIntegrationRule (int order, int boundary)
virtual std::unique_ptr< IntegrationRule >	giveBoundarySurfaceIntegrationRule (int order, int boundary)
int	giveDofManagerNumber (int i) const
const IntArray &	giveDofManArray () const
void	addDofManager (DofManager *dMan)
DofManager *	giveDofManager (int i) const
Node *	giveNode (int i) const
virtual ElementSide *	giveSide (int i) const
virtual FEInterpolation *	giveInterpolation () const
virtual FEInterpolation *	giveInterpolation (DofIDItem id) const
virtual const FEInterpolation *	getGeometryInterpolation () const
virtual Material *	giveMaterial ()
int	giveMaterialNumber () const
CrossSection *	giveCrossSection ()
int	getActivityTimeFunctionNumber ()
void	setActivityTimeFunctionNumber (int funcIndx)
void	setMaterial (int matIndx)
virtual void	setCrossSection (int csIndx)
virtual int	giveNumberOfDofManagers () const
void	setNumberOfDofManagers (int i)
	Sets number of element dof managers.
virtual int	giveNumberOfNodes () const
void	setDofManagers (const IntArray &dmans)
void	setDofManager (int id, int dm)
void	setBodyLoads (const IntArray &bodyLoads)
void	setIntegrationRules (std ::vector< std ::unique_ptr< IntegrationRule > > irlist)
virtual integrationDomain	giveIntegrationDomain () const
virtual MaterialMode	giveMaterialMode ()
virtual int	giveIntegrationRuleLocalCodeNumbers (IntArray &answer, IntegrationRule &ie)
int	giveRegionNumber ()
virtual void	initializeYourself (TimeStep *timeStepWhenICApply)
virtual bool	isActivated (TimeStep *tStep)
virtual void	initForNewStep ()
virtual Element_Geometry_Type	giveEdgeGeometryType (int id) const
	Returns the receiver edge geometry type.
virtual Element_Geometry_Type	giveSurfaceGeometryType (int id) const
	Returns the receiver surface geometry type.
virtual int	giveSpatialDimension ()
virtual int	giveNumberOfBoundarySides ()
	Returns number of boundaries (entities of element_dimension-1: points, edges, surfaces).
virtual int	giveNumberOfEdges () const
virtual int	giveNumberOfSurfaces () const
virtual int	giveDefaultIntegrationRule () const
virtual IntegrationRule *	giveDefaultIntegrationRulePtr ()
int	giveNumberOfIntegrationRules ()
virtual IntegrationRule *	giveIntegrationRule (int i)
std::vector< std ::unique_ptr< IntegrationRule > > &	giveIntegrationRulesArray ()
virtual int	testElementExtension (ElementExtension ext)
int	giveGlobalIPValue (FloatArray &answer, GaussPoint gp, InternalStateType type, TimeStep tStep)
virtual double	giveLengthInDir (const FloatArray &normalToCrackPlane)
virtual double	giveCharacteristicLength (const FloatArray &normalToCrackPlane)
double	giveCharacteristicLengthForPlaneElements (const FloatArray &normalToCrackPlane)
double	giveCharacteristicLengthForAxisymmElements (const FloatArray &normalToCrackPlane)
virtual double	giveCharacteristicSize (GaussPoint *gp, FloatArray &normalToCrackPlane, ElementCharSizeMethod method)
virtual double	giveParentElSize () const
virtual int	computeGlobalCoordinates (FloatArray &answer, const FloatArray &lcoords)
virtual bool	computeLocalCoordinates (FloatArray &answer, const FloatArray &gcoords)
virtual int	giveLocalCoordinateSystem (FloatMatrix &answer)
virtual void	giveLocalCoordinateSystemVector (InternalStateType isttype, FloatArray &answer)
virtual void	computeMidPlaneNormal (FloatArray &answer, const GaussPoint *gp)
virtual int	adaptiveMap (Domain oldd, TimeStep tStep)
virtual int	mapStateVariables (Domain &iOldDom, const TimeStep &iTStep)
virtual int	adaptiveFinish (TimeStep *tStep)
void	updateLocalNumbering (EntityRenumberingFunctor &f) override
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.
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.
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)
int	giveLabel () const
int	giveGlobalNumber () const
void	setGlobalNumber (int num)
elementParallelMode	giveParallelMode () const
void	setParallelMode (elementParallelMode _mode)
	Sets parallel mode of element.
virtual elementParallelMode	giveKnotSpanParallelMode (int) const
int	packUnknowns (DataStream &buff, TimeStep *tStep)
int	unpackAndUpdateUnknowns (DataStream &buff, TimeStep *tStep)
int	estimatePackSize (DataStream &buff)
const IntArray *	givePartitionList () const
void	setPartitionList (IntArray &pl)
virtual double	predictRelativeComputationalCost ()
virtual double	giveRelativeSelfComputationalCost ()
virtual double	predictRelativeRedistributionCost ()
IntArray *	giveBodyLoadArray ()
	Returns array containing load numbers of loads acting on element.
IntArray *	giveBoundaryLoadArray ()
	Returns array containing load numbers of boundary loads acting on element.
void	initializeFinish () override
void	postInitialize () override
	Performs post initialization steps.
void	saveContext (DataStream &stream, ContextMode mode) override
void	restoreContext (DataStream &stream, ContextMode mode) override
virtual const IntArray	giveLocation ()
virtual void	recalculateCoordinates (int nodeNumber, FloatArray &coords)
void	setSharedEdgeID (int iedge, int globalID)
void	setSharedSurfaceID (int isurf, int globalID)
const IntArray *	giveSharedEdgeIDs () const
const IntArray *	giveSharedSurfaceIDs () const
Public Member Functions inherited from oofem::FEMComponent
	FEMComponent (int n, Domain *d)
virtual	~FEMComponent ()=default
	Virtual destructor.
Domain *	giveDomain () const
virtual void	setDomain (Domain *d)
int	giveNumber () const
void	setNumber (int num)
virtual void	initializeFrom (InputRecord &ir)
virtual void	printYourself ()
	Prints receiver state on stdout. Useful for debugging.
virtual Interface *	giveInterface (InterfaceType t)
std::string	errorInfo (const char *func) const
	Returns string for prepending output (used by error reporting macros).

Protected Member Functions
void	computeStressVector (FloatArray &answer, const FloatArray &strain, GaussPoint gp, TimeStep tStep) override
void	computeConstitutiveMatrixAt (FloatMatrix &answer, MatResponseMode rMode, GaussPoint gp, TimeStep tStep) override
void	computeBmatrixAt (GaussPoint *gp, FloatMatrix &answer, int lowerIndx=1, int upperIndx=ALL_STRAINS) override
void	computeNmatrixAt (const FloatArray &iLocCoord, FloatMatrix &answer) override
bool	computeGtoLRotationMatrix (FloatMatrix &answer) override
double	computeSpringInternalForce (TimeStep *tStep)
virtual void	computePointLoadVectorAt (FloatArray &answer, Load load, TimeStep tStep, ValueModeType mode, bool global=true)
virtual void	giveEdgeDofMapping (IntArray &answer, int iEdge) const
virtual void	giveSurfaceDofMapping (IntArray &answer, int iSurf) const
virtual double	computeEdgeVolumeAround (GaussPoint *gp, int iEdge)
virtual double	computeSurfaceVolumeAround (GaussPoint *gp, int iSurf)
virtual int	computeLoadGToLRotationMtrx (FloatMatrix &answer)
virtual int	computeLoadLEToLRotationMatrix (FloatMatrix &answer, int iEdge, GaussPoint *gp)
virtual int	computeLoadLSToLRotationMatrix (FloatMatrix &answer, int iSurf, GaussPoint *gp)
virtual int	giveNumberOfIPForMassMtrxIntegration ()
void	condense (FloatMatrix stiff, FloatMatrix mass, FloatArray load, IntArray what)
virtual void	setupIRForMassMtrxIntegration (IntegrationRule &iRule)
virtual void	computeBodyLoadVectorAt (FloatArray &answer, Load load, TimeStep tStep, ValueModeType mode)
virtual void	computeGaussPoints ()

Protected Attributes
double	springConstant
	The longitudinal spring constant [Force/Length], torsional spring constant [Force*Length/Radians].
double	mass =0.0
	total mass of the spring; to be distributed to nodes
FloatArray	dir
SpringElementType	mode
	Mode.
Protected Attributes inherited from oofem::StructuralElement
std::unique_ptr< FloatArray >	initialDisplacements
	Initial displacement vector, describes the initial nodal displacements when element has been casted.
Protected Attributes inherited from oofem::Element
int	numberOfDofMans
	Number of dofmanagers.
IntArray	dofManArray
	Array containing dofmanager numbers.
int	material
	Number of associated material.
int	crossSection
	Number of associated cross section.
IntArray	bodyLoadArray
IntArray	boundaryLoadArray
std::vector< std ::unique_ptr< IntegrationRule > >	integrationRulesArray
FloatMatrix	elemLocalCS
	Transformation material matrix, used in orthotropic and anisotropic materials, global->local transformation.
int	activityTimeFunction
	Element activity time function. If defined, nonzero value indicates active receiver, zero value inactive element.
int	globalNumber
int	numberOfGaussPoints
elementParallelMode	parallel_mode
	Determines the parallel mode of the element.
IntArray	partitions
IntArray	globalEdgeIDs
IntArray	globalSurfaceIDs
Protected Attributes inherited from oofem::FEMComponent
int	number
	Component number.
Domain *	domain
	Link to domain object, useful for communicating with other FEM components.

Static Protected Attributes
static ParamKey	IPK_SpringElement_mode
static ParamKey	IPK_SpringElement_orientation
static ParamKey	IPK_SpringElement_springConstant
static ParamKey	IPK_SpringElement_mass

Additional Inherited Members
Static Public Attributes inherited from oofem::Element
static ParamKey	IPK_Element_mat
static ParamKey	IPK_Element_crosssect
static ParamKey	IPK_Element_nodes
static ParamKey	IPK_Element_bodyload
static ParamKey	IPK_Element_boundaryload
static ParamKey	IPK_Element_lcs
static ParamKey	IPK_Element_partitions
static ParamKey	IPK_Element_remote
static ParamKey	IPK_Element_activityTimeFunction
static ParamKey	IPK_Element_nip

Detailed Description

This class implements a simple spring element. Its purpose is to introduce a longitudinal or torsional spring between two nodes. The spring element is defined by its spring constant and orientation.

Definition at line 57 of file springelement.h.

Member Enumeration Documentation

◆ SpringElementType

enum oofem::SpringElement::SpringElementType

Defines type of spring element (longitudinal/rotational) spring.

Enumerator
SE_1D_SPRING	1D spring element along x-axis.
SE_2D_SPRING_XY	2D spring element in xy plane, requires D_u and D_v DOFs in each node (orientation vector should be in this plane).
SE_2D_SPRING_XZ
SE_2D_TORSIONALSPRING_XZ	< 2D spring element in xz plane, requires D_u and D_w DOFs in each node (orientation vector should be in this plane). 2D torsional spring element in xz plane, requires R_v DOFs in each node.
SE_3D_SPRING	3D spring element in space, requires D_u, D_v, and D_w DOFs in each node.
SE_3D_TORSIONALSPRING	3D torsional spring in space, requires R_u, R_v, and R_w DOFs in each node.

Definition at line 61 of file springelement.h.

Constructor & Destructor Documentation

◆ SpringElement()

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

Definition at line 55 of file springelement.C.

References oofem::Element::numberOfDofMans, springConstant, and oofem::StructuralElement::StructuralElement().

◆ ~SpringElement()

virtual oofem::SpringElement::~SpringElement ( )

inlinevirtual

Definition at line 90 of file springelement.h.

Member Function Documentation

◆ checkConsistency()

int oofem::SpringElement::checkConsistency ( void )

inlineoverridevirtual

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 108 of file springelement.h.

◆ computeBmatrixAt()

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

inlineoverrideprotectedvirtual

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.

Definition at line 130 of file springelement.h.

References ALL_STRAINS, and oofem::FloatMatrix::clear().

◆ computeConstitutiveMatrixAt()

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

inlineoverrideprotectedvirtual

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 127 of file springelement.h.

References oofem::FloatMatrix::clear().

◆ computeGtoLRotationMatrix()

bool oofem::SpringElement::computeGtoLRotationMatrix ( FloatMatrix & answer )

overrideprotectedvirtual

Returns transformation matrix from global c.s. to local element c.s., i.e. \( r_l =T r_g \). If no transformation is necessary then answer is empty matrix and zero value is returned.

Parameters

answer Computed rotation matrix.

Returns: Nonzero if transformation is necessary, zero otherwise.

Reimplemented from oofem::Element.

Definition at line 82 of file springelement.C.

References oofem::FloatMatrix::at(), dir, mode, oofem::FloatMatrix::resize(), SE_1D_SPRING, SE_2D_SPRING_XY, SE_2D_SPRING_XZ, SE_2D_TORSIONALSPRING_XZ, SE_3D_SPRING, and SE_3D_TORSIONALSPRING.

◆ computeInitialStressMatrix()

void oofem::SpringElement::computeInitialStressMatrix	(	FloatMatrix &	answer,
		TimeStep *	tStep )

inlineoverridevirtual

Computes initial stress matrix for linear stability problem. Default implementation is not provided. Please note, that initial stress matrix depends on normal forces of element, corresponding engineering model must take this into account.

Parameters

answer	Computed initial stress matrix.
tStep	Time step.

Reimplemented from oofem::StructuralElement.

Definition at line 96 of file springelement.h.

References oofem::FloatMatrix::clear().

◆ computeLumpedMassMatrix()

void oofem::SpringElement::computeLumpedMassMatrix	(	FloatMatrix &	answer,
		TimeStep *	tStep )

overridevirtual

Computes lumped mass matrix of receiver. Default implementation returns lumped consistent mass matrix. Then returns lumped mass transformed into nodal coordinate system. The lumping procedure zeroes all off-diagonal members and zeroes also all diagonal members corresponding to non-displacement DOFs. Such diagonal matrix is then rescaled, to preserve the element mass. Requires the computeNmatrixAt and giveMassMtrxIntegrationgMask services to be implemented.

Parameters

answer	Lumped mass matrix.
tStep	Time step.

Reimplemented from oofem::StructuralElement.

Definition at line 143 of file springelement.C.

References oofem::FloatMatrix::at(), mass, and oofem::FloatMatrix::resize().

Referenced by computeMassMatrix().

◆ computeMassMatrix()

void oofem::SpringElement::computeMassMatrix	(	FloatMatrix &	answer,
		TimeStep *	tStep )

inlineoverridevirtual

Computes mass matrix of receiver. Default implementation returns consistent mass matrix and uses numerical integration. Returns result of this->computeConsistentMassMatrix service, transformed into nodal coordinate system. Requires the computeNmatrixAt and giveMassMtrxIntegrationgMask services to be implemented.

Parameters

answer	Mass matrix.
tStep	Time step.

Reimplemented from oofem::StructuralElement.

Definition at line 93 of file springelement.h.

References computeLumpedMassMatrix().

◆ computeNmatrixAt()

void oofem::SpringElement::computeNmatrixAt	(	const FloatArray &	iLocCoord,
		FloatMatrix &	answer )

inlineoverrideprotectedvirtual

Computes interpolation matrix for element unknowns. The order and meaning of unknowns is element dependent.

Parameters

iLocCoord	Local coordinates.
answer	Interpolation matrix evaluated at gp.

Reimplemented from oofem::StructuralElement.

Definition at line 133 of file springelement.h.

References oofem::FloatMatrix::clear().

◆ computeNumberOfDofs()

int oofem::SpringElement::computeNumberOfDofs ( )

inlineoverridevirtual

Computes or simply returns total number of element's local DOFs. Must be defined by particular element.

Returns: Number of local DOFs of element.

Reimplemented from oofem::Element.

Definition at line 101 of file springelement.h.

◆ computeNumberOfGlobalDofs()

int oofem::SpringElement::computeNumberOfGlobalDofs ( )

overridevirtual

Computes the total number of element's global dofs. The transitions from global c.s. to nodal c.s. should NOT be included.

Returns: Total number of global DOFs of element.

Reimplemented from oofem::Element.

Definition at line 151 of file springelement.C.

References mode, SE_1D_SPRING, SE_2D_SPRING_XY, SE_2D_SPRING_XZ, SE_2D_TORSIONALSPRING_XZ, SE_3D_SPRING, and SE_3D_TORSIONALSPRING.

◆ computeSpringInternalForce()

double oofem::SpringElement::computeSpringInternalForce ( TimeStep * tStep )

protected

Definition at line 135 of file springelement.C.

References oofem::FloatArray::at(), oofem::Element::computeVectorOf(), and springConstant.

Referenced by giveInternalForcesVector(), and printOutputAt().

◆ computeStiffnessMatrix()

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

overridevirtual

Computes numerically stiffness matrix of receiver. Default implementation computes element stiffness using \( K=\int_v B^{\mathrm{T}} D B \mathrm{d}V \) formulae, where \( B \) is element geometric matrix and \( D \) is material stiffness matrix. No geometrical nonlinearity is taken into account. NUmerical integration procedure uses integrationRulesArray for numerical integration. Support for reduced or selected integration is implemented. The individual integration rules are assumed to correspond to different terms from which the overall matrix is assembled.

If there is one integration rule, the full integration of all coefficients is performed. Otherwise, integration is performed using following rules. Each integration rule can specify start and end strain index of strain vector components for which is valid. It is necessary to ensure that these start and end indexes, dividing geometrical matrix into blocks, are not overlapping and that each strain component is included.

Then stiffness matrix is obtained as summation of integrals \( I_{ij}=\int_v B^{\mathrm{T}}_i D_{ij} B_j \mathrm{d}V \) where \( B_i \) is i-th block of geometrical matrix and \( D_{ij} \) is corresponding constitutive sub-matrix. The geometrical matrix is obtained using computeBmatrixAt service and the constitutive matrix is obtained using computeConstitutiveMatrixAt service. The \( I_{ij} \) integral is evaluated using such integration rule, which is valid for i-th or j-th block and has smaller number of integration points.

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 from oofem::StructuralElement.

Definition at line 62 of file springelement.C.

References oofem::FloatMatrix::at(), oofem::FloatMatrix::resize(), and springConstant.

◆ computeStressVector()

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

inlineoverrideprotectedvirtual

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.

Implements oofem::StructuralElement.

Definition at line 125 of file springelement.h.

References oofem::FloatArray::clear().

◆ giveClassName()

const char * oofem::SpringElement::giveClassName ( ) const

inlineoverridevirtual

Returns: Class name of the receiver.

Reimplemented from oofem::Element.

Definition at line 120 of file springelement.h.

◆ giveDofManDofIDMask()

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

overridevirtual

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.

Definition at line 117 of file springelement.C.

References mode, SE_1D_SPRING, SE_2D_SPRING_XY, SE_2D_SPRING_XZ, SE_2D_TORSIONALSPRING_XZ, SE_3D_SPRING, and SE_3D_TORSIONALSPRING.

◆ giveGeometryType()

Element_Geometry_Type oofem::SpringElement::giveGeometryType ( ) const

inlineoverridevirtual

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.

Implements oofem::Element.

Definition at line 122 of file springelement.h.

◆ giveInputRecordName()

const char * oofem::SpringElement::giveInputRecordName ( ) const

inlineoverridevirtual

Returns: Input record name of the receiver.

Implements oofem::FEMComponent.

Definition at line 119 of file springelement.h.

References _IFT_SpringElement_Name.

◆ giveInternalForcesVector()

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

overridevirtual

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 from oofem::StructuralElement.

Definition at line 72 of file springelement.C.

References oofem::FloatArray::at(), computeSpringInternalForce(), and oofem::FloatArray::resize().

◆ initializeFrom()

void oofem::SpringElement::initializeFrom	(	InputRecord &	ir,
		int	priority )

overridevirtual

Reimplemented from oofem::Element.

Definition at line 165 of file springelement.C.

References dir, oofem::FEMComponent::giveDomain(), IPK_SpringElement_mass, IPK_SpringElement_mode, IPK_SpringElement_orientation, IPK_SpringElement_springConstant, mass, mode, oofem::FEMComponent::number, PM_UPDATE_PARAMETER, PM_UPDATE_PARAMETER_AND_REPORT, and springConstant.

◆ isCast()

bool oofem::SpringElement::isCast ( TimeStep * tStep )

inlineoverridevirtual

Returns: True, if the current time is higher than the casting time of the material, otherwise false. Used from e.g. vtkxml export module to display only active elements

Note: : The element can be activated (isActivated method) before its material is actually casted. This case has to be supported by the material and can be used to simulate the casting on deformed configuration, for example. In this case, the material has to define a small stifness for solution steps before is actually casted.

Reimplemented from oofem::Element.

Definition at line 110 of file springelement.h.

◆ printOutputAt()

void oofem::SpringElement::printOutputAt	(	FILE *	file,
		TimeStep *	tStep )

overridevirtual

Prints output of receiver to stream, for given time step. This is used for output into the standard output file.

Parameters

file	File pointer to print to.
tStep	Time step to write for.

Reimplemented from oofem::Element.

Definition at line 184 of file springelement.C.

References computeSpringInternalForce(), oofem::Element::giveLabel(), and oofem::FEMComponent::giveNumber().

◆ updateInternalState()

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

inlineoverridevirtual

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.

Definition at line 106 of file springelement.h.

◆ updateYourself()

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

inlineoverridevirtual

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.

Definition at line 107 of file springelement.h.

Member Data Documentation

◆ dir

FloatArray oofem::SpringElement::dir

protected

Orientation vector. Defines orientation of spring element- for spring it defines the direction of spring, for torsional spring it defines the axis of rotation.

Definition at line 79 of file springelement.h.

Referenced by computeGtoLRotationMatrix(), and initializeFrom().

◆ IPK_SpringElement_mass

ParamKey oofem::SpringElement::IPK_SpringElement_mass

staticprotected

Definition at line 86 of file springelement.h.

Referenced by initializeFrom().

◆ IPK_SpringElement_mode

ParamKey oofem::SpringElement::IPK_SpringElement_mode

staticprotected

Definition at line 83 of file springelement.h.

Referenced by initializeFrom().

◆ IPK_SpringElement_orientation

ParamKey oofem::SpringElement::IPK_SpringElement_orientation

staticprotected

Definition at line 84 of file springelement.h.

Referenced by initializeFrom().

◆ IPK_SpringElement_springConstant

ParamKey oofem::SpringElement::IPK_SpringElement_springConstant

staticprotected

Definition at line 85 of file springelement.h.

Referenced by initializeFrom().

◆ mass

double oofem::SpringElement::mass =0.0

protected

total mass of the spring; to be distributed to nodes

Definition at line 74 of file springelement.h.

Referenced by computeLumpedMassMatrix(), and initializeFrom().

◆ mode

SpringElementType oofem::SpringElement::mode

protected

Mode.

Definition at line 81 of file springelement.h.

Referenced by computeGtoLRotationMatrix(), computeNumberOfGlobalDofs(), giveDofManDofIDMask(), and initializeFrom().

◆ springConstant

double oofem::SpringElement::springConstant

protected

The longitudinal spring constant [Force/Length], torsional spring constant [Force*Length/Radians].

Definition at line 72 of file springelement.h.

Referenced by computeSpringInternalForce(), computeStiffnessMatrix(), initializeFrom(), and SpringElement().

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

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ SpringElementType

Constructor & Destructor Documentation

◆ SpringElement()

◆ ~SpringElement()

Member Function Documentation

◆ checkConsistency()

◆ computeBmatrixAt()

◆ computeConstitutiveMatrixAt()

◆ computeGtoLRotationMatrix()

◆ computeInitialStressMatrix()

◆ computeLumpedMassMatrix()

◆ computeMassMatrix()

◆ computeNmatrixAt()

◆ computeNumberOfDofs()

◆ computeNumberOfGlobalDofs()

◆ computeSpringInternalForce()

◆ computeStiffnessMatrix()

◆ computeStressVector()

◆ giveClassName()

◆ giveDofManDofIDMask()

◆ giveGeometryType()

◆ giveInputRecordName()

◆ giveInternalForcesVector()

◆ initializeFrom()

◆ isCast()

◆ printOutputAt()

◆ updateInternalState()

◆ updateYourself()

Member Data Documentation

◆ dir

◆ IPK_SpringElement_mass

◆ IPK_SpringElement_mode

◆ IPK_SpringElement_orientation

◆ IPK_SpringElement_springConstant

◆ mass

◆ mode

◆ springConstant