Class implementing hanging node connected to other nodes (masters) using interpolation. More...

#include <hangingnode.h>

Inheritance diagram for oofem::HangingNode:

Collaboration diagram for oofem::HangingNode:

Public Member Functions
	HangingNode (int n, Domain *aDomain)
	Constructor. More...

virtual	~HangingNode (void)
	Destructor. More...

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

virtual void	postInitialize ()
	Performs post-initialization such like checking if there are any slave dofs etc. More...

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

virtual bool	isDofTypeCompatible (dofType type) const
	Returns true if dof of given type is allowed to be associated to receiver. More...

virtual const char *	giveClassName () const

virtual const char *	giveInputRecordName () const

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

virtual	~Node ()
	Destructor. More...

virtual bool	hasCoordinates ()

virtual double	giveCoordinate (int i)

virtual FloatArray *	giveCoordinates ()

const FloatArray &	giveNodeCoordinates () const
	As giveCoordinates, but non-virtual and therefore faster (because it can be inlined). More...

void	setCoordinates (FloatArray coords)
	Sets node coordinates to given array. More...

virtual double	giveUpdatedCoordinate (int ic, TimeStep *tStep, double scale=1.)
	Returns updated ic-th coordinate of receiver. More...

virtual void	giveUpdatedCoordinates (FloatArray &answer, TimeStep *tStep, double scale=1.)
	Returns updated coordinate of receiver. More...

bool	hasLocalCS ()
	Returns nonzero if node has prescribed local coordinate system. More...

FloatMatrix *	giveLocalCoordinateTriplet ()
	Returns pointer to local coordinate triplet in node. More...

bool	hasSameLCS (Node *remote)
	Returns true, if the local coordinate systems of receiver and given node are the same. More...

virtual bool	computeL2GTransformation (FloatMatrix &answer, const IntArray &dofIDArry)
	Computes transformation matrix from global c.s. More...

virtual bool	requiresTransformation ()
	Indicates, whether dofManager requires the transformation. More...

virtual void	computeLoadVector (FloatArray &answer, Load load, CharType type, TimeStep tStep, ValueModeType mode)
	Computes the load vector for given load. More...

virtual void	updateYourself (TimeStep *tStep)
	Updates receiver at end of time step (i.e. More...

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

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

virtual int	giveQcNodeType ()

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	drawYourself (oofegGraphicContext &gc, TimeStep *tStep)

Public Member Functions inherited from oofem::DofManager
std::vector< Dof * >::iterator	begin ()

std::vector< Dof * >::iterator	end ()

std::vector< Dof * >::const_iterator	begin () const

std::vector< Dof * >::const_iterator	end () const

	DofManager (int n, Domain *aDomain)
	Constructor. More...

virtual	~DofManager ()
	Destructor. More...

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

bool	isBoundary ()

void	setBoundaryFlag (bool isBoundary)
	Sets the boundary flag. More...

virtual bool	hasAnySlaveDofs ()

virtual bool	giveMasterDofMans (IntArray &masters)
	Returns true if the receiver is linked (its slave DOFs depend on master values) to some other dof managers. More...

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

void	appendDof (Dof *dof)
	Adds the given Dof into the receiver. More...

void	removeDof (DofIDItem id)
	Removes Dof with given id from dofArray. More...

bool	hasDofID (DofIDItem id) const
	Checks if receiver contains dof with given ID. More...

int	giveGlobalNumber () const

int	giveLabel () const

void	setGlobalNumber (int newNumber)
	Sets receiver global number. More...

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

void	setParallelMode (dofManagerParallelMode _mode)
	Sets parallel mode of receiver. More...

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

void	setPartitionList (const IntArray *_p)
	Sets receiver's partition list. More...

void	removePartitionFromList (int _part)
	Removes given partition from receiver list. More...

void	mergePartitionList (IntArray &_p)
	Merges receiver partition list with given lists. More...

int	givePartitionsConnectivitySize ()
	Returns number of partitions sharing given receiver (=number of shared partitions + local one). More...

bool	isLocal ()
	Returns true if receiver is locally maintained. More...

bool	isShared ()
	Returns true if receiver is shared. More...

bool	isNull ()
	Returns true if receiver is shared. More...

Dof *	giveDofWithID (int dofID) const
	Returns DOF with given dofID; issues error if not present. More...

int	giveNumberOfDofs () const

void	askNewEquationNumbers (TimeStep *tStep)
	Renumbers all contained DOFs. More...

int	giveNumberOfPrimaryMasterDofs (const IntArray &dofIDArray) const
	Returns the number of primary dofs on which receiver dofs (given in dofArray) depend on. More...

void	giveLocationArray (const IntArray &dofIDArry, IntArray &locationArray, const UnknownNumberingScheme &s) const
	Returns location array (array containing for each requested dof related equation number) for given numbering scheme. More...

void	giveMasterDofIDArray (const IntArray &dofIDArry, IntArray &masterDofIDs) const
	Returns master dof ID array of receiver. More...

void	giveCompleteLocationArray (IntArray &locationArray, const UnknownNumberingScheme &s) const
	Returns full location array of receiver containing equation numbers of all dofs of receiver. More...

void	giveCompleteMasterDofIDArray (IntArray &dofIDArray) const
	Returns the full dof ID array of receiver. More...

std::vector< Dof * >::const_iterator	findDofWithDofId (DofIDItem dofID) const
	Finds index of DOF with required physical meaning of receiver. More...

void	giveUnknownVector (FloatArray &answer, const IntArray &dofMask, ValueModeType mode, TimeStep *tStep, bool padding=false)
	Assembles the vector of unknowns in global c.s for given dofs of receiver. More...

void	giveUnknownVector (FloatArray &answer, const IntArray &dofMask, PrimaryField &field, ValueModeType mode, TimeStep *tStep, bool padding=false)
	Assembles the vector of unknowns of given filed in global c.s for given dofs of receiver. More...

void	giveCompleteUnknownVector (FloatArray &answer, ValueModeType mode, TimeStep *tStep)
	Assembles the complete unknown vector in node. More...

void	giveUnknownVectorOfType (FloatArray &answer, UnknownType ut, ValueModeType mode, TimeStep *tStep)
	Constructs the requested vector by assembling e.g. More...

void	givePrescribedUnknownVector (FloatArray &answer, const IntArray &dofMask, ValueModeType mode, TimeStep *tStep)
	Assembles the vector of prescribed unknowns in nodal c.s for given dofs of receiver. More...

bool	computeM2GTransformation (FloatMatrix &answer, const IntArray &dofIDArry)
	Computes receiver transformation matrix from global CS to dofManager specific coordinate system; $u_g = R\cdot u_m$ . More...

virtual bool	computeM2LTransformation (FloatMatrix &answer, const IntArray &dofIDArry)
	Computes transformation matrix from local DOFs to master DOFs; $u_l = M\cdot u_m$ . More...

IntArray *	giveLoadArray ()
	Returns the array containing applied loadings of the receiver. More...

void	setLoadArray (IntArray &load)
	Sets the array of applied loadings of the receiver. More...

const IntArray *	giveForcedDofIDs ()
	Returns list of specific dofs that should be included in node. More...

std::map< int, int > *	giveDofTypeMap ()
	Returns map from DofIDItem to dofType. More...

std::map< int, int > *	giveMasterMap ()
	Returns map from DofIDItem to dofType. More...

std::map< int, int > *	giveBcMap ()
	Returns map from DofIDItem to dofType. More...

std::map< int, int > *	giveIcMap ()
	Returns map from DofIDItem to initial condition. More...

void	setNumberOfDofs (int _ndofs)
	Sets number of dofs of the receiver; Deallocates existing DOFs; Resizes the dofArray accordingly. More...

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

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

Domain *	giveDomain () const

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

int	giveNumber () const

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

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

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

Protected Attributes
int	masterElement
	Number of the master element. More...

int	masterRegion
	Region of the master element (used for automatic detection). More...

bool	initialized
	Flag whether node is fully initialized already. More...

Protected Attributes inherited from oofem::Node
FloatArray	coordinates
	Array storing nodal coordinates. More...

FloatMatrix *	localCoordinateSystem
	Triplet defining the local coordinate system in node. More...

Protected Attributes inherited from oofem::DofManager
std::vector< Dof * >	dofArray
	Array of DOFs. More...

IntArray	loadArray
	List of applied loads. More...

bool	isBoundaryFlag
	Indicates if dofManager is boundary (true boundary or on boundary between regions) or interior. More...

bool	hasSlaveDofs
	Flag indicating whether receiver has slave DOFs. More...

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

dofManagerParallelMode	parallel_mode

IntArray	partitions
	List of partition sharing the shared dof manager or remote partition containing remote dofmanager counterpart. More...

IntArray *	dofidmask
	List of additional dof ids to include. More...

std::map< int, int > *	dofTypemap
	Map from DofIDItem to dofType. More...

std::map< int, int > *	dofMastermap
	Map from DofIDItem to master node. More...

std::map< int, int > *	dofBCmap
	Map from DofIDItem to bc (to be removed). More...

std::map< int, int > *	dofICmap
	Map from DofIDItem to ic (to be removed). More...

IntArray	mBC

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

Class implementing hanging node connected to other nodes (masters) using interpolation.

Hanging node possess no degrees of freedom - all values are interpolated from corresponding master dofs.

The introduction of hanging nodes allows, for example, to include reinforcing bar elements inside arbitrary FE-mesh of concrete specimen or facilitates the local refinement of FE-mesh.

The contributions of hanging node are localized directly to master related equations. The hanging node can not have its own boundary or initial conditions, they are determined completely from master dof conditions. The local coordinate system in slave is not supported in current implementation, the global cs applies. On the other hand, hanging node can be loaded independently of master.

If no master element number is supplied (or negative) then it will locate it using the global coordinates. and if no master region number is supplied (or zero), it will look for elements in all regions.

Definition at line 64 of file hangingnode.h.

Constructor & Destructor Documentation

oofem::HangingNode::HangingNode	(	int	n,
		Domain *	aDomain
	)

Constructor.

Creates a hanging node with number n, belonging to aDomain.

Parameters

n	Node number in domain aDomain.
aDomain	Domain to which node belongs.

Definition at line 47 of file hangingnode.C.

References initialized.

virtual oofem::HangingNode::~HangingNode ( void )

inlinevirtual

Destructor.

Definition at line 84 of file hangingnode.h.

Member Function Documentation

int oofem::HangingNode::checkConsistency ( )

virtual

Allows programmer to test some internal data, before computation begins.

For example, one may use this function, to ensure that element has material with required capabilities is assigned to element. This must be done after all mesh components are instanciated.

Returns: Nonzero if receiver is consistent.

Reimplemented from oofem::Node.

Definition at line 65 of file hangingnode.C.

References oofem::Node::checkConsistency(), oofem::DofManager_local, oofem::FEMComponent::domain, oofem::Domain::giveElement(), oofem::Element::giveNode(), oofem::Element::giveNumberOfNodes(), oofem::DofManager::giveParallelMode(), oofem::Node::hasSameLCS(), masterElement, OOFEM_WARNING, and oofem::DofManager::parallel_mode.

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

inlinevirtual

Returns: Class name of the receiver.

Reimplemented from oofem::Node.

Definition at line 91 of file hangingnode.h.

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

inlinevirtual

Returns: Input record name of the receiver.

Reimplemented from oofem::Node.

Definition at line 92 of file hangingnode.h.

References _IFT_HangingNode_Name.

IRResultType oofem::HangingNode::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

Todo:: This is unnecessary, we should just check if user has supplied a dofidmask field or not and just drop "numberOfDofs"). It is left for now because it will give lots of warnings otherwise, but it is effectively ignored.

Todo:: This should eventually be removed, still here to preserve backwards compatibility:

Reimplemented from oofem::Node.

Definition at line 54 of file hangingnode.C.

References _IFT_HangingNode_masterElement, _IFT_HangingNode_masterRegion, oofem::Node::initializeFrom(), IR_GIVE_OPTIONAL_FIELD, masterElement, and masterRegion.

virtual bool oofem::HangingNode::isDofTypeCompatible ( dofType type ) const

inlinevirtual

Returns true if dof of given type is allowed to be associated to receiver.

Reimplemented from oofem::Node.

Definition at line 89 of file hangingnode.h.

void oofem::HangingNode::postInitialize ( )

virtual

Performs post-initialization such like checking if there are any slave dofs etc.

Reimplemented from oofem::DofManager.

Definition at line 92 of file hangingnode.C.

References oofem::IntArray::clear(), oofem::Node::coordinates, oofem::FEMComponent::domain, oofem::FEInterpolation::evalN(), oofem::IntArray::followedBy(), oofem::Dof::giveDofID(), oofem::Element::giveDofManArray(), oofem::FEMComponent::giveDomain(), oofem::SpatialLocalizer::giveElementClosestToPoint(), oofem::Element::giveInterpolation(), oofem::FEMComponent::giveNumber(), oofem::FloatMatrix::giveNumberOfColumns(), oofem::FloatArray::giveSize(), oofem::Domain::giveSpatialLocalizer(), oofem::FEInterpolation::global2local(), oofem::SpatialLocalizer::init(), oofem::SlaveDof::initialize(), initialized, masterElement, OOFEM_ERROR, and oofem::DofManager::postInitialize().

Member Data Documentation

bool oofem::HangingNode::initialized

protected

Flag whether node is fully initialized already.

Definition at line 73 of file hangingnode.h.

Referenced by HangingNode(), and postInitialize().

int oofem::HangingNode::masterElement

protected

Number of the master element.

Definition at line 68 of file hangingnode.h.

Referenced by checkConsistency(), initializeFrom(), and postInitialize().

int oofem::HangingNode::masterRegion

protected

Region of the master element (used for automatic detection).

Definition at line 70 of file hangingnode.h.

Referenced by initializeFrom().

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

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation