Integrator Class Reference

The Integrator class is basically a wrapper of the DomainBase class with regard to some status changing methods. More...

#include <Integrator.h>

Inheritance diagram for Integrator:

Collaboration diagram for Integrator:

Public Member Functions
	Integrator (unsigned=0)
	Integrator (const Integrator &)=delete
	Integrator (Integrator &&)=delete
Integrator &	operator= (const Integrator &)=delete
Integrator &	operator= (Integrator &&)=delete
	~Integrator () override
void	set_domain (const weak_ptr< DomainBase > &)
const weak_ptr< DomainBase > &	get_domain () const
virtual int	initialize ()
void	set_time_step_switch (bool)
bool	allow_to_change_time_step () const
virtual int	process_load ()
virtual int	process_constraint ()
virtual int	process_criterion ()
virtual int	process_modifier ()
virtual int	process_load_resistance ()
virtual int	process_constraint_resistance ()
void	record () const
virtual void	assemble_resistance ()
virtual void	assemble_matrix ()
virtual vec	get_force_residual ()
virtual vec	get_displacement_residual ()
virtual vec	get_auxiliary_residual ()
virtual sp_mat	get_reference_load ()
virtual sp_mat	get_auxiliary_stiffness ()
virtual void	update_load ()
virtual void	update_constraint ()
virtual void	update_trial_load_factor (double)
virtual void	update_trial_load_factor (const vec &)
virtual void	update_trial_displacement (const vec &)
void	update_trial_time (double)
void	update_incre_time (double)
virtual int	update_trial_status ()
virtual int	update_incre_status ()
virtual int	update_internal (const mat &)
mat	solve (const mat &)
mat	solve (const sp_mat &)
mat	solve (mat &&)
mat	solve (sp_mat &&)
virtual int	solve (mat &, const mat &)
virtual int	solve (mat &, const sp_mat &)
virtual int	solve (mat &, mat &&)
virtual int	solve (mat &, sp_mat &&)
virtual void	erase_machine_error () const
virtual void	stage_and_commit_status ()
virtual void	stage_status ()
virtual void	commit_status ()
virtual void	clear_status ()
virtual void	reset_status ()
virtual void	update_parameter (double)
virtual void	update_compatibility () const
virtual vec	from_incre_velocity (const vec &, const uvec &)
virtual vec	from_incre_acceleration (const vec &, const uvec &)
vec	from_total_velocity (const vec &, const uvec &)
vec	from_total_acceleration (const vec &, const uvec &)
vec	from_incre_velocity (double, const uvec &)
vec	from_incre_acceleration (double, const uvec &)
vec	from_total_velocity (double, const uvec &)
vec	from_total_acceleration (double, const uvec &)
Public Member Functions inherited from Tag
	Tag (unsigned=0)
	Tag (const Tag &)=default
	Tag (Tag &&)=default
Tag &	operator= (const Tag &)=delete
Tag &	operator= (Tag &&)=delete
virtual	~Tag ()=default
void	set_tag (unsigned) const
unsigned	get_tag () const
void	enable ()
void	disable ()
void	guard ()
void	unguard ()
bool	is_active () const
bool	is_guarded () const
virtual void	print ()

Detailed Description

The Integrator class is basically a wrapper of the DomainBase class with regard to some status changing methods.

By default, the Step object calls DomainBase(Workshop) object to update displacement/resistance/stiffness independently. When it comes to dynamic analysis (time integration is involved), it is necessary to compute the equivalent load/stiffness by combining several quantities.

The Integrator object is acting like an agent between Workshop and Step, that can modify corresponding quantities to account for dynamic effect.

Author

tlc

Date

27/08/2017

Version

0.1.2

Constructor & Destructor Documentation

Integrator() [1/3]

Integrator::Integrator ( unsigned  T = 0 )

explicit

Here is the call graph for this function:

Integrator() [2/3]

Integrator::Integrator ( const Integrator &  )

delete

Integrator() [3/3]

Integrator::Integrator ( Integrator &&  )

delete

~Integrator()

Integrator::~Integrator ( )

override

Here is the call graph for this function:

Member Function Documentation

allow_to_change_time_step()

bool Integrator::allow_to_change_time_step

(

)

const

Some time integration methods (multistep methods) require time step to be constant (for at least some consecutive steps). Call this method in solvers to determine whether it is allowed to change time step.

assemble_matrix()

void Integrator::assemble_matrix ( )

virtual

Assemble the global effective matrix A in AX=B. For FEM applications, it is often a linear combination of stiffness, mass, damping and geometry matrices.

Reimplemented in WilsonPenzienNewmark, Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

assemble_resistance()

void Integrator::assemble_resistance ( )

virtual

Reimplemented in WilsonPenzienNewmark, RayleighNewmark, Newmark, LeeNewmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

clear_status()

void Integrator::clear_status ( )

virtual

Reimplemented in WilsonPenzienNewmark, BatheTwoStep, and LeeNewmarkBase.

Here is the call graph for this function:

Here is the caller graph for this function:

commit_status()

void Integrator::commit_status ( )

virtual

Reimplemented in WilsonPenzienNewmark, BatheTwoStep, and LeeNewmarkBase.

Here is the call graph for this function:

Here is the caller graph for this function:

erase_machine_error()

void Integrator::erase_machine_error ( ) const

virtual

Avoid machine error accumulation. The penalty method can apply homogeneous constraints approximately. The corresponding DoF shall be set to zero after solving the system.

from_incre_acceleration() [1/2]

vec Integrator::from_incre_acceleration ( const vec &  , const uvec &  encoding  )

virtual

When external loads are applied, they can be applied in forms of displacement/velocity/acceleration. The time integration methods, by default, form effective stiffness matrices in displacement domain. That is, in AX=B, A is the effective stiffness matrix and X is the displacement increment. Thus, loads in velocity/acceleration must be converted to displacement. This cannot be done arbitrarily due to compatibility issues. This method takes acceleration increment and converts it to displacement increment.

Reimplemented in Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

Here is the caller graph for this function:

from_incre_acceleration() [2/2]

vec Integrator::from_incre_acceleration	(	double	magnitude,
		const uvec &	encoding
	)

A simplified version similar to from_incre_acceleration(const vec&, const uvec&). It assumes all DoFs share the same magnitude.

Here is the call graph for this function:

from_incre_velocity() [1/2]

vec Integrator::from_incre_velocity ( const vec &  , const uvec &  encoding  )

virtual

When external loads are applied, they can be applied in forms of displacement/velocity/acceleration. The time integration methods, by default, form effective stiffness matrices in displacement domain. That is, in AX=B, A is the effective stiffness matrix and X is the displacement increment. Thus, loads in velocity/acceleration must be converted to displacement. This cannot be done arbitrarily due to compatibility issues. This method takes velocity increment and converts it to displacement increment.

Reimplemented in Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

Here is the caller graph for this function:

from_incre_velocity() [2/2]

vec Integrator::from_incre_velocity	(	double	magnitude,
		const uvec &	encoding
	)

A simplified version similar to from_incre_velocity(const vec&, const uvec&). It assumes all DoFs share the same magnitude.

Here is the call graph for this function:

from_total_acceleration() [1/2]

vec Integrator::from_total_acceleration	(	const vec &	total_acceleration,
		const uvec &	encoding
	)

Here is the call graph for this function:

Here is the caller graph for this function:

from_total_acceleration() [2/2]

vec Integrator::from_total_acceleration	(	double	magnitude,
		const uvec &	encoding
	)

Here is the call graph for this function:

from_total_velocity() [1/2]

vec Integrator::from_total_velocity	(	const vec &	total_velocity,
		const uvec &	encoding
	)

Here is the call graph for this function:

Here is the caller graph for this function:

from_total_velocity() [2/2]

vec Integrator::from_total_velocity	(	double	magnitude,
		const uvec &	encoding
	)

Here is the call graph for this function:

get_auxiliary_residual()

vec Integrator::get_auxiliary_residual ( )

virtual

Assemble the global residual vector due to nonlinear constraints implemented via the multiplier method.

Here is the call graph for this function:

get_auxiliary_stiffness()

sp_mat Integrator::get_auxiliary_stiffness ( )

virtual

get_displacement_residual()

vec Integrator::get_displacement_residual ( )

virtual

Assemble the global residual vector in displacement-controlled solving schemes. Apart from the global resistance and external load vectors, the reference load vector shall also be considered.

Reimplemented in LeeNewmarkBase.

Here is the caller graph for this function:

get_domain()

const weak_ptr< DomainBase > & Integrator::get_domain

(

)

const

Here is the caller graph for this function:

get_force_residual()

vec Integrator::get_force_residual ( )

virtual

Assemble the global residual vector in load-controlled solving schemes.

Reimplemented in LeeNewmarkBase.

Here is the caller graph for this function:

get_reference_load()

sp_mat Integrator::get_reference_load ( )

virtual

initialize()

int Integrator::initialize ( )

virtual

Reimplemented in WilsonPenzienNewmark, LeeNewmarkFull, LeeNewmarkBase, and LeeNewmark.

Here is the call graph for this function:

Here is the caller graph for this function:

operator=() [1/2]

Integrator& Integrator::operator= ( const Integrator &  )

delete

operator=() [2/2]

Integrator& Integrator::operator= ( Integrator &&  )

delete

process_constraint()

int Integrator::process_constraint ( )

virtual

The main task of this method is to apply constraints (of various forms implemented in various methods). Combinations of different types need to be considered: 1) homogeneous, 2) inhomogeneous, 3) linear, 4) nonlinear. Combinations of different methods need to be considered: 1) penalty, 2) multiplier. On exit, the global stiffness matrix should be updated, the global residual vector should be updated.

Reimplemented in WilsonPenzienNewmark, LeeNewmarkFull, LeeNewmark, GSSSS, and GeneralizedAlpha.

Here is the caller graph for this function:

process_constraint_resistance()

int Integrator::process_constraint_resistance ( )

virtual

This method is similar to process_constraint(), but it only updates the global residual vector. The global stiffness matrix is not touched as in some solving schemes, the global stiffness matrix is only assembled and factorised once at the beginning. Subsequent iterations do not assemble the global stiffness matrix again and reuse the factorised matrix. In this case, the factorised matrix cannot be modified.

Reimplemented in GSSSS, and GeneralizedAlpha.

Here is the caller graph for this function:

process_criterion()

int Integrator::process_criterion ( )

virtual

process_load()

int Integrator::process_load ( )

virtual

Reimplemented in GSSSS, and GeneralizedAlpha.

Here is the caller graph for this function:

process_load_resistance()

int Integrator::process_load_resistance ( )

virtual

Reimplemented in GSSSS, and GeneralizedAlpha.

Here is the caller graph for this function:

process_modifier()

int Integrator::process_modifier ( )

virtual

record()

void Integrator::record

(

)

const

reset_status()

void Integrator::reset_status ( )

virtual

Reimplemented in WilsonPenzienNewmark, and LeeNewmarkBase.

Here is the call graph for this function:

Here is the caller graph for this function:

set_domain()

void Integrator::set_domain

(

const weak_ptr< DomainBase > &

D

)

set_time_step_switch()

void Integrator::set_time_step_switch

(

bool

T

)

Here is the caller graph for this function:

solve() [1/8]

mat Integrator::solve

(

const mat &

B

)

Here is the caller graph for this function:

solve() [2/8]

mat Integrator::solve

(

const sp_mat &

B

)

Here is the call graph for this function:

solve() [3/8]

mat Integrator::solve

(

mat &&

B

)

Here is the call graph for this function:

solve() [4/8]

int Integrator::solve ( mat &  X, const mat &  B  )

virtual

Reimplemented in WilsonPenzienNewmark, and LeeNewmarkBase.

solve() [5/8]

int Integrator::solve ( mat &  X, const sp_mat &  B  )

virtual

Reimplemented in WilsonPenzienNewmark, and LeeNewmarkBase.

solve() [6/8]

int Integrator::solve ( mat &  X, mat &&  B  )

virtual

Reimplemented in WilsonPenzienNewmark, and LeeNewmarkBase.

solve() [7/8]

int Integrator::solve ( mat &  X, sp_mat &&  B  )

virtual

Reimplemented in WilsonPenzienNewmark, and LeeNewmarkBase.

solve() [8/8]

mat Integrator::solve

(

sp_mat &&

B

)

Here is the call graph for this function:

stage_and_commit_status()

void Integrator::stage_and_commit_status ( )

virtual

Here is the call graph for this function:

stage_status()

void Integrator::stage_status ( )

virtual

Reimplemented in GSSSS.

Here is the caller graph for this function:

update_compatibility()

void Integrator::update_compatibility ( ) const

virtual

Make sure that the trial displacement/velocity/acceleration are consistent with each other. When starting a new trial state, the trial displacement is identical to the current displacement. This essentially means that the displacement increment is zero. To have such a trial state with the given time step, the trial velocity and acceleration shall be updated to be compatible with the trial displacement.

On exit, trial velocity and acceleration should be computed from current/trial displacement.

Reimplemented in Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

Here is the caller graph for this function:

update_constraint()

void Integrator::update_constraint ( )

virtual

update_incre_status()

int Integrator::update_incre_status ( )

virtual

update_incre_time()

void Integrator::update_incre_time

(

double

T

)

Here is the call graph for this function:

update_internal()

int Integrator::update_internal ( const mat &  )

virtual

Must change ninja to the real displacement increment.

Reimplemented in LeeNewmarkBase.

update_load()

void Integrator::update_load ( )

virtual

update_parameter()

void Integrator::update_parameter ( double  )

virtual

When tim step changes, some parameters may need to be updated.

Reimplemented in Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

Here is the caller graph for this function:

update_trial_displacement()

void Integrator::update_trial_displacement ( const vec &  ninja )

virtual

Here is the call graph for this function:

update_trial_load_factor() [1/2]

void Integrator::update_trial_load_factor ( const vec &  lambda )

virtual

Here is the call graph for this function:

update_trial_load_factor() [2/2]

void Integrator::update_trial_load_factor ( double  lambda )

virtual

update_trial_status()

int Integrator::update_trial_status ( )

virtual

Reimplemented in Newmark, GSSSS, GeneralizedAlpha, and BatheTwoStep.

update_trial_time()

void Integrator::update_trial_time

(

double

T

)

Here is the call graph for this function:

---

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

• Solver/Integrator/Integrator.h
• Solver/Integrator/Integrator.cpp