OOFEM  2.4
OOFEM.org - Object Oriented Finite Element Solver
oofem::ElementSide Class Reference

Class implementing element side having some DOFs in finite element mesh. More...

#include <elementside.h>

+ Inheritance diagram for oofem::ElementSide:
+ Collaboration diagram for oofem::ElementSide:

Public Member Functions

 ElementSide (int n, Domain *aDomain)
 Constructor. More...
 
virtual ~ElementSide ()
 Destructor. More...
 
virtual const char * giveClassName () const
 
virtual const char * giveInputRecordName () const
 
virtual IRResultType initializeFrom (InputRecord *ir)
 Initializes receiver according to object description stored in input record. More...
 
virtual void printYourself ()
 Prints receiver state on stdout. Useful for debugging. More...
 
virtual void computeTransformation (FloatMatrix &answer, const IntArray *dofIDArry)
 Computes receiver transformation matrix from global cs. More...
 
virtual bool requiresTransformation ()
 Indicates, whether dofManager requires the transformation. More...
 
virtual bool isDofTypeCompatible (dofType type) const
 Returns true if dof of given type is allowed to be associated to receiver. More...
 
- 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...
 
virtual void updateYourself (TimeStep *tStep)
 Updates receiver after equilibrium in time step has been reached. 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 giveInputRecord (DynamicInputRecord &input)
 Setups the input record string of receiver. 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 postInitialize ()
 Performs post-initialization such like checking if there are any slave dofs etc. 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...
 
virtual void drawYourself (oofegGraphicContext &gc, TimeStep *tStep)
 
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 IntArraygivePartitionList ()
 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...
 
DofgiveDofWithID (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 computeL2GTransformation (FloatMatrix &answer, const IntArray &dofIDArry)
 Computes transformation matrix from global c.s. 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...
 
virtual void computeLoadVector (FloatArray &answer, Load *load, CharType type, TimeStep *tStep, ValueModeType mode)
 Computes the load vector for given load. More...
 
IntArraygiveLoadArray ()
 Returns the array containing applied loadings of the receiver. More...
 
void setLoadArray (IntArray &load)
 Sets the array of applied loadings of the receiver. More...
 
virtual bool hasCoordinates ()
 
virtual double giveCoordinate (int i)
 
virtual FloatArraygiveCoordinates ()
 
const IntArraygiveForcedDofIDs ()
 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...
 
DomaingiveDomain () const
 
virtual void setDomain (Domain *d)
 Sets associated Domain. More...
 
int giveNumber () const
 
void setNumber (int num)
 Sets number of receiver. More...
 
virtual int checkConsistency ()
 Allows programmer to test some internal data, before computation begins. More...
 
virtual InterfacegiveInterface (InterfaceType t)
 Interface requesting service. More...
 
std::string errorInfo (const char *func) const
 Returns string for prepending output (used by error reporting macros). More...
 

Additional Inherited Members

- 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...
 
IntArraydofidmask
 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...
 
Domaindomain
 Link to domain object, useful for communicating with other FEM components. More...
 

Detailed Description

Class implementing element side having some DOFs in finite element mesh.

ElementSide possess degrees of freedom (see base class DofManager). ElementSide id usually attribute of few elements and is managed by domain.

Tasks:

  • managing its degrees of freedom (giveDof).
  • calculating its load vector.
  • printing and updating at end of step.
  • managing its swapping to and from disk.

Definition at line 60 of file elementside.h.

Constructor & Destructor Documentation

oofem::ElementSide::ElementSide ( int  n,
Domain aDomain 
)

Constructor.

Creates a element side belonging to domain.

Parameters
nSide number in domain aDomain
aDomainDomain to which side belongs

Definition at line 45 of file elementside.C.

oofem::ElementSide::~ElementSide ( )
virtual

Destructor.

Definition at line 50 of file elementside.C.

Member Function Documentation

void oofem::ElementSide::computeTransformation ( FloatMatrix answer,
const IntArray dofIDArry 
)
virtual

Computes receiver transformation matrix from global cs.

to dofManager specific coordinate system (in which governing equations are assembled, for example the local coordinate system in node).

Parameters
answerComputed transformation matrix. It has generally dofIDArry.size rows and if loc is obtained using giveLocationArray(dofIDArry, loc) call, loc.giveSize() columns. This is because this transformation should generally include not only transformation to dof manager local coordinate system, but receiver dofs can be expressed using dofs of another dofManager (In this case, square answer is produced only if all dof transformation is required).
dofIDArryArray containing DofIDItem values for which transformation matrix is assembled. If dofIDArry is NULL, then all receiver dofs are assumed.

Definition at line 78 of file elementside.C.

References oofem::FloatMatrix::beUnitMatrix(), oofem::DofManager::giveNumberOfDofs(), oofem::IntArray::giveSize(), oofem::FloatMatrix::resize(), and oofem::FloatMatrix::zero().

virtual const char* oofem::ElementSide::giveClassName ( ) const
inlinevirtual
Returns
Class name of the receiver.

Implements oofem::FEMComponent.

Definition at line 73 of file elementside.h.

virtual const char* oofem::ElementSide::giveInputRecordName ( ) const
inlinevirtual
Returns
Input record name of the receiver.

Implements oofem::FEMComponent.

Definition at line 74 of file elementside.h.

References _IFT_ElementSide_Name.

IRResultType oofem::ElementSide::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
irInput 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::DofManager.

Definition at line 54 of file elementside.C.

References oofem::DofManager::initializeFrom().

virtual bool oofem::ElementSide::isDofTypeCompatible ( dofType  type) const
inlinevirtual

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

Reimplemented from oofem::DofManager.

Definition at line 93 of file elementside.h.

void oofem::ElementSide::printYourself ( )
virtual

Prints receiver state on stdout. Useful for debugging.

Reimplemented from oofem::DofManager.

Definition at line 65 of file elementside.C.

References oofem::DofManager::loadArray, oofem::FEMComponent::number, oofem::IntArray::printYourself(), and oofem::Dof::printYourself().

virtual bool oofem::ElementSide::requiresTransformation ( )
inlinevirtual

Indicates, whether dofManager requires the transformation.

Returns
Nonzero if transformation is necessary, even for single dof.

Reimplemented from oofem::DofManager.

Definition at line 92 of file elementside.h.


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

This page is part of the OOFEM documentation. Copyright (c) 2011 Borek Patzak
Project e-mail: info@oofem.org
Generated at Tue Jan 2 2018 20:07:35 for OOFEM by doxygen 1.8.11 written by Dimitri van Heesch, © 1997-2011