MBSim

Project Page
Public Member Functions | Protected Attributes
MBSim::Link Class Reference

general link to one or more objects More...

#include <link.h>

Inheritance diagram for MBSim::Link:
MBSim::Element MBSim::ExternGeneralizedIO MBSim::LinkMechanics MBSim::Contact MBSim::Gear MBSim::Gearing MBSim::Joint MBSim::KineticExcitation MBSim::MaxwellContact MBSim::RelativeRotationalSpringDamper MBSim::SpringDamper

List of all members.

Public Member Functions

 Link (const std::string &name)
 constructor
virtual ~Link ()
 destructor
virtual void updateg (double t)=0
virtual void updategd (double t)=0
virtual void updatewb (double t, int i=0)
virtual void updateW (double t, int i=0)
virtual void updateV (double t, int i=0)
virtual void updateh (double t, int i=0)
virtual void updateStopVector (double t)
virtual void updateLinkStatus (double t)
virtual void updateLinkStatusReg (double t)
virtual void updateJacobians (double t, int j=0)
virtual void updateb (double t)
virtual void updatedx (double t, double dt)
virtual void updatexd (double t)
virtual void calcxSize ()
virtual const fmatvec::Vec & getx () const
virtual fmatvec::Vec & getx ()
virtual void setxInd (int xInd_)
virtual int getxSize () const
virtual void updatexRef (const fmatvec::Vec &ref)
virtual void updatexdRef (const fmatvec::Vec &ref)
virtual void updatebRef (const fmatvec::Mat &hRef)
virtual void init (InitStage stage)
 plots time series header
virtual void initz ()
virtual void setbInd (int bInd_)
std::string getType () const
virtual void plot (double t, double dt=1)
 plots time dependent data
virtual void closePlot ()
 closes plot file
virtual void updateWRef (const fmatvec::Mat &ref, int i=0)=0
 references to contact force direction matrix of dynamic system parent
virtual void updateVRef (const fmatvec::Mat &ref, int i=0)=0
 references to condensed contact force direction matrix of dynamic system parent
virtual void updatehRef (const fmatvec::Vec &hRef, int i=0)=0
 references to complete and link smooth force vector of dynamic system parent
virtual void updaterRef (const fmatvec::Vec &ref, int i=0)=0
 references to nonsmooth force vector of dynamic system parent
virtual void updatewbRef (const fmatvec::Vec &ref)
 references to TODO of dynamic system parent
virtual void updatefRef (const fmatvec::Vec &ref)
 references to TODO of dynamic system parent
virtual void updatelaRef (const fmatvec::Vec &ref)
 references to contact force parameter of dynamic system parent
virtual void deletelaRef ()
 delete reference to contact force parameter of dynamic system parent
virtual void updategRef (const fmatvec::Vec &ref)
 references to contact relative distances of dynamic system parent
virtual void updategdRef (const fmatvec::Vec &ref)
 references to contact relative velocities of dynamic system parent
virtual void updateresRef (const fmatvec::Vec &ref)
 references to residuum of nonlinear contact equations of dynamic system parent
virtual void updaterFactorRef (const fmatvec::Vec &ref)
 references to rfactors of dynamic system parent
virtual void updatesvRef (const fmatvec::Vec &sv)
 references to stopvector of dynamic system parent (root function for event driven integration)
virtual void updatejsvRef (const fmatvec::Vector< int > &jsvParent)
 references to stopvector evaluation of dynamic system parent (root detection with corresponding bool array by event driven integrator)
virtual void updateLinkStatusRef (const fmatvec::Vector< int > &LinkStatusParent)
 reference to vector of link status (for set valued links with piecewise link equations)
virtual void updateLinkStatusRegRef (const fmatvec::Vector< int > &LinkStatusRegParent)
 reference to vector of link status (for single-valued links)
virtual void calclaSize (int j)
 calculates size of contact force parameters
virtual void calcgSize (int j)
 calculates size of relative distances
virtual void calcgdSize (int j)
 calculates size of relative velocities
virtual void calcrFactorSize (int j)
 calculates size of rfactors
virtual void calcbSize ()
 calculates size of rfactors
virtual void calcsvSize ()
 calculates size of stopvector (root function for event driven integration)
virtual void calcLinkStatusSize ()
 calculates size of vector LinkStatus
virtual void calcLinkStatusRegSize ()
 calculates size of vector LinkStatusReg
virtual bool isSetValued () const
virtual bool hasSmoothPart () const
virtual bool isActive () const =0
virtual bool gActiveChanged ()=0
virtual void solveImpactsFixpointSingle (double dt)
 solve contact equations of motion with single step fixed point scheme on velocity level
virtual void solveConstraintsFixpointSingle ()
 solve contact equations of motion with single step fixed point scheme on acceleration level
virtual void solveImpactsGaussSeidel (double dt)
 solve contact equations of motion with Gauss-Seidel scheme on velocity level
virtual void solveConstraintsGaussSeidel ()
 solve contact equations of motion with Gauss-Seidel scheme on acceleration level
virtual void solveImpactsRootFinding (double dt)
 solve contact equations of motion with Newton scheme on velocity level
virtual void solveConstraintsRootFinding ()
 solve contact equations of motion with Newton scheme on acceleration level
virtual void jacobianConstraints ()
 computes JACOBIAN and mass action matrix of nonlinear contact equations on acceleration level
virtual void jacobianImpacts ()
 computes JACOBIAN and mass action matrix of nonlinear contact equations on velocity level
virtual void updaterFactors ()
 updates rfactor relaxation for contact equations
virtual void checkImpactsForTermination (double dt)
 verify underlying force laws on velocity level concerning given tolerances
virtual void checkConstraintsForTermination ()
 verify underlying force laws on acceleration level concerning given tolerances
virtual void checkActive (int j)
 sets the state of a set-valued link, e.g.
virtual double computePotentialEnergy ()
 compute potential energy
virtual void setlaTol (double tol)
virtual void setLaTol (double tol)
virtual void setgTol (double tol)
virtual void setgdTol (double tol)
virtual void setgddTol (double tol)
virtual void setrMax (double rMax_)
const std::vector< fmatvec::Mat > & getW (int i=0) const
const std::vector< fmatvec::Mat > & getV (int i=0) const
const std::vector< fmatvec::Vec > & geth (int i=0) const
void setx (const fmatvec::Vec &x_)
const fmatvec::Vec & getxd () const
void setsvInd (int svInd_)
int getsvSize () const
void setLinkStatusInd (int LinkStatusInd_)
int getLinkStatusSize () const
void setLinkStatusRegInd (int LinkStatusRegInd_)
int getLinkStatusRegSize () const
const fmatvec::Vec & getla () const
fmatvec::Vec & getla ()
void setlaInd (int laInd_)
int getlaInd () const
int getlaSize () const
int getbSize () const
const fmatvec::Index & getlaIndex () const
const fmatvec::Vec & getg () const
fmatvec::Vec & getg ()
void setgInd (int gInd_)
const fmatvec::Vec & getgd () const
fmatvec::Vec & getgd ()
void setgdInd (int gdInd_)
int getgdInd () const
int getgSize () const
int getgdSize () const
const fmatvec::Index & getgIndex () const
void setrFactorInd (int rFactorInd_)
int getrFactorSize () const
const fmatvec::Vector< int > & getrFactorUnsure () const
void savela (double dt=1.0)
 saves contact force parameters for use as starting value in next time step
void initla (double dt=1.0)
 load contact force parameters for use as starting value
void decreaserFactors ()
 decrease rfactor if mass action matrix is not diagonal dominant (cf.
virtual Element * getByPathSearch (std::string path)
virtual void LinearImpactEstimation (fmatvec::Vec &gInActive_, fmatvec::Vec &gdInActive_, int *IndInActive_, fmatvec::Vec &gAct_, int *IndActive_)
 get gap distance and calculate gap velocity of unilateral links to estimate impacts within the next step
virtual void SizeLinearImpactEstimation (int *sizeInActive_, int *sizeActive_)
 calculates the number of active and inactive unilateral constraints and increments sizeActive/sizeInActive
virtual void updatecorr (int j)
virtual void updatecorrRef (const fmatvec::Vec &ref)
virtual void calccorrSize (int j)
void setcorrInd (int corrInd_)
int getcorrSize () const
virtual void checkRoot ()
- Public Member Functions inherited from MBSim::Element
 Element (const std::string &name)
 constructor
virtual ~Element ()
 destructor
virtual void initDataInterfaceBase (DynamicSystemSolver *parentds)
 TODO.
virtual void setDynamicSystemSolver (DynamicSystemSolver *sys)
virtual void plotAtSpecialEvent (double t, double dt=1)
 plots time dependent data at special events
const std::string & getName () const
const std::string getShortName () const
void setName (const std::string &str)
DynamicSystemSolver * getDynamicSystemSolver ()
virtual void createPlotGroup ()
 creates the plotGroup for H5-output
H5::Group * getPlotGroup ()
virtual void setPlotFeature (PlotFeature pf, PlotFeatureStatus value)
 Set a plot feature.
void setPlotFeatureForChildren (PlotFeature pf, PlotFeatureStatus value)
 Set a plot feature for the children of this object.
void setPlotFeatureRecursive (PlotFeature pf, PlotFeatureStatus value)
 Set a plot feature for this object and the children of this object.
PlotFeatureStatus getPlotFeature (PlotFeature pf)
PlotFeatureStatus getPlotFeatureForChildren (PlotFeature pf)
virtual void initializeUsingXML (TiXmlElement *element)
template<class T >
T * getByPath (std::string path)
 a general element access
virtual Element * getParent ()
virtual const Element * getParent () const
virtual void setParent (Element *parent_)
std::string getPath (char pathDelim='.')

Protected Attributes

fmatvec::Vec x
 order one parameters
fmatvec::Vec xd
 differentiated order one parameters
fmatvec::Vec x0
 order one initial value
int xSize
 size and local index of order one parameters
int xInd
fmatvec::Vec sv
 stop vector for event driven integration (root function)
fmatvec::Vector< int > jsv
 evaluation of roots of stop vector with a boolean vector
int svSize
 size and local index of stop vector
int svInd
fmatvec::Vector< int > LinkStatus
 for set valued links with piecewise link equation (e.g.
int LinkStatusSize
 size and local index of link status vector (set-valued)
int LinkStatusInd
fmatvec::Vector< int > LinkStatusReg
 for single valued links
int LinkStatusRegSize
 size and local index of single-valued link status vector
int LinkStatusRegInd
fmatvec::Vec g
 relative distance, relative velocity, contact force parameters
fmatvec::Vec gd
fmatvec::Vec la
int gSize
 size and local index of relative distances
int gInd
int gdSize
 size and local index of relative velocities
int gdInd
int laSize
 size and local index of contact force parameters
int laInd
int bSize
 size and local index of contact force parameters
int bInd
fmatvec::Index Ig
 local index of relative distances and contact force parameters
fmatvec::Index Ila
double gTol
 tolerance for relative velocity, relative acceleration, force and impact
double gdTol
double gddTol
double laTol
double LaTol
fmatvec::Vec la0
 attribute to save contact force parameter of previous time step
fmatvec::Vec rFactor
 vector of rfactors for relaxation of contact equations
fmatvec::Vector< int > rFactorUnsure
 boolean vector defining if rfactor belongs to not diagonal dominant mass action matrix (cf.
int rFactorSize
 size and local index of rfactors
int rFactorInd
double rMax
 maximum r-factor
fmatvec::Vec res
 residuum of nonlinear contact equations
std::vector< fmatvec::Mat > W [2]
 force direction matrix for nonsmooth right hand side
std::vector< fmatvec::Mat > V [2]
 reduced force direction matrix for nonsmooth right hand side
std::vector< fmatvec::Vec > h [2]
 smooth complete and link right hand side
std::vector< fmatvec::Mat > dhdq
 smooth Jacobians for implicit integration
std::vector< fmatvec::Mat > dhdu
std::vector< fmatvec::Vec > dhdt
std::vector< fmatvec::Vec > r [2]
 nonsmooth right hand side
fmatvec::Vec wb
 TODO.
fmatvec::Mat b
 TODO.
int corrSize
int corrInd
fmatvec::Vec corr
- Protected Attributes inherited from MBSim::Element
Element * parent
std::string name
 name of element
DynamicSystemSolver * ds
 dynamic system
H5::VectorSerie< double > * plotVectorSerie
 time series
std::vector< double > plotVector
 one entry of time series
std::vector< std::string > plotColumns
 columns of time series
H5::Group * plotGroup
 associated plot group

Additional Inherited Members

- Static Public Member Functions inherited from MBSim::Element
static double getDouble (TiXmlElement *e)
static int getInt (TiXmlElement *e)
static bool getBool (TiXmlElement *e)
static fmatvec::Vec getVec (TiXmlElement *e, int rows=0)
static fmatvec::Mat getMat (TiXmlElement *e, int rows=0, int cols=0)
static fmatvec::SqrMat getSqrMat (TiXmlElement *e, int size=0)
static fmatvec::SymMat getSymMat (TiXmlElement *e, int size=0)
- Protected Member Functions inherited from MBSim::Element
void updatePlotFeatures ()

Detailed Description

general link to one or more objects

Author:
Martin Foerg
Date:
2009-03-26 some comments (Thorsten Schindler)
2009-04-06 ExtraDynamicInterface included / LinkMechanics added (Thorsten Schindler)
2009-07-16 splitted link / object right hand side (Thorsten Schindler)
2009-07-27 enhanced structure for implicit integration (Thorsten Schindler)
2009-07-28 splitted interfaces (Thorsten Schindler)
2009-12-14 revised inverse kinetics (Martin Foerg)
2010-07-06 added LinkStatus and LinearImpactEstimation for timestepper ssc (Robert Huber)
2012-05-08 added LinkStatusReg for AutoTimeSteppingSSCIntegrator (Jan Clauberg)

Constructor & Destructor Documentation

MBSim::Link::Link ( const std::string &  name)

constructor

Parameters:
nameof link

Member Function Documentation

virtual void MBSim::Link::checkActive ( int  j)
inlinevirtual

sets the state of a set-valued link, e.g.

contact stays closed or contact will slide

Reimplemented in MBSim::Contact.

void MBSim::Link::decreaserFactors ( )

decrease rfactor if mass action matrix is not diagonal dominant (cf.

Foerg: Dissertation, page 80 et seq.)

virtual bool MBSim::Link::gActiveChanged ( )
pure virtual
virtual Element* MBSim::Link::getByPathSearch ( std::string  path)
virtual
Returns:
a general element access

Reimplemented from MBSim::Element.

std::string MBSim::Link::getType ( ) const
inlinevirtual
virtual bool MBSim::Link::hasSmoothPart ( ) const
inlinevirtual
Returns:
updateh is needed if set valued force law is not active?
virtual void MBSim::Link::init ( InitStage  stage)
virtual
virtual bool MBSim::Link::isActive ( ) const
pure virtual
virtual bool MBSim::Link::isSetValued ( ) const
inlinevirtual
Returns:
set valued force laws used?

Reimplemented in MBSim::Contact, MBSim::MaxwellContact, MBSim::Joint, MBSim::Gearing, and MBSim::Gear.

virtual void MBSim::Link::LinearImpactEstimation ( fmatvec::Vec &  gInActive_,
fmatvec::Vec &  gdInActive_,
int *  IndInActive_,
fmatvec::Vec &  gAct_,
int *  IndActive_ 
)
inlinevirtual

get gap distance and calculate gap velocity of unilateral links to estimate impacts within the next step

Parameters:
gInActivegap distance of inactive links (return)
gdInActivegap velocities of inactive links (return)
IndInActiveindex for gInActive/gdInActive; incremented with size after storage (return and input)
gActgap distance of active links (return)
IndActiveindex for gActive; incremented with size after storage (return and input)

Reimplemented in MBSim::Contact.

virtual void MBSim::Link::plot ( double  t,
double  dt = 1 
)
virtual

plots time dependent data

Parameters:
simulationtime
simulationtime step size for derivative calculation

Reimplemented from MBSim::Element.

Reimplemented in MBSim::Contact, MBSim::MaxwellContact, MBSim::Joint, MBSim::RelativeRotationalSpringDamper, MBSim::SpringDamper, MBSim::LinkMechanics, MBSim::Gearing, MBSim::KineticExcitation, MBSim::ExternGeneralizedIO, and MBSim::Gear.


Member Data Documentation

fmatvec::Vector<int> MBSim::Link::LinkStatus
protected

for set valued links with piecewise link equation (e.g.

unilateral contacts or coulomb friction) status of link (default 0) describing which pice of the equation is valid (e.g. stick or slip)

fmatvec::Vector<int> MBSim::Link::LinkStatusReg
protected

for single valued links

status of link

fmatvec::Vector<int> MBSim::Link::rFactorUnsure
protected

boolean vector defining if rfactor belongs to not diagonal dominant mass action matrix (cf.

Foerg Dissertation, page 80 et seq.)


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