base/FuncSignature.hpp File Reference

Go to the source code of this file.

Classes
struct	openfluid::base::SignatureHandledDataItem
struct	openfluid::base::SignatureHandledUnitsClassItem
struct	openfluid::base::SignatureHandledData
struct	openfluid::base::SignatureHandledUnitsGraph
struct	openfluid::base::FunctionSignature
Namespaces
namespace	openfluid
namespace	openfluid::base
Defines
#define	BEGIN_SIGNATURE_HOOK
#define	END_SIGNATURE_HOOK
#define	DECLARE_SIGNATURE_ID(id)   Signature->ID = id;
#define	DECLARE_SIGNATURE_NAME(name)   Signature->Name = name;
#define	DECLARE_SIGNATURE_DESCRIPTION(desc)   Signature->Description = desc;
#define	DECLARE_SIGNATURE_DOMAIN(domain)   Signature->Domain = domain;
#define	DECLARE_SIGNATURE_PROCESS(process)   Signature->Process = process;
#define	DECLARE_SIGNATURE_METHOD(method)   Signature->Method = method;
#define	DECLARE_SIGNATURE_AUTHORNAME(name)   Signature->Author = name;
#define	DECLARE_SIGNATURE_AUTHOREMAIL(email)   Signature->AuthorEmail = email;
#define	DECLARE_SIGNATURE_VERSION(version)   Signature->Version = version;
#define	DECLARE_SIGNATURE_STATUS(status)   Signature->Status = status;
#define	DECLARE_SIGNATURE_SDKVERSION   Signature->setSDKVersion(STRINGIFY(OPENFLUID_VERSION));
#define	DECLARE_FUNCTION_PARAM(name, description, unit)   Signature->HandledData.FunctionParams.push_back(openfluid::base::SignatureHandledDataItem((name),(""),description,unit));
#define	DECLARE_PRODUCED_VAR(name, uclass, description, unit)   Signature->HandledData.ProducedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_UPDATED_VAR(name, uclass, description, unit)   Signature->HandledData.UpdatedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_REQUIRED_VAR(name, uclass, description, unit)   Signature->HandledData.RequiredVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_REQUIRED_PREVVAR(name, uclass, description, unit)   Signature->HandledData.RequiredPrevVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_USED_VAR(name, uclass, description, unit)   Signature->HandledData.UsedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_USED_PREVVAR(name, uclass, description, unit)   Signature->HandledData.UsedPrevVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_REQUIRED_INPUTDATA(name, uclass, description, unit)   Signature->HandledData.RequiredInput.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_USED_INPUTDATA(name, uclass, description, unit)   Signature->HandledData.UsedInput.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));
#define	DECLARE_USED_EVENTS(uclass)   Signature->HandledData.UsedEventsOnUnits.push_back(uclass);
#define	DECLARE_UPDATED_UNITSGRAPH(description)   Signature->HandledUnitsGraph.UpdatedUnitsGraph = (description);
#define	DECLARE_UPDATED_UNITSCLASS(uclass, description)   Signature->HandledUnitsGraph.UpdatedUnitsClass.push_back(openfluid::base::SignatureHandledUnitsClassItem(uclass,description));
#define	DECLARE_REQUIRED_EXTRAFILE(name)   Signature->HandledData.RequiredExtraFiles.push_back(name);
#define	DECLARE_USED_EXTRAFILE(name)   Signature->HandledData.UsedExtraFiles.push_back(name);
Typedefs
typedef std::string	openfluid::base::FuncID_t
typedef std::string	openfluid::base::FuncName_t
typedef std::string	openfluid::base::FuncVersion_t
typedef std::string	openfluid::base::FuncMethod_t
typedef std::string	openfluid::base::FuncProcess_t
typedef std::string	openfluid::base::FuncDomain_t
Enumerations
enum	openfluid::base::FuncStatus_t { openfluid::base::EXPERIMENTAL, openfluid::base::BETA, openfluid::base::STABLE }

---

Detailed Description

Author:

Jean-Christophe FABRE <fabrejc@supagro.inra.fr>

---

Define Documentation

#define BEGIN_SIGNATURE_HOOK

Value:

openfluid::base::FunctionSignature* GetPlugSignature() \
  { \
    openfluid::base::FunctionSignature* Signature = new openfluid::base::FunctionSignature(); \
    Signature->setSDKVersion(STRINGIFY(OPENFLUID_VERSION));

Macro for the beginning of definition of signature hook

#define DECLARE_FUNCTION_PARAM	(	name,
		description,
		unit		)	Signature->HandledData.FunctionParams.push_back(openfluid::base::SignatureHandledDataItem((name),(""),description,unit));

Macro for declaration of a function parameter

Parameters:

[in]	name	name of the parameter
[in]	description	description of the parameter
[in]	unit	unit of the parameter. Could be an empty string if there is no unit

#define DECLARE_PRODUCED_VAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.ProducedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of a produced variable

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define DECLARE_REQUIRED_EXTRAFILE

(

name

)

Signature->HandledData.RequiredExtraFiles.push_back(name);

Macro for declaration of required file

Parameters:

[in]

name

name of the file

#define DECLARE_REQUIRED_INPUTDATA	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.RequiredInput.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of a required input data

Parameters:

[in]	name	name of the property
[in]	uclass	class of the concerned units
[in]	description	description of the property
[in]	unit	unit of the property. Could be an empty string if there is no unit

#define DECLARE_REQUIRED_PREVVAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.RequiredPrevVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of a required variable, using a value produced on a previous time step

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define DECLARE_REQUIRED_VAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.RequiredVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of a required variable

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define DECLARE_SIGNATURE_AUTHOREMAIL

(

email

)

Signature->AuthorEmail = email;

Macro for declaration of the function author email

#define DECLARE_SIGNATURE_AUTHORNAME

(

name

)

Signature->Author = name;

Macro for declaration of the function author name

#define DECLARE_SIGNATURE_DESCRIPTION

(

desc

)

Signature->Description = desc;

Macro for declaration of the function description

#define DECLARE_SIGNATURE_DOMAIN

(

domain

)

Signature->Domain = domain;

Macro for declaration of the function application domain

#define DECLARE_SIGNATURE_ID

(

id

)

Signature->ID = id;

Macro for declaration of the function ID

#define DECLARE_SIGNATURE_METHOD

(

method

)

Signature->Method = method;

Macro for declaration of the function application numerical method

#define DECLARE_SIGNATURE_NAME

(

name

)

Signature->Name = name;

Macro for declaration of the function name

#define DECLARE_SIGNATURE_PROCESS

(

process

)

Signature->Process = process;

Macro for declaration of the function application processes

#define DECLARE_SIGNATURE_SDKVERSION   Signature->setSDKVersion(STRINGIFY(OPENFLUID_VERSION));

Macro for declaration of SDK version used to build the function

#define DECLARE_SIGNATURE_STATUS

(

status

)

Signature->Status = status;

Macro for declaration of the function status

#define DECLARE_SIGNATURE_VERSION

(

version

)

Signature->Version = version;

Macro for declaration of the function version

#define DECLARE_UPDATED_UNITSCLASS	(	uclass,
		description		)	Signature->HandledUnitsGraph.UpdatedUnitsClass.push_back(openfluid::base::SignatureHandledUnitsClassItem(uclass,description));

Macro for declaration of units class creation or update

Parameters:

[in]	uclass	name of the created or updated class
[in]	description	description of the updated class

#define DECLARE_UPDATED_UNITSGRAPH

(

description

)

Signature->HandledUnitsGraph.UpdatedUnitsGraph = (description);

Macro for declaration of units graph modification

Parameters:

[in]

description

description of modification

#define DECLARE_UPDATED_VAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.UpdatedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of an updated variable

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define DECLARE_USED_EVENTS

(

uclass

)

Signature->HandledData.UsedEventsOnUnits.push_back(uclass);

Macro for declaration of used events

Parameters:

[in]

uclass

class of the concerned units

#define DECLARE_USED_EXTRAFILE

(

name

)

Signature->HandledData.UsedExtraFiles.push_back(name);

Macro for declaration of used file

Parameters:

[in]

name

name of the file

#define DECLARE_USED_INPUTDATA	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.UsedInput.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of a used input data

Parameters:

[in]	name	name of the property
[in]	uclass	class of the concerned units
[in]	description	description of the property
[in]	unit	unit of the property. Could be an empty string if there is no unit

#define DECLARE_USED_PREVVAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.UsedPrevVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of an used variable, using a value produced on a previous time step

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define DECLARE_USED_VAR	(	name,
		uclass,
		description,
		unit		)	Signature->HandledData.UsedVars.push_back(openfluid::base::SignatureHandledDataItem((name),uclass,description,unit));

Macro for declaration of an used variable

Parameters:

[in]	name	name of the variable
[in]	uclass	class of the concerned units
[in]	description	description of the variable
[in]	unit	unit of the variable. Could be an empty string if there is no unit

#define END_SIGNATURE_HOOK

Value:

return Signature; \
  }

Macro for the end of definition of signature hook