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:

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)
DriftList &	operator= (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 VectorBool &	getFiltered () 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 ADrift *	getDrift (int il) const
	TODO : to be removed (encapsulation) More...
int	getRankFex (int il) const
String	getDriftName (int il) const
const VectorDouble &	getBetaHats () 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)
AStringable &	operator= (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 ICloneable *	clone () const =0

Constructor & Destructor Documentation

DriftList() [1/2]

DriftList::DriftList

(

const CovContext &

ctxt = CovContext()

)

DriftList() [2/2]

DriftList::DriftList

(

const DriftList &

r

)

~DriftList()

DriftList::~DriftList ( )

virtual

Member Function Documentation

addDrift()

void DriftList::addDrift

(

const ADrift *

drift

)

copyCovContext()

void DriftList::copyCovContext ( const CovContext &  ctxt )

inline

delAllDrifts()

void DriftList::delAllDrifts

(

)

delDrift()

void DriftList::delDrift

(

unsigned int

i

)

evalDrift()

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

db	Db structure
iech	Rank of the target sample
il	Rank of the drift function
member	Member type (used to check filtering)

Returns

evalDriftBySample()

VectorDouble DriftList::evalDriftBySample	(	const Db *	db,
		int	iech,
		const ECalcMember &	member = ECalcMember::fromKey("LHS")
	)		const

evalDriftBySampleInPlace()

void DriftList::evalDriftBySampleInPlace	(	const Db *	db,
		int	iech,
		const ECalcMember &	member,
		VectorDouble &	drftab
	)		const

evalDriftCoef()

double DriftList::evalDriftCoef	(	const Db *	db,
		int	iech,
		const VectorDouble &	coeffs
	)		const

evalDriftCoefs()

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

db	Target Db
coeffs	Vector of coefficients (must have dimension of number of drift elements)
useSel	True if the selection must be taken into account

Returns

evalDriftMatrix()

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]	db	Db structure
[in]	ivar0	Rank of the variable (-1 for all variables)
[in]	nbgh	Vector of indices of active samples in db (optional)
[in]	member	Member of the Kriging System (ECalcMember)

evalDriftValue()

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

db	Db structure
iech	Rank of the sample
ivar	Rank of the variable
ib	Rank of the Drift function
member	ECalcMember characteristics

getBetaHats()

const VectorDouble& DriftList::getBetaHats ( ) const

inline

getDrift() [1/2]

double DriftList::getDrift	(	const Db *	db,
		int	ib,
		int	iech
	)		const

getDrift() [2/2]

const ADrift * DriftList::getDrift

(

int

il

)

const

TODO : to be removed (encapsulation)

getDriftEquationNumber()

int DriftList::getDriftEquationNumber

(

)

const

getDriftMaxIRFOrder()

int DriftList::getDriftMaxIRFOrder

(

void

)

const

Returns

Maximum IRF-order (-1 for order-2 stationarity)

getDriftName()

String DriftList::getDriftName

(

int

il

)

const

getDriftNumber()

int DriftList::getDriftNumber ( ) const

inline

getDrifts()

VectorVectorDouble DriftList::getDrifts	(	const Db *	db,
		bool	useSel = true
	)		const

getFiltered()

const VectorBool& DriftList::getFiltered ( ) const

inline

getNVariables()

int DriftList::getNVariables ( ) const

inline

getRankFex()

int DriftList::getRankFex

(

int

il

)

const

hasExternalDrift()

bool DriftList::hasExternalDrift

(

)

const

isDriftDefined()

bool DriftList::isDriftDefined	(	const VectorInt &	powers,
		int	rank_fex = 0
	)		const

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

Parameters

powers	Vector of exponents for monomials
rank_fex	Rank of the variable for external dift

Returns

isDriftDifferentDefined()

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

powers	Vector of exponent for monomials of a polynomial drift
rank_fex	Rank of the variable for external Drift

Returns

isDriftSampleDefined()

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

db	Data file used for reading the drift contents (depends on its type)
ib	Rank of the drift function
nech	Number of samples to be checked
nbgh	Vector of sample indices within the data base
loctype	Locator to be checked

isFiltered()

bool DriftList::isFiltered

(

int

i

)

const

isFlagCombined()

bool DriftList::isFlagCombined ( ) const

inline

isFlagLinked()

bool DriftList::isFlagLinked ( ) const

inline

isValid()

bool DriftList::isValid

(

)

const

Check that the set of drift functions is valid

Returns

operator=()

DriftList & DriftList::operator=

(

const DriftList &

r

)

resetDriftList()

void DriftList::resetDriftList

(

)

setBetaHat()

void DriftList::setBetaHat ( const VectorDouble &  betaHat )

inline

setDriftCLByPart()

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

ivar	Rank of the variable (_nVar)
ib	Rank of the drift equation (_driftEquationNumber)
coef	Vector of coefficients

setFiltered() [1/2]

void DriftList::setFiltered ( const VectorBool &  filtered )

inline

setFiltered() [2/2]

void DriftList::setFiltered	(	int	i,
		bool	filter
	)

setFlagCombined()

void DriftList::setFlagCombined ( bool  flagCombined )

inline

setFlagLinked()

void DriftList::setFlagLinked ( bool  flagLinked )

inline

toString()

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:

• include/Drifts/DriftList.hpp
• src/Drifts/DriftList.cpp