1.3.0
CCC
 
DriftList Class Reference

This class provides the information on Drift part of the Model. The drift plays the role of the average of the target Random Function which may be constant or vary as a function with low frequency variations (by opposition to the complementary part of the Spatial Characteristics which is described by its Covariance) More...

#include <DriftList.hpp>

Inheritance diagram for DriftList:
AStringable ICloneable

Detailed Description

This class provides the information on Drift part of the Model. The drift plays the role of the average of the target Random Function which may be constant or vary as a function with low frequency variations (by opposition to the complementary part of the Spatial Characteristics which is described by its Covariance)

This class essentially contains a list of basic (active)e drift functions: see ADrift.hpp for details.

This class also carry other important informations:

  • a vector giving the status of each basic drift functions: it may be active or filtered
  • some additional information defining some relationship between the basic drift function: this is used for the special case where the different Random Functions obey to algebraic relations.

Public Member Functions

 DriftList (const CovContext &ctxt=CovContext())
 
 DriftList (const DriftList &r)
 
DriftListoperator= (const DriftList &r)
 
virtual ~DriftList ()
 
virtual String toString (const AStringFormat *strfmt=nullptr) const override
 ICloneable interface. More...
 
int getNVariables () const
 
int getDriftNumber () const
 
void addDrift (const ADrift *drift)
 
void delDrift (unsigned int i)
 
void delAllDrifts ()
 
const VectorBoolgetFiltered () const
 
void setFiltered (const VectorBool &filtered)
 
bool isFiltered (int i) const
 
void setFiltered (int i, bool filter)
 
int getDriftEquationNumber () const
 
bool hasExternalDrift () const
 
bool isValid () const
 
const ADriftgetDrift (int il) const
 TODO : to be removed (encapsulation) More...
 
int getRankFex (int il) const
 
String getDriftName (int il) const
 
const VectorDoublegetBetaHats () const
 
void setDriftCLByPart (int ivar, int ib, const VectorDouble &coef)
 
void resetDriftList ()
 
bool isDriftSampleDefined (const Db *db, int ib, int nech, const VectorInt &nbgh, const ELoc &loctype) const
 
double getDrift (const Db *db, int ib, int iech) const
 
VectorVectorDouble getDrifts (const Db *db, bool useSel=true) const
 
bool isFlagLinked () const
 
bool isFlagCombined () const
 
int getDriftMaxIRFOrder (void) const
 
bool isDriftDefined (const VectorInt &powers, int rank_fex=0) const
 
bool isDriftDifferentDefined (const VectorInt &powers, int rank_fex=-1) const
 
void copyCovContext (const CovContext &ctxt)
 
void setFlagLinked (bool flagLinked)
 
void setFlagCombined (bool flagCombined)
 
void setBetaHat (const VectorDouble &betaHat)
 
double evalDrift (const Db *db, int iech, int il, const ECalcMember &member=ECalcMember::fromKey("LHS")) const
 
double evalDriftCoef (const Db *db, int iech, const VectorDouble &coeffs) const
 
VectorDouble evalDriftCoefs (const Db *db, const VectorDouble &coeffs, bool useSel=false) const
 
VectorDouble evalDriftBySample (const Db *db, int iech, const ECalcMember &member=ECalcMember::fromKey("LHS")) const
 
void evalDriftBySampleInPlace (const Db *db, int iech, const ECalcMember &member, VectorDouble &drftab) const
 
MatrixRectangular evalDriftMatrix (const Db *db, int ivar0=-1, const VectorInt &nbgh=VectorInt(), const ECalcMember &member=ECalcMember::fromKey("LHS"))
 
double evalDriftValue (const Db *db, int iech, int ivar, int ib, const ECalcMember &member=ECalcMember::fromKey("LHS")) const
 
- Public Member Functions inherited from AStringable
 AStringable ()
 
 AStringable (const AStringable &r)
 
AStringableoperator= (const AStringable &r)
 
virtual ~AStringable ()
 
virtual void display (const AStringFormat *strfmt=nullptr) const final
 
virtual void display (int level) const final
 
- Public Member Functions inherited from ICloneable
 ICloneable ()
 
virtual ~ICloneable ()
 
virtual ICloneableclone () const =0
 

Constructor & Destructor Documentation

DriftList::DriftList ( const CovContext ctxt = CovContext())
DriftList::DriftList ( const DriftList r)
DriftList::~DriftList ( )
virtual

Member Function Documentation

void DriftList::addDrift ( const ADrift drift)
void DriftList::copyCovContext ( const CovContext ctxt)
inline
void DriftList::delAllDrifts ( )
void DriftList::delDrift ( unsigned int  i)
double DriftList::evalDrift ( const Db db,
int  iech,
int  il,
const ECalcMember &  member = ECalcMember::fromKey("LHS") 
) const

Evaluate a given drift function for a given sample

Parameters
dbDb structure
iechRank of the target sample
ilRank of the drift function
memberMember type (used to check filtering)
Returns
VectorDouble DriftList::evalDriftBySample ( const Db db,
int  iech,
const ECalcMember &  member = ECalcMember::fromKey("LHS") 
) const
void DriftList::evalDriftBySampleInPlace ( const Db db,
int  iech,
const ECalcMember &  member,
VectorDouble drftab 
) const
double DriftList::evalDriftCoef ( const Db db,
int  iech,
const VectorDouble coeffs 
) const
VectorDouble DriftList::evalDriftCoefs ( const Db db,
const VectorDouble coeffs,
bool  useSel = false 
) const

Evaluate the Linear combination of drift terms at each sample of a Db

Parameters
dbTarget Db
coeffsVector of coefficients (must have dimension of number of drift elements)
useSelTrue if the selection must be taken into account
Returns
MatrixRectangular DriftList::evalDriftMatrix ( const Db db,
int  ivar0 = -1,
const VectorInt nbgh = VectorInt(),
const ECalcMember &  member = ECalcMember::fromKey("LHS") 
)

Establish the drift rectangular matrix for a given Db

Returns
Returned matrix (Dimension/ nrows = nvar * nech; ncols = nfeq * nvar)
Parameters
[in]dbDb structure
[in]ivar0Rank of the variable (-1 for all variables)
[in]nbghVector of indices of active samples in db (optional)
[in]memberMember of the Kriging System (ECalcMember)
double DriftList::evalDriftValue ( const Db db,
int  iech,
int  ivar,
int  ib,
const ECalcMember &  member = ECalcMember::fromKey("LHS") 
) const

Returns the Drift value for a given variable and a given drift function

Parameters
dbDb structure
iechRank of the sample
ivarRank of the variable
ibRank of the Drift function
memberECalcMember characteristics
const VectorDouble& DriftList::getBetaHats ( ) const
inline
const ADrift * DriftList::getDrift ( int  il) const

TODO : to be removed (encapsulation)

double DriftList::getDrift ( const Db db,
int  ib,
int  iech 
) const
int DriftList::getDriftEquationNumber ( ) const
int DriftList::getDriftMaxIRFOrder ( void  ) const
Returns
Maximum IRF-order (-1 for order-2 stationarity)
String DriftList::getDriftName ( int  il) const
int DriftList::getDriftNumber ( ) const
inline
VectorVectorDouble DriftList::getDrifts ( const Db db,
bool  useSel = true 
) const
const VectorBool& DriftList::getFiltered ( ) const
inline
int DriftList::getNVariables ( ) const
inline
int DriftList::getRankFex ( int  il) const
bool DriftList::hasExternalDrift ( ) const
bool DriftList::isDriftDefined ( const VectorInt powers,
int  rank_fex = 0 
) const

Check if a given drift type is defined among the drift functions

Parameters
powersVector of exponents for monomials
rank_fexRank of the variable for external dift
Returns
bool DriftList::isDriftDifferentDefined ( const VectorInt powers,
int  rank_fex = -1 
) const

Check if at least one drift function exists whose type is different from the target type

Parameters
powersVector of exponent for monomials of a polynomial drift
rank_fexRank of the variable for external Drift
Returns
bool DriftList::isDriftSampleDefined ( const Db db,
int  ib,
int  nech,
const VectorInt nbgh,
const ELoc &  loctype 
) const

Check that the drift 'ib' is defined for at least one variable one sample

Parameters
dbData file used for reading the drift contents (depends on its type)
ibRank of the drift function
nechNumber of samples to be checked
nbghVector of sample indices within the data base
loctypeLocator to be checked
bool DriftList::isFiltered ( int  i) const
bool DriftList::isFlagCombined ( ) const
inline
bool DriftList::isFlagLinked ( ) const
inline
bool DriftList::isValid ( ) const

Check that the set of drift functions is valid

Returns
DriftList & DriftList::operator= ( const DriftList r)
void DriftList::resetDriftList ( )
void DriftList::setBetaHat ( const VectorDouble betaHat)
inline
void DriftList::setDriftCLByPart ( int  ivar,
int  ib,
const VectorDouble coef 
)

Set the values of the internal array 'driftCL' This feature is used when the drift equation does not coincide with a drift function (when working with the gradient of the target variable, for example)

Parameters
ivarRank of the variable (_nVar)
ibRank of the drift equation (_driftEquationNumber)
coefVector of coefficients
void DriftList::setFiltered ( const VectorBool filtered)
inline
void DriftList::setFiltered ( int  i,
bool  filter 
)
void DriftList::setFlagCombined ( bool  flagCombined)
inline
void DriftList::setFlagLinked ( bool  flagLinked)
inline
String DriftList::toString ( const AStringFormat strfmt = nullptr) const
overridevirtual

ICloneable interface.

AStringable Interface

Reimplemented from AStringable.


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