#include <NamingConvention.hpp>

Inheritance diagram for NamingConvention:

Detailed Description

Naming Convention facility This class describes the way variables created within the current procedure will be named afterwards and will possibly be assigned a locator.

The generic name is generated as follows: 'prefix'.'varname'.'qualifier'.'rank'

prefix: string provided in the constructor of this class
varname: name of the (input) variable on which the procedure is performed
qualifier: type of element stored in the variable
rank: rank of the output variable (if several variables of the same type are generated)

The choice of the 'prefix' is done by the user when launching the procedure the other parameters are usually defined within the procedure.

For example, when running 'kriging' function with several variables defined in the input Db - say "Pb" abd "Zn" (they are assigned a Z-locator), using the following command: kriging( ... namconv = NamingConvention("MyPrefix") )

Then the kriging procedure generates variables such as:

MyPrefix.Pb.estim (estimation of Pb by CoKriging)
MyPrefix.Zn.estim (estimation of Zn by CoKriging)
MyPrefix.Pb.stdev (St. Dev. of estimation error of Pb by CoKriging)
MyPrefix.Zn.stdev (St. Dev. of estimation error of Zn by CoKriging)

Then the non-conditional simulation procedure generates variables such as:

MyPrefix.1 (for first simulation)
MyPrefix.2 (for second simulation) ...

Then the conditional simulation procedure generates variables such as:
MyPrefix.var.1 (for first simulation)
MyPrefix.var.2 (for second simulation) ...

Ultimately, the newly created variables are assigned a locator.

Public Member Functions
	NamingConvention (const String &prefix="", bool flag_varname=true, bool flag_qualifier=true, bool flag_locator=true, const ELoc &locatorOutType=ELoc::fromKey("Z"), const String &delim=".", bool cleanSameLocator=true)

	NamingConvention (const NamingConvention &m)

NamingConvention &	operator= (const NamingConvention &m)

virtual	~NamingConvention ()

virtual String	toString (const AStringFormat *strfmt=nullptr) const override
	AStringable Interface. More...

void	setNamesAndLocators (Db *dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (const VectorString &names, Db *dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (Db *dbout, int iattout_start, const VectorString &names, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (const String &namin, Db *dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (const Db dbin, const VectorString &names, const ELoc &locatorInType, int nvar, Db dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (const Db dbin, const VectorInt &iatts, Db dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setNamesAndLocators (const Db dbin, int iatt, Db dbout, int iattout_start, const String &qualifier="", int nitems=1, bool flagSetLocator=true, int locatorShift=0) const

void	setDelim (const String &delim)

void	setLocatorOutType (const ELoc &l)

void	setPrefix (const String &prefix)

void	setFlagClean (bool cleanSameLocator)

void	setLocators (Db *dbout, int iattout_start, int nvar, int nitems=1, int locatorShift=0) const

bool	isFlagQualifier () const

bool	isFlagVarname () 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

Static Public Member Functions
static NamingConvention *	create (const String &prefix="", bool flag_varname=true, bool flag_qualifier=true, bool flag_locator=true, const ELoc &locatorOutType=ELoc::fromKey("Z"), const String &delim=".", bool cleanSameLocator=true)

Constructor & Destructor Documentation

◆ NamingConvention() [1/2]

NamingConvention::NamingConvention	(	const String &	prefix = `""`,
		bool	flag_varname = `true`,
		bool	flag_qualifier = `true`,
		bool	flag_locator = `true`,
		const ELoc &	locatorOutType = `ELoc::fromKey("Z")`,
		const String &	delim = `"."`,
		bool	cleanSameLocator = `true`
	)

◆ NamingConvention() [2/2]

NamingConvention::NamingConvention ( const NamingConvention & m )

◆ ~NamingConvention()

NamingConvention::~NamingConvention ( )

virtual

Member Function Documentation

◆ create()

NamingConvention * NamingConvention::create	(	const String &	prefix = `""`,
		bool	flag_varname = `true`,
		bool	flag_qualifier = `true`,
		bool	flag_locator = `true`,
		const ELoc &	locatorOutType = `ELoc::fromKey("Z")`,
		const String &	delim = `"."`,
		bool	cleanSameLocator = `true`
	)

static

Construct an item of the Naming Convention Class

Parameters

prefix	Name given to the prefix
flag_varname	When TRUE, the 'varname' is included in the output names
flag_qualifier	When TRUE, the 'qualifier' is included in the output names
flag_locator	When TRUE, the output variables receive a 'locator'
locatorOutType	Type of locator assigned to the output variables
delim	Symbol used as a delimitor separating the different parts of the output names
cleanSameLocator	When TRUE and if 'flag_locator' is TRUE, all variables assigned to the same locator are cancelled beforehand

Returns

◆ isFlagQualifier()

bool NamingConvention::isFlagQualifier ( ) const

inline

◆ isFlagVarname()

bool NamingConvention::isFlagVarname ( ) const

inline

◆ operator=()

NamingConvention & NamingConvention::operator= ( const NamingConvention & m )

◆ setDelim()

void NamingConvention::setDelim ( const String & delim )

inline

◆ setFlagClean()

void NamingConvention::setFlagClean ( bool cleanSameLocator )

inline

◆ setLocatorOutType()

void NamingConvention::setLocatorOutType ( const ELoc & l )

inline

◆ setLocators()

void NamingConvention::setLocators	(	Db *	dbout,
		int	iattout_start,
		int	nvar,
		int	nitems = `1`,
		int	locatorShift = `0`
	)		const

◆ setNamesAndLocators() [1/7]

void NamingConvention::setNamesAndLocators	(	const Db *	dbin,
		const VectorInt &	iatts,
		Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follow:

'prefix'.'v[i]'.'qualifier'.'item_rank'

where v[i] is the variable with rank 'i' within 'dbin'

Parameters

dbin	Pointer to the input Db (kept for symmetry)
iatts	Vector of attribute indices of the variables in Input Db
dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [2/7]

void NamingConvention::setNamesAndLocators	(	const Db *	dbin,
		const VectorString &	names,
		const ELoc &	locatorInType,
		int	nvar,
		Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follow:

'prefix'.'name'.'qualifier'.'item_rank'

where 'name' stands for the name of the variable(s) in 'names' or, if absent, the name of the variable with locator 'Loc' in 'dbin'

Parameters

dbin	Pointer to the input Db (kept for symmetry)
names	Vector of names (from 'dbin'). If not defined, use the locator instead
locatorInType	Locator Type of the variables in Input Db
nvar	Number of items belonging to the locatorType (if -1, all the items available for this locator are used)
dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [3/7]

void NamingConvention::setNamesAndLocators	(	const Db *	dbin,
		int	iatt,
		Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follow:

'prefix'.'v[iatt]'.'qualifier'.'item_rank'

Parameters

dbin	Pointer to the input Db (kept for symmetry)
iatt	Attribute index of the variables in Input Db
dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [4/7]

void NamingConvention::setNamesAndLocators	(	const String &	namin,
		Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follow:

'prefix'.'namin'.'qualifier'.'item_rank'

Parameters

namin	variable name
dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [5/7]

void NamingConvention::setNamesAndLocators	(	const VectorString &	names,
		Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follows:

'prefix'.'names[i]'.qualifier'.'item_rank'

Parameters

names	Vector of variable names
dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [6/7]

void NamingConvention::setNamesAndLocators	(	Db *	dbout,
		int	iattout_start,
		const String &	qualifier = `""`,
		int	nitems = `1`,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follows:

'prefix'.'qualifier'.'item_rank'

Parameters

dbout	Pointer to the output Db
iattout_start	Starting attribute index
qualifier	Optional qualifier
nitems	Number of items
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setNamesAndLocators() [7/7]

void NamingConvention::setNamesAndLocators	(	Db *	dbout,
		int	iattout_start,
		const VectorString &	names,
		bool	flagSetLocator = `true`,
		int	locatorShift = `0`
	)		const

Newly created variables are named as follows:

"names[i]"

Parameters

dbout	Pointer to the output Db
iattout_start	Starting attribute index
names	Vector of output variable names
flagSetLocator	True if the variable must be assigned the locator
locatorShift	Shift to be applied to the locator currently defined

◆ setPrefix()

void NamingConvention::setPrefix ( const String & prefix )

inline

◆ toString()

String NamingConvention::toString ( const AStringFormat * strfmt = nullptr ) const

overridevirtual

AStringable Interface.

Reimplemented from AStringable.

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

include/Basic/NamingConvention.hpp
src/Basic/NamingConvention.cpp

Detailed Description

Public Member Functions

Static Public Member Functions

Constructor & Destructor Documentation

◆ NamingConvention() [1/2]

◆ NamingConvention() [2/2]

◆ ~NamingConvention()

Member Function Documentation

◆ create()

◆ isFlagQualifier()

◆ isFlagVarname()

◆ operator=()

◆ setDelim()

◆ setFlagClean()

◆ setLocatorOutType()

◆ setLocators()

◆ setNamesAndLocators() [1/7]

◆ setNamesAndLocators() [2/7]

◆ setNamesAndLocators() [3/7]

◆ setNamesAndLocators() [4/7]

◆ setNamesAndLocators() [5/7]

◆ setNamesAndLocators() [6/7]

◆ setNamesAndLocators() [7/7]

◆ setPrefix()

◆ toString()