class PenaltyConstraintHandler : public ConstraintHandler

Inheritance:

Public Methods

PenaltyConstraintHandler(double alphaSP, double alphaMP)
~PenaltyConstraintHandler()
int handle(const ID *nodesNumberedLast =0)
void clearAll(void)
virtual int sendSelf(int commitTag, Channel &theChannel)
virtual int recvSelf(int commitTag, Channel &theChannel, FEM_ObjectBroker &theBroker)

Inherited from ConstraintHandler:

Public Methods

void setLinks(Domain &theDomain, AnalysisModel &theModel, Integrator &theIntegrator)

Protected Methods

Domain* getDomainPtr(void) const
AnalysisModel* getAnalysisModelPtr(void) const
Integrator* getIntegratorPtr(void) const

Inherited from MovableObject:

Public Methods

int getClassTag(void) const
int getDbTag(void) const
void setDbTag(int dbTag)

Documentation

The PenaltyConstraintHandler class is a class which deals with both single and multi point constraints using the penalty method. This is done by, in addition to creating a DOF_Group object for each Node and an FE_Element for each Element in the Domain, creating either a PenaltySP_FE or a PenaltyMP_FE object for each constraint in the Domain. It is these objects that enforce the constraints by moifying the tangent matrix and residual vector.

PenaltyConstraintHandler(double alphaSP, double alphaMP)

The integer HANDLER_TAG_PenaltyConstraintHandler (defined in <classTags.h>) is passed to the PenaltyConstraintHandler constructor. Stores alphaSP and alphaMP which are needed to construct the PenaltySP_FE and PenaltyMP_FE objects in handle().

~PenaltyConstraintHandler()

Currently invokes clearAll(), this will change when clearAll() is rewritten

int handle(const ID *nodesNumberedLast =0)

Determines the number of FE_Elements and DOF_Groups needed from the Domain (a one to one mapping between Elements and FE_Elements, SP_Constraints and PenaltySP_FEs, MP_Constraints and PenaltyMP_FEs and Nodes and DOF_Groups). Creates two arrays of pointers to store the FE_Elements and DOF_Groups, returning a warning message and a -2 or -3 if not enough memory is available for these arrays. Then the object will iterate through the Nodes of the Domain, creating a DOF_Group for each node and setting the initial id for each dof to -2 or -3 if the node identifier is in nodesToBeNumberedLast. The object then iterates through the Elements of the Domain creating a FE_Element for each Element, if the Element is a Subdomain setFE_ElementPtr() is invoked on the Subdomain with the new FE_Element as the argument. If not enough memory is available for any DOF_Group or FE_element a warning message is printed and a -4 or -5 is returned. The object then iterates through the SP_Constraints of the Domain creating a PenaltySP_FE for each constraint, using the Domain, the constraint and alphaSP as the arguments in the constructor. The object then iterates through the MP_Constraints of the Domain creating a PenaltyMP_FE for each constraint, using the Domain, the constraint and alphaMP as the arguments in the constructor. Finally the method returns the number of degrees-of-freedom associated with the DOF_Groups in nodesToBeNumberedLast.

void clearAll(void)

Currently this invokes delete on all the FE_element and DOF_Group objects created in handle() and the arrays used to store pointers to these objects. FOR ANALYSIS INVOLVING DYNAMIC LOAD BALANCING, RE-MESHING AND CONTACT THIS MUST CHANGE.

virtual int sendSelf(int commitTag, Channel &theChannel)

Sends in a Vector of size 2 alphaSP and alphaMP. Returns 0 if successful.

virtual int recvSelf(int commitTag, Channel &theChannel, FEM_ObjectBroker &theBroker)

Receives in a Vector of size 2 the values alphaSP and alphaMP. Returns 0 if successful.

This class has no child classes.

alphabetic index Contents

this page has been generated automatically by a slightly modified version of doc++ for OpenSees

Copyright Contact Us