A DOF_Group object is instantiated by the ConstraintHandler for every unconstrained node in the domain. More...

#include <DOF_Group.h>

Inheritance diagram for XC::DOF_Group:

Public Member Functions
virtual	~DOF_Group ()
	Destructor.

virtual void	setID (int dof, int value)
	to set the corresponding index of the ID to value. More...

virtual void	setID (const ID &values)
	Method to set the ID to be same as that given. More...

virtual const ID &	getID (void) const
	Method to return the current ID. More...

int	inicID (const int &value)

virtual int	getNodeTag (void) const
	Returns the tag of the associated node (-1 if there is no associated node). More...

virtual int	getNumDOF (void) const
	Returns the total number of DOFs in the DOF_Group.

virtual int	getNumFreeDOF (void) const
	Returns the total number of `free` DOFs. More...

virtual int	getNumConstrainedDOF (void) const
	Returns the total number of `constrained` DOFs. More...

virtual const Matrix &	getTangent (Integrator *theIntegrator)
	Returns the current tangent matrix for the DOF_Group. More...

virtual void	zeroTangent (void)
	To zero the tangent matrix. More...

virtual void	addMtoTang (double fact=1.0)
	To add `fact` times the nodal mass matrix to the tangent matrix. More...

virtual void	addCtoTang (double fact=1.0)

virtual const Vector &	getUnbalance (Integrator *theIntegrator)
	Returns the vector holding the unbalance.

virtual void	zeroUnbalance (void)
	To zero the unbalance vector. More...

virtual void	addPtoUnbalance (double fact=1.0)
	Adds the product of the unbalanced load at the node and `fact` to the unbalance vector. More...

virtual void	addPIncInertiaToUnbalance (double fact=1.0)

virtual void	addM_Force (const Vector &Udotdot, double fact=1.0)

virtual const Vector &	getTangForce (const Vector &x, double fact=1.0)

virtual const Vector &	getC_Force (const Vector &x, double fact=1.0)

virtual const Vector &	getM_Force (const Vector &x, double fact=1.0)

virtual const Vector &	getCommittedDisp (void)
	To return the committed displacement at the associated node. More...

virtual const Vector &	getCommittedVel (void)
	Return the committed velocity at the associated node. More...

virtual const Vector &	getCommittedAccel (void)
	Return the committed acceleration at the associated node. More...

virtual void	setNodeDisp (const Vector &u)
	Method to set the corresponding nodes displacements to the values in u, components identified by myID. More...

virtual void	setNodeVel (const Vector &udot)
	Method to set the corresponding nodes velocities to the values in udot, components identified by myID. More...

virtual void	setNodeAccel (const Vector &udotdot)
	Method to set the corresponding nodes accelerations to the values in udotdot, components identified by myID. More...

virtual void	incrNodeDisp (const Vector &u)
	Method to set the corresponding nodes displacements to the.

virtual void	incrNodeVel (const Vector &udot)
	Method to set the corresponding nodes velocities to the values in udot, components identified by myID. More...

virtual void	incrNodeAccel (const Vector &udotdot)

virtual void	setEigenvector (int mode, const Vector &eigenvalue)

virtual Matrix *	getT (void)

virtual void	addM_ForceSensitivity (const Vector &Udotdot, double fact=1.0)

virtual void	addD_ForceSensitivity (const Vector &vel, double fact=1.0)

virtual void	addD_Force (const Vector &vel, double fact=1.0)

virtual const Vector &	getDispSensitivity (int gradNumber)

virtual const Vector &	getVelSensitivity (int gradNumber)

virtual const Vector &	getAccSensitivity (int gradNumber)

virtual int	saveSensitivity (Vector v, Vector vdot, Vector *vdotdot, int gradNum, int numGrads)

virtual void	Print (std::ostream &, int=0)
	Print stuff.

virtual void	resetNodePtr (void)

Public Member Functions inherited from XC::TaggedObject
	TaggedObject (int tag, CommandEntity *owr=nullptr)
	Constructor. More...

virtual TaggedObject *	getCopy (void) const
	Virtual constructor.

void	assignTag (int newTag)
	Set tag (to be called from Python interface).

int	getTag (void) const
	Returns the tag associated with the object.

Protected Member Functions
void	addLocalM_Force (const Vector &Udotdot, double fact=1.0)

	DOF_Group (int tag, Node *myNode)
	Constructor that take the corresponding model node. More...

	DOF_Group (int tag, int ndof)
	Constructor. More...

Protected Member Functions inherited from XC::TaggedObject
void	setTag (int newTag)
	Set tag. More...

Protected Attributes
UnbalAndTangent	unbalAndTangent

Node *	myNode

Friends
class	AnalysisModel

Detailed Description

A DOF_Group object is instantiated by the ConstraintHandler for every unconstrained node in the domain.

The constrained nodes require specialised types of DOF_Group; which deal with the constraints. DOF_Group objects can handle 0 boundary constraints; if the eqn number of a DOF is less than START_EQN_NUM a value of 0.0 is set for disp, vel and accel when a setNode*(Vector &) is invoked.

Each node in the domain is associated with one DOF_Group. DOF_Groups are called upon in the analysis to provide their contributions of unbalanced load to the system of equations. Subclasses are used by the constraint handler to to introduce new dofs into the analysis.

The DOF_Group is responsible for providing operations to set and access the mapping betwwen equation numbers and DOFs, allowing the Integrator to from the tangent (if nodal masses in transient problem) and unbalanced load information, and for setting and obtaining the nodal trial response quantities.

Constructor & Destructor Documentation

§ DOF_Group() [1/2]

XC::DOF_Group::DOF_Group	(	int	tag,
		Node *	node
	)

protected

Constructor that take the corresponding model node.

Constructs a DOF_Group with an associated node given by {theNode} and a tag given by tag. During construction it determines the number of unknown dofs from the node, numDOF, and creates an Vector object to hold the unbalance information and an ID object to hold mapping between degrees-of-freedom and equation numbers. All values of the ID are set to \(-2\) initially. It creates a Vector to hold the unbalance loads and an ID to hold the mapping information, both of size equal to the number of unknowns. If the size of the Vector or the ID is \(0\), i.e. ran out of memory, a warning message is orinted and numDOF set to \(0\).

Parameters

tag	object identifier.
node	node associated to the DOF group.

§ DOF_Group() [2/2]

XC::DOF_Group::DOF_Group	(	int	tag,
		int	ndof
	)

protected

Constructor.

Provided for subclasses. Constructs a DOF_Group with the number of unknown dofs given by numDOF and a tag given by tag. No Node is associated with this DOF_Group. Creates a Vector of size {numDOF} to hold the unbalance information and an ID object to hold mapping between degrees-of-freedom and equation numbers. All values of the ID are set to \(-2\) initially. If the size of the Vector or the ID is \(0\), i.e. ran out of memory, a warning message is orinted and numDOF set to \(0\).

Member Function Documentation

§ addMtoTang()

void XC::DOF_Group::addMtoTang ( double fact = 1.0 )

virtual

To add fact times the nodal mass matrix to the tangent matrix.

To add fact times the nodal mass matrix to the tangent matrix. In this base class, if a Matrix to store the tangent has not yet been created, one of size (numDOF,numDOF) is now created; if construction of this matrix fails an error is printed and an error Matrix is returned. Invokes {addMatrix(theNode- \(>\)getMass,fact)} on the Matrix, printing a warining message if this method returns a \(negative\) value. If no Node is associated with the DOF_Group an error message is printed and nothing is done.

Reimplemented in XC::LagrangeDOF_Group.

§ addPtoUnbalance()

void XC::DOF_Group::addPtoUnbalance ( double fact = 1.0 )

virtual

Adds the product of the unbalanced load at the node and fact to the unbalance vector.

Adds the product of the unbalanced load at the node and fact to the unbalance vector. A warning message is printed and nothing is done if no node is associated with the DOF_Group, otherwise {addVector(theNode- \(>\)getUnbalancedLoad(),fact)} is invoked on the unbalance vector and a warning message is printed if this method returns a negative value.

Reimplemented in XC::LagrangeDOF_Group.

§ getCommittedAccel()

const XC::Vector & XC::DOF_Group::getCommittedAccel ( void )

virtual

Return the committed acceleration at the associated node.

Return the committed acceleration at the associated node. Returns result of invoking getAccel() on the Node. If there is no associated node object, an error message is printed and an error Vector is returned.

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ getCommittedDisp()

const XC::Vector & XC::DOF_Group::getCommittedDisp ( void )

virtual

To return the committed displacement at the associated node.

To return the committed displacement at the associated node. Returns the result of invoking getDisp() on the node. If there is no associated node object, an error message is printed and an error Vector is returned.

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ getCommittedVel()

const XC::Vector & XC::DOF_Group::getCommittedVel ( void )

virtual

Return the committed velocity at the associated node.

To return the committed velocity at the associated node. Returns the result of invoking getVel() on the node. If there is no associated node object, an error message is printed and an error Vector is returned.

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ getID()

const XC::ID & XC::DOF_Group::getID ( void ) const

virtual

Method to return the current ID.

A const member function which returns in an ID object the equation numbers associated with the degrees-of-freedom in the DOF_Group. The size of the ID object is equal to the number of degrees-of-freedom represented by the DOF_Group. This base class returns the ID created for the mapping.

Reimplemented in XC::TransformationDOF_Group.

§ getNodeTag()

int XC::DOF_Group::getNodeTag ( void ) const

virtual

Returns the tag of the associated node (-1 if there is no associated node).

§ getNumConstrainedDOF()

int XC::DOF_Group::getNumConstrainedDOF ( void ) const

virtual

Returns the total number of constrained DOFs.

Returns the total number of constrained DOFs in the DOF_Group, i.e. number of dof in the group who have been assigned a negative equation number. Determines this by looping through the ID containing the mapping information.

Reimplemented in XC::TransformationDOF_Group.

§ getNumFreeDOF()

int XC::DOF_Group::getNumFreeDOF ( void ) const

virtual

Returns the total number of free DOFs.

Returns the total number of free DOFs in the DOF_Group, i.e. number of dof in the group who have not been assigned a negative equation number. Determines this by looping through the ID containing the mapping information.

Reimplemented in XC::TransformationDOF_Group.

§ getTangent()

const XC::Matrix & XC::DOF_Group::getTangent ( Integrator * theIntegrator )

virtual

Returns the current tangent matrix for the DOF_Group.

Returns the current tangent matrix for the DOF_Group. If no tangent matrix has been created, one of size(numDOF,numDOF) is constructed. If not enough space is available for a new tangent matrix, an error message is printed and an error Matrix is returned..

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ incrNodeVel()

void XC::DOF_Group::incrNodeVel ( const Vector & udot )

virtual

Method to set the corresponding nodes velocities to the values in udot, components identified by myID.

These methods are similar to those three just outlined, the only difference being that the trial response quantities at the nodes are incremented, not set, with the values now given; this is done by invoking incrTrialDisp()}, {incrTrialVel(), and {incrTrialAccel()} respectivly on the nodes. MUST ALL CHANGE AS setNodeDisp.

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ setID() [1/2]

void XC::DOF_Group::setID	(	int	index,
		int	value
	)

virtual

to set the corresponding index of the ID to value.

Operation to set the equation number of the {dof'th} DOF in the DOF_Group to value. In this base class, if index is a valid location, \(0 < index < numDOF-1\) the operator {(index) = value} is invoked on the ID object created for the mapping, otherwise an error message is printed.

Reimplemented in XC::TransformationDOF_Group.

§ setID() [2/2]

void XC::DOF_Group::setID ( const ID & copy )

virtual

Method to set the ID to be same as that given.

An operation to set the equation numbers of all the DOFs in the DOF_Group to be those given in the ID values. In this base class, the operator {= values} is invoked on the ID object created for the mapping.

§ setNodeAccel()

void XC::DOF_Group::setNodeAccel ( const Vector & udotdot )

virtual

Method to set the corresponding nodes accelerations to the values in udotdot, components identified by myID.

This operation sets the value of the nodal trial acceleration at the associated node. The vector {\(u^{..}\)} is of size equal to the number of equations in the AnalysisModel (this is not checked by the DOF_Group). The DOF_Group object accesses the contents of the Vector {\(u^{..}\)} using its assigned equation numbers. If a \(-1\) exists for a DOF a \(0\) value is set as the corresponding nodal acceleration for the node. The return value is as outlined above for {setNodeAccel().} Creates a Vector to store the correct components of u, then invokes setTrialAccel() on the node object; if no node object an error message is printed. MUST CHANGE AS setNodeDisp

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ setNodeDisp()

void XC::DOF_Group::setNodeDisp ( const Vector & u )

virtual

Method to set the corresponding nodes displacements to the values in u, components identified by myID.

This operation sets the value of the nodal trial displacement at the associated node. The vector u is of size equal to the number of equations in the AnalysisModel (this is not checked by the DOF_Group). The DOF_Group object accesses the contents of the Vector u using its assigned equation numbers. If a \(-1\) exists for a DOF a \(0\) value is set as the corresponding nodal displacement for the node. Creates a Vector to store the correct components of u, then invokes setTrialDisp() on the node object; if no node object an error message is printed. CURRENTLY THERE IS NO CHECK TO SEE IF myID(i) DOES NOT OVERFLOW ADMISSABLE VALUES IN U - THIS NEEDS TO CHANGE

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ setNodeVel()

void XC::DOF_Group::setNodeVel ( const Vector & udot )

virtual

Method to set the corresponding nodes velocities to the values in udot, components identified by myID.

This operation sets the value of the nodal trial velocity at the associated node. The vector {\(u^{.}\)} is of size equal to the number of equations in the AnalysisModel (this is not checked by the DOF_Group). The DOF_Group object accesses the contents of the Vector {\(u^{.}\)} using its assigned equation numbers. If a \(-1\) exists for a DOF a \(0\) value is set as the corresponding nodal velocity for the node. Creates a Vector to store the correct components of u, then invokes setTrialVel() on the node object; if no node object an error message is printed. MUST CHANGE AS setNodeDisp

Reimplemented in XC::TransformationDOF_Group, and XC::LagrangeDOF_Group.

§ zeroTangent()

void XC::DOF_Group::zeroTangent ( void )

virtual

To zero the tangent matrix.

To zero the tangent. If a tangent matrix has been allocated, will invoke Zero() on the tangent matrix.

Reimplemented in XC::LagrangeDOF_Group.

§ zeroUnbalance()

void XC::DOF_Group::zeroUnbalance ( void )

virtual

To zero the unbalance vector.

To zero the unbalance vector. Invokes Zero() on the vector object used to store the unbalance information.

Reimplemented in XC::LagrangeDOF_Group.

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

src/solution/analysis/model/dof_grp/DOF_Group.h
src/solution/analysis/model/dof_grp/DOF_Group.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

§ DOF_Group() [1/2]

§ DOF_Group() [2/2]

Member Function Documentation

§ addMtoTang()

§ addPtoUnbalance()

§ getCommittedAccel()

§ getCommittedDisp()

§ getCommittedVel()

§ getID()

§ getNodeTag()

§ getNumConstrainedDOF()

§ getNumFreeDOF()

§ getTangent()

§ incrNodeVel()

§ setID() [1/2]

§ setID() [2/2]

§ setNodeAccel()

§ setNodeDisp()

§ setNodeVel()

§ zeroTangent()

§ zeroUnbalance()