MBSim

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

Half-explicit time-stepping integrator of first or higer order with StepSize Control (SSC) important options / settings : More...

#include <time_stepping_ssc_integrator.h>

Inheritance diagram for MBSim::TimeSteppingSSCIntegrator:
MBSim::Integrator

List of all members.

Public Member Functions

 TimeSteppingSSCIntegrator ()
 ~TimeSteppingSSCIntegrator ()
void setInitialStepSize (double dt_)
void setStepSizeMax (double dtMax_)
void setStepSizeMin (double dtMin_)
void setmaxGainSSC (double maxGain)
void setSafetyFactorSSC (double sfactor)
void setSafetyFactorGapControl (double s)
void setOutputInterpolation (bool flag=true)
void setFlagPlotIntegrator (bool flag=true)
void setGapControl (int strategy=1)
void setDriftCompensation (bool dc)
void setMaxOrder (int order_, int method_=0)
void deactivateSSC (bool flag=false)
void setFlagErrorTest (int Flag, bool alwaysValid=true)
void integrate (DynamicSystemSolver &system_)
void integrate (DynamicSystemSolver &systemT1_, DynamicSystemSolver &systemT2_, DynamicSystemSolver &systemT3_, int Threads=0)
void setAbsoluteTolerance (const fmatvec::Vec &aTol_)
void setAbsoluteTolerance (double aTol_)
void setRelativeTolerance (const fmatvec::Vec &rTol_)
void setRelativeTolerance (double rTol_)
void setgapTolerance (double gTol)
void preIntegrate (DynamicSystemSolver &system)
 subroutines for integrate function
void subIntegrate (DynamicSystemSolver &system, double tStop)
void postIntegrate (DynamicSystemSolver &system)
void preIntegrate (DynamicSystemSolver &systemT1_, DynamicSystemSolver &systemT2_, DynamicSystemSolver &systemT3_)
void getAllSetValuedla (fmatvec::Vec &la_, fmatvec::Vector< int > &la_Sizes, std::vector< MBSim::Link * > &SetValuedLinkList)
 internal subroutines
void setAllSetValuedla (const fmatvec::Vec &la_, const fmatvec::Vector< int > &la_Sizes, std::vector< MBSim::Link * > &SetValuedLinkList)
void getDataForGapControl ()
bool testTolerances ()
bool GapControl (double qUnsafe, bool SSCTestOK)
bool changedLinkStatus (const fmatvec::Vector< int > &L1, const fmatvec::Vector< int > &L2, int ex)
double calculatedtNewRel (const fmatvec::Vec &ErrorLocal, double H)
void plot ()
virtual void initializeUsingXML (TiXmlElement *element)
 initialize integrator
- Public Member Functions inherited from MBSim::Integrator
 Integrator ()
 constructor
virtual ~Integrator ()
 destructor
void setStartTime (double tStart_)
void setEndTime (double tEnd_)
void setPlotStepSize (double dtPlot_)
void setInitialState (const fmatvec::Vec &z0_)
void setWarnLevel (int level)
void setOutput (bool flag)
double getStartTime ()

Protected Attributes

DynamicSystemSolver * sysT1
DynamicSystemSolver * sysT2
DynamicSystemSolver * sysT3
double dt
double dtOld
double dte
double dtMin
double dtMax
double dt_SSC_vorGapControl
bool driftCompensation
double t
double tPlot
int qSize
int xSize
int uSize
int zSize
fmatvec::Vec ze
fmatvec::Vec zi
fmatvec::Vec zT1
fmatvec::Vec zT2
fmatvec::Vec zT3
fmatvec::Vec z1d
fmatvec::Vec z2d
fmatvec::Vec z2dRE
fmatvec::Vec z3d
fmatvec::Vec z4d
fmatvec::Vec z6d
fmatvec::Vec z2b
fmatvec::Vec z3b
fmatvec::Vec z4b
fmatvec::Vec z6b
fmatvec::Vec zStern
fmatvec::Vector< int > LS
fmatvec::Vector< int > LSe
fmatvec::Vector< int > LStmp_T1
fmatvec::Vector< int > LStmp_T2
fmatvec::Vector< int > LStmp_T3
fmatvec::Vector< int > LSA
fmatvec::Vector< int > LSB1
fmatvec::Vector< int > LSB2
fmatvec::Vector< int > LSC1
fmatvec::Vector< int > LSC2
fmatvec::Vector< int > LSC3
fmatvec::Vector< int > LSC4
fmatvec::Vector< int > LSD1
fmatvec::Vector< int > LSD2
fmatvec::Vector< int > LSD3
fmatvec::Vector< int > LSD4
fmatvec::Vector< int > LSD5
fmatvec::Vector< int > LSD6
fmatvec::Vec la
fmatvec::Vec lae
fmatvec::Vec la1d
fmatvec::Vec la2b
fmatvec::Vector< int > laSizes
fmatvec::Vector< int > laeSizes
fmatvec::Vector< int > la1dSizes
fmatvec::Vector< int > la2bSizes
fmatvec::Vec qT1
fmatvec::Vec qT2
fmatvec::Vec qT3
fmatvec::Vec uT1
fmatvec::Vec uT2
fmatvec::Vec uT3
fmatvec::Vec xT1
fmatvec::Vec xT2
fmatvec::Vec xT3
fmatvec::Vec gInActive
fmatvec::Vec gdInActive
std::vector< MBSim::Link * > SetValuedLinkListT1
std::vector< MBSim::Link * > SetValuedLinkListT2
std::vector< MBSim::Link * > SetValuedLinkListT3
int StepsWithUnchangedConstraints
int FlagErrorTest
 include (0) or exclude (3) variable u or scale (2) with stepsize for error test
bool FlagErrorTestAlwaysValid
 FlagErrorTest is always valid or only during nonsmooth steps.
fmatvec::Vec aTol
 Absolute Toleranz.
fmatvec::Vec rTol
 Relative Toleranz.
bool FlagSSC
 activate step size control
int maxOrder
 maximum order of integration scheme SSC by extrapolation (steps with differnt dt are compared): 1, 2, 3 SSC with embedded methods (differnt orders are compared): 1 to 4 [ 1= 1(2), ...
int method
 method for intrgration and step size control method=0 step size control by extrapolation (steps wit dt and dt/2 are compared) DEFAULT method=1 embedded method for step size control (maxOrder and maxOrder+1 are compared); proceed with maxOrder (recommended) method=2 embedded method for SSC with -local extrapolation- (integration is continued with maxOrder+1)
bool FlagGapControl
double gapTol
 Toleranz for closing gaps.
double maxGainSSC
 maximal gain factor for increasing dt by stepsize control (default 2.5; maxGain * safetyFactor must be GT 1)
double safetyFactorSSC
 safety factor for stepsize estimation: dt = dt_estimate * safetyFactorSSC (]0;1]; default 0.6)
std::ofstream integPlot
 filestream for integrator info at each step
bool FlagPlotIntegrator
 Flag: write integrator info at each step to a file (default true)
bool FlagPlotIntegrationSum
 Flag: write integration summary to a file (default true)
bool FlagCoutInfo
 Flag: write integration info (integ.
bool FlagPlotEveryStep
 every successful integration step is ploted (set dtPlot=0 to activate FlagPlotEveryStep) (default false)
bool outputInterpolation
 Flag interpolate z and la for plotting (default true)
double safetyFactorGapControl
 Safety factor for GapControl (dtNew = dt_gapcontrol*safetyFactor; default min(1+RTol,1.001)
int GapControlStrategy
 choose strategy for Gap Control (1:maximal Stepsize to 4:minimal Penetration) 1: uses biggest root (maximal dt) 2: score for all roots are evaluated 3: gapTol is used 4: uses smallest root (minimal penetration) 0: gap control deactivated
int numThreads
 Number of Threads.
double time
 computaional time
StopWatch Timer
 for internal use (start clock, integration info ...)
int iter
int iterA
int iterB1
int iterB2
int iterC1
int iterC2
int iterC3
int iterC4
int iterB2RE
int maxIterUsed
int maxIter
int sumIter
int integrationSteps
int integrationStepswithChange
int refusedSteps
int refusedStepsWithImpact
int wrongAlertGapControl
int stepsOkAfterGapControl
int stepsRefusedAfterGapControl
int statusGapControl
int singleStepsT1
int singleStepsT2
int singleStepsT3
double dtRelGapControl
double qUncertaintyByExtrapolation
int indexLSException
fmatvec::Vec gUniActive
double Penetration
double PenetrationCounter
double PenetrationLog
double PenetrationMin
double PenetrationMax
double maxdtUsed
double mindtUsed
bool ChangeByGapControl
bool calcBlock2
bool IterConvergence
bool ConstraintsChanged
bool ConstraintsChangedBlock1
bool ConstraintsChangedBlock2
int integrationStepsOrder1
int integrationStepsOrder2
int order
int StepTrials
int AnzahlAktiverKontakte
double gNDurchschnittprostep
- Protected Attributes inherited from MBSim::Integrator
double tStart
 start, end, plot time
double tEnd
double dtPlot
fmatvec::Vec z0
 initial state
int warnLevel
 warn level
bool output
 flag for ouput printing
std::string name
 name of integrator

Additional Inherited Members

- Static Protected Attributes inherited from MBSim::Integrator
static DynamicSystemSolver * system
 integrated dynamic system

Detailed Description

Half-explicit time-stepping integrator of first or higer order with StepSize Control (SSC) important options / settings :

a) setMaxOrder(int order, int method=0) order: maximum order of integration scheme 1 to 3 with SSC by extrapolation (method=0) (order=4 without SSC) 1 to 4 with embedded SSC (1=1(2), ... 4=4(5)) (method=1 or 2) method: method used for error estimation and step size control 0: step size control by extrapolation (steps wit dt and dt/2 are compared) DEFAULT 1: embedded method (compare maxOrder maxOrder+1); proceed with maxOrder (recommended) 2: embedded method with local extrapolation (integration is continued with maxOrder+1)

b) setFlagErrorTest(int Flag, bool alwaysValid= true) Flag: for scaling variables for the purpose of error estimation 0: include velocities u for error test 2: scale velocities u with stepsize for error test 3: exclude velocities u for error test alwaysValid: true : u is scaled resp. exluded during smooth and nonsmooth steps alwaysValid: false : u is scaled resp. exluded only during nonsmooth steps

c) deactivateSSC(bool flag=false) : maximum order: 1 to 4

d) setGapControl(bool FlagGapControl=true, int GapControlStrategy=0) FlagGapControl activate / deactivate gap control GapControlStrategy choose strategy for Gap Control (1:maximal Stepsize to 4:minimal Penetration) 1: uses biggest root (maximal dt) 2: score for all roots are evaluated 3: gapTol is used 4: uses smallest root (minimal penetration) 0: gap control deactivated

Author:
Robert Huber
Date:
2009-09-07 modifications for mbsim_dev

Constructor & Destructor Documentation

MBSim::TimeSteppingSSCIntegrator::TimeSteppingSSCIntegrator ( )

Constructor with dt(1e-5), driftCompensation(false)

MBSim::TimeSteppingSSCIntegrator::~TimeSteppingSSCIntegrator ( )

Destructor


Member Function Documentation

virtual void MBSim::TimeSteppingSSCIntegrator::initializeUsingXML ( TiXmlElement *  element)
virtual

initialize integrator

Parameters:
XMLdescription

Reimplemented from MBSim::Integrator.

void MBSim::TimeSteppingSSCIntegrator::integrate ( DynamicSystemSolver &  system_)
virtual

Start the integration

Implements MBSim::Integrator.

void MBSim::TimeSteppingSSCIntegrator::integrate ( DynamicSystemSolver &  systemT1_,
DynamicSystemSolver &  systemT2_,
DynamicSystemSolver &  systemT3_,
int  Threads = 0 
)

Threads: Number of Threads (0,1,2 or 3) 0: auto (number of threads depends on order and SSC)

void MBSim::TimeSteppingSSCIntegrator::setDriftCompensation ( bool  dc)
inline

Set drift compensation

void MBSim::TimeSteppingSSCIntegrator::setFlagErrorTest ( int  Flag,
bool  alwaysValid = true 
)

Set Flag vor ErrorTest (default 0: all variables ae tested; 2: u is scaled with dt; 3: exclude u alwaysValid = true : u is scaled resp. exluded during the smooth and nonsmooth part alwaysValid = false : u is scaled resp. exluded only during nonsmooth steps

void MBSim::TimeSteppingSSCIntegrator::setFlagPlotIntegrator ( bool  flag = true)
inline

set Flag for writing integrator info at each step to a file (default true)

void MBSim::TimeSteppingSSCIntegrator::setGapControl ( int  strategy = 1)
inline

Set Flag to optimise dt for minmal penetration of unilateral links; choose strategy for Gap Control (1:maximal Stepsize to 4:minimal Penetration) 1: uses biggest root (maximal dt) 2: score for all roots are evaluated 3: gapTol is used 4: uses smallest root (minimal penetration) 0: gap control deactivated with statistic calculations -1: gap control deactivated without statistic calculations

void MBSim::TimeSteppingSSCIntegrator::setInitialStepSize ( double  dt_)
inline

Set initial step size

void MBSim::TimeSteppingSSCIntegrator::setmaxGainSSC ( double  maxGain)
inline

Set maximal gain for increasing dt by stepsize control

void MBSim::TimeSteppingSSCIntegrator::setMaxOrder ( int  order_,
int  method_ = 0 
)

set maximum order (1,2,3 (method=0) or 1 to 4 (method=1,2) and method 0: SSC by extrapolation (recommended!!); 1,2: embedded SSC; proceed with maxOrder [1] (recommended if you don't want to use 0) or with maxOrder+1 [2] without SSC maximum order from 1 to 4 is possible

void MBSim::TimeSteppingSSCIntegrator::setOutputInterpolation ( bool  flag = true)
inline

Set Flag for output interpolation

void MBSim::TimeSteppingSSCIntegrator::setSafetyFactorSSC ( double  sfactor)
inline

safety factor for stepsize estimation: dt = dt_estimate * safetyFactorSSC (]0;1]; default 0.6)

void MBSim::TimeSteppingSSCIntegrator::setStepSizeMax ( double  dtMax_)
inline

Set maximal step size

void MBSim::TimeSteppingSSCIntegrator::setStepSizeMin ( double  dtMin_)
inline

Set minimal step size (default 2*maxOrder*epsroot()


Member Data Documentation

bool MBSim::TimeSteppingSSCIntegrator::FlagCoutInfo
protected

Flag: write integration info (integ.

summary) to cout (default true)

int MBSim::TimeSteppingSSCIntegrator::maxOrder
protected

maximum order of integration scheme SSC by extrapolation (steps with differnt dt are compared): 1, 2, 3 SSC with embedded methods (differnt orders are compared): 1 to 4 [ 1= 1(2), ...

4= 4(5) ] maxOrder(maxOrder+1)


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