Integratior used to perform a static analysis using the load control method. More...

#include <LoadControl.h>

Inheritance diagram for XC::LoadControl:

Public Member Functions
int	newStep (void)
	Perform a new analysis step. More...

int	update (const Vector &deltaU)
	Update the model state. More...

void	setDeltaLambda (const double &)
	Sets deltaLambda and updates dLamdaMin and dLambdaMax values.

double	getDeltaLambda (void) const

void	setDeltaLambdaMin (const double &)
	Sets the value of the minimum increment factor.

double	getDeltaLambdaMin (void) const

void	setDeltaLambdaMax (const double &)
	Sets the value of the maximum increment factor.

double	getDeltaLambdaMax (void) const

int	sendSelf (CommParameters &)
	Send the object. More...

int	recvSelf (const CommParameters &)
	Receive the object. More...

void	Print (std::ostream &s, int flag=0)
	The object sends to \(os\) its type, the current value of \(\lambda\), and \(\delta \lambda\). More...

Public Member Functions inherited from XC::BaseControl
double	factor (void) const

Public Member Functions inherited from XC::StaticIntegrator
virtual int	formEleTangent (FE_Element *theEle)
	Asks the element being passed as parameter to build its tangent stiffness matrix. More...

virtual int	formEleResidual (FE_Element *theEle)
	To form the residual vector of the FE_Element. More...

virtual int	formNodTangent (DOF_Group *theDof)
	This should never be called in a static analysis. More...

virtual int	formNodUnbalance (DOF_Group *theDof)
	Form the unbalance vector for the DOF_Group. More...

Public Member Functions inherited from XC::IncrementalIntegrator
virtual int	formTangent (int statusFlag=CURRENT_TANGENT)
	Builds tangent stiffness matrix. More...

virtual int	formUnbalance (void)
	Builds the unbalanced load vector (right hand side of the equation). More...

virtual int	newStep (double deltaT)
	Invoked to inform the integrator that the transient analysis is proceeding to the next time step. More...

virtual int	commit (void)
	Invoked by the SolutionAlgorithm to inform the Integrator that current state of domain is on solution path. More...

virtual int	revertToLastStep (void)

virtual int	initialize (void)

virtual int	revertToStart ()

virtual int	getLastResponse (Vector &result, const ID &id)
	Returns the response on the DOFs being passed as parameter. More...

Public Member Functions inherited from XC::Integrator
virtual int	domainChanged (void)
	Make required changes when a change in the domain occurs. More...

Public Member Functions inherited from XC::MovableObject
	MovableObject (int classTag, int dbTag)
	Constructor. More...

	MovableObject (int classTag)
	Constructor. More...

	MovableObject (const MovableObject &)
	Copy constructor. Doesn't copy the dbTag.

MovableObject &	operator= (const MovableObject &)
	Assignment operator. Doesn't copy the dbTag.

int	getClassTag (void) const
	Return the class identifier.

int	getDbTag (void) const
	Return the object identifier in the database.

int	getDbTag (CommParameters &)
	Return the object identifier in the database.

void	setDbTag (int dbTag)
	Sets the object identifier in the database.

void	setDbTag (CommParameters &)
	Sets the object identifier in the database if not already set. More...

virtual int	setParameter (const std::vector< std::string > &argv, Parameter &param)
	Sets the value `param` to the parameter `argv`.

virtual int	updateParameter (int parameterID, Information &info)
	Updates the parameter identified by `parameterID` with `info`.

virtual int	activateParameter (int parameterID)
	Activates the parameter identified by `parameterID`.

virtual int	setVariable (const std::string &variable, Information &)
	Set the value of the variable idenfified by `var`.

virtual int	getVariable (const std::string &variable, Information &)
	Return the value of the variable idenfified by `var`.

Public Member Functions inherited from XC::DistributedBase
	DistributedBase (void)
	Constructor.

virtual DbTagData &	getDbTagData (void) const
	Returns a vector to store class dbTags.

const int &	getDbTagDataPos (const int &i) const
	Returns the data at the i-th position.

void	setDbTagDataPos (const int &i, const int &v)
	Sets the data at the i-th position.

void	inicComm (const int &dataSize) const
	Initializes communication.

Protected Member Functions
int	sendData (CommParameters &)
	Send object members through the channel being passed as parameter.

int	recvData (const CommParameters &)
	Receives object members through the channel being passed as parameter.

	LoadControl (AnalysisAggregation *, double deltaLambda=1.0, int numIncr=1, double minLambda=1.0, double maxlambda=1.0)
	Constructor. More...

Integrator *	getCopy (void) const

Protected Member Functions inherited from XC::BaseControl
int	sendData (CommParameters &)
	Send object members through the channel being passed as parameter.

int	recvData (const CommParameters &)
	Receives object members through the channel being passed as parameter.

void	setup_numIncr (const int &)

	BaseControl (AnalysisAggregation *, int classTag, int numIncr=1)
	Constructor. More...

Protected Member Functions inherited from XC::StaticIntegrator
	StaticIntegrator (AnalysisAggregation *, int classTag)
	Constructor. More...

Protected Member Functions inherited from XC::IncrementalIntegrator
LinearSOE *	getLinearSOEPtr (void)
	Returns a pointer to the linear system of equations. More...

const LinearSOE *	getLinearSOEPtr (void) const
	Returns a pointer to the linear system of equations. More...

virtual int	formNodalUnbalance (void)
	Builds the nodal unbalanced load vector. More...

	IncrementalIntegrator (AnalysisAggregation *, int classTag)
	Constructor. More...

virtual int	formElementResidual (void)
	Builds the unbalanced load vector of the elements. More...

Protected Member Functions inherited from XC::Integrator
AnalysisAggregation *	getAnalysisAggregation (void)
	Returns a pointer to the solution method that owns this object.

const AnalysisAggregation *	getAnalysisAggregation (void) const
	Returns a const pointer to the solution method that owns this object.

void	applyLoadModel (double newTime)

int	updateModel (void)

int	updateModel (double newTime, double dT)

int	commitModel (void)

double	getCurrentModelTime (void)

void	setCurrentModelTime (const double &t)

void	setRayleighDampingFactors (const RayleighDampingFactors &rF)

int	sendData (CommParameters &)
	Send object members through the channel being passed as parameter.

int	recvData (const CommParameters &)
	Receives object members through the channel being passed as parameter.

virtual AnalysisModel *	getAnalysisModelPtr (void)
	Returns a pointer to the analysis model. More...

virtual const AnalysisModel *	getAnalysisModelPtr (void) const
	Returns a pointer to the analysis model. More...

	Integrator (AnalysisAggregation *, int classTag)
	Constructor. More...

Friends
class	AnalysisAggregation

class	FEM_ObjectBroker

Additional Inherited Members
Protected Attributes inherited from XC::BaseControl
double	specNumIncrStep
	Jd factor relating load increment at subsequent time steps. (optional, default: 1.0)

double	numIncrLastStep
	J(i-1).

Protected Attributes inherited from XC::IncrementalIntegrator
int	statusFlag

Detailed Description

Integratior used to perform a static analysis using the load control method.

Sets the incremental factor to apply on the loads for each analysis step.

LoadControl is a subclass of StaticIntegrator, it is used to when performing a static analysis on the FE_Model using the load control method. In the load control method, the following constraint equation is added to equation~staticFormTaylor} of the StaticIntegrator class:

[ ^{(i)} - {n-1} = ]

where \(\delta \lambda_n\) depends on \(\delta \lambda_{n-1}\) the load increment at the previous time step, \(J_{n-1}\), the number of iterations required to achieve convergence in the previous load step, and \(Jd\), the desired number of iteraions. \(\delta \lambda_n\) is bounded by \(\delta \lambda_{min}\) and \(\delta \lambda_{max}\).

[ = max ( {min}, min ( {Jd}{J_{n-1}} {n-1}, {max} ) ) ]

Knowing \(\lambda_n^{(i)}\) prior to each iteration, the \(N+1\) unknowns in equation~staticFormTaylor}, is reduced to \(N\) unknowns and results in the following equation:

{equation} R(U_{n}) = ^{(i)} P

{R}(U_{n}^{(i)} ) - K_n^{(i)} (U_{n} - U_{n}^{(i)}) {staticFormLoadControl} {equation}

Constructor & Destructor Documentation

§ LoadControl()

XC::LoadControl::LoadControl	(	AnalysisAggregation *	owr,
		double	dLambda = `1.0`,
		int	numIncr = `1`,
		double	min = `1.0`,
		double	max = `1.0`
	)

protected

Constructor.

Parameters

owr	analysis aggregation that will own this object.
dLambda	load factor used in the first step.
numIncr	number of load increments.
min	minimum value for the load factor at each step.
max	maximum value for the load factor at each step.

Member Function Documentation

§ newStep()

int XC::LoadControl::newStep ( void )

virtual

Perform a new analysis step.

The object obtains the current value of \(\lambda\) from the AnalysisModel object. It increments this by \(\delta \lambda_n \).

[ = max ( {min}, min ( {Jd}{J_{n-1}} {n-1}, {max} ) ) ]

It will then invoke {applyLoadDomain(0.0, \(\lambda\))} on the AnalysisModel object. Returns \(0\) if successful. A warning message is printed and a \(-1\) is returned if no AnalysisModel is associated with the object.

Implements XC::StaticIntegrator.

§ Print()

void XC::LoadControl::Print	(	std::ostream &	os,
		int	flag = `0`
	)

virtual

The object sends to \(os\) its type, the current value of \(\lambda\), and \(\delta \lambda\).

Reimplemented from XC::Integrator.

§ recvSelf()

int XC::LoadControl::recvSelf ( const CommParameters & cp )

virtual

Receive the object.

Each object has to receive the data needed to be able to recreate itself in the new process after it has been sent through cp. If the object is an aggregation containing other objects, new objects of the correct type can be constructed using #theBroker. To return 0 if successful or a -1 if not.

Implements XC::MovableObject.

§ sendSelf()

int XC::LoadControl::sendSelf ( CommParameters & cp )

virtual

Send the object.

Each object has to send the data needed to be able to reproduce that object in a remote process. The object uses the methods provided by cp object to send the data to another channel at the remote actor, the address of the channel is set before this method is called. An object of similar type at the remote actor is invoked with a receiveSelf() to receive the data. Returns 0 if successful (successful in that the data got to the channel), or a - if no data was sent.

Implements XC::MovableObject.

§ update()

int XC::LoadControl::update ( const Vector & deltaU )

virtual

Update the model state.

Invoked this causes the object to first increment the DOF_Group displacements with \(\Delta U\), by invoking {incrDisp( \(\Delta U)\)} on the AnalysisModel, and then to update the domain, by invoking {updateDomain()} on the AnalysisModel. Returns \(0\) if successful, a warning message and a \(-1\) is returned if no AnalysisModel is associated with the object.

Implements XC::IncrementalIntegrator.

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

src/solution/analysis/integrator/static/LoadControl.h
src/solution/analysis/integrator/static/LoadControl.cpp

Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

§ LoadControl()

Member Function Documentation

§ newStep()

§ Print()

§ recvSelf()

§ sendSelf()

§ update()