Base class for function objects, adding functionality to read/write state information (data required for smooth restart behaviour) and results to/from the state dictionary. More...

Inheritance diagram for stateFunctionObject:

[legend]

Collaboration diagram for stateFunctionObject:

[legend]

Public Member Functions
	stateFunctionObject (const word &name, const Time &runTime)
	Construct from components. More...

virtual	~stateFunctionObject ()=default
	Destructor. More...

dictionary &	propertyDict ()
	Return access to the property dictionary. More...

bool	foundProperty (const word &entryName) const
	Return true if the property exists. More...

void	clearTrigger ()
	Remove the trigger index from the properties. More...

label	getTrigger () const
	Get the current trigger index. More...

bool	setTrigger (const label triggeri, bool increaseOnly=true)
	Set the trigger index. Normally only if greater than current. More...

bool	getDict (const word &entryName, dictionary &dict) const
	Set dictionary, return true if set. More...

bool	getObjectDict (const word &objectName, const word &entryName, dictionary &dict) const
	Set dictionary from named object, return true if set. More...

template<class Type >
Type	getProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property. More...

template<class Type >
bool	getProperty (const word &entryName, Type &value) const
	Set generic property, return true if set. More...

template<class Type >
void	setProperty (const word &entryName, const Type &value)
	Add generic property. More...

template<class Type >
Type	getObjectProperty (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from named object. More...

template<class Type >
bool	getObjectProperty (const word &objectName, const word &entryName, Type &value) const
	Set generic property from named object, return true if set. More...

template<class Type >
void	setObjectProperty (const word &objectName, const word &entryName, const Type &value)
	Add generic property from named object. More...

template<class Type >
void	setResult (const word &entryName, const Type &value)
	Add result. More...

template<class Type >
void	setObjectResult (const word &objectName, const word &entryName, const Type &value)
	Add result from named object. More...

template<class Type >
Type	getResult (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve result. More...

template<class Type >
Type	getObjectResult (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve result from named object. More...

template<class Type >
bool	getObjectResult (const word &objectName, const word &entryName, Type &value) const
	Set result from named object, return true if set. More...

word	resultType (const word &entryName) const
	Retrieve the result type. More...

word	objectResultType (const word &objectName, const word &entryName) const
	Return the type of result. More...

wordList	objectResultEntries () const
	Retrieve the result entries. More...

wordList	objectResultEntries (const word &objectName) const
	Return result entries for named object. More...

void	writeResultEntries (Ostream &os) const
	Write the results entries for all objects to stream. More...

void	writeResultEntries (const word &objectName, Ostream &os) const
	Write the results entries for named object to stream. More...

void	writeAllResultEntries (Ostream &os) const
	Write the results entries for all objects to stream. More...

Public Member Functions inherited from timeFunctionObject
	timeFunctionObject (const word &name, const Time &runTime)
	Construct from Time. More...

virtual	~timeFunctionObject ()=default
	Destructor. More...

const Time &	time () const
	Return time database. More...

objectRegistry &	storedObjects ()

const objectRegistry &	storedObjects () const

Public Member Functions inherited from functionObject
	declareRunTimeSelectionTable (autoPtr, functionObject, dictionary,(const word &name, const Time &runTime, const dictionary &dict),(name, runTime, dict))

	functionObject (const word &name, const bool withNamePrefix=defaultUseNamePrefix)
	Construct from components. More...

autoPtr< functionObject >	clone () const
	Return clone. More...

virtual	~functionObject ()=default
	Destructor. More...

virtual const word &	type () const =0
	Runtime type information. More...

const word &	name () const noexcept
	Return the name of this functionObject. More...

bool	useNamePrefix () const noexcept
	Return the flag for adding a scoping name prefix. More...

bool	useNamePrefix (bool on) noexcept
	Modify the flag for adding a scoping name prefix. More...

virtual bool	read (const dictionary &dict)
	Read and set the function object if its data have changed. More...

virtual bool	execute ()=0
	Called at each ++ or += of the time-loop. More...

virtual bool	execute (const label subIndex)
	Execute using the specified subIndex. More...

virtual bool	write ()=0
	Called at each ++ or += of the time-loop. More...

virtual bool	end ()
	Called when Time::run() determines that the time-loop exits. More...

virtual bool	adjustTimeStep ()
	Called at the end of Time::adjustDeltaT() if adjustTime is true. More...

virtual bool	filesModified () const
	Did any file get changed during execution? More...

virtual void	updateMesh (const mapPolyMesh &mpm)
	Update for changes of mesh. More...

virtual void	movePoints (const polyMesh &mesh)
	Update for changes of mesh. More...

Protected Member Functions
const functionObjects::properties &	stateDict () const
	Return a const reference to the state dictionary. More...

functionObjects::properties &	stateDict ()
	Return non-const access to the state dictionary. More...

	stateFunctionObject (const stateFunctionObject &)=delete
	No copy construct. More...

void	operator= (const stateFunctionObject &)=delete
	No copy assignment. More...

Protected Member Functions inherited from timeFunctionObject
void	clearOutputObjects (const wordList &objNames)
	Remove specified items from "functionObjectObjects". More...

	timeFunctionObject (const timeFunctionObject &)=delete
	No copy construct. More...

void	operator= (const timeFunctionObject &)=delete
	No copy assignment. More...

Protected Member Functions inherited from functionObject
word	scopedName (const word &name) const
	Return a scoped (prefixed) name. More...

Additional Inherited Members
Static Public Member Functions inherited from functionObject
static autoPtr< functionObject >	New (const word &name, const Time &runTime, const dictionary &dict)
	Select from dictionary, based on its "type" entry. More...

Public Attributes inherited from functionObject
bool	log
	Flag to write log into Info. More...

Static Public Attributes inherited from functionObject
static int	debug
	Flag to execute debug content. More...

static bool	postProcess
	Global post-processing mode switch. More...

static bool	defaultUseNamePrefix
	Global default for useNamePrefix. More...

static word	outputPrefix
	Directory prefix. More...

Protected Attributes inherited from timeFunctionObject
const Time &	time_
	Reference to the time database. More...

Detailed Description

Base class for function objects, adding functionality to read/write state information (data required for smooth restart behaviour) and results to/from the state dictionary.

Note: cannot access the state dictionary until after construction of the function objects, since the owner container functionObjectList is owned by time, and time owns the state dictionary i.e. need to wait for time to be fully constructed.

See also: Foam::functionObject

Source files

Definition at line 69 of file stateFunctionObject.H.

Constructor & Destructor Documentation

◆ stateFunctionObject() [1/2]

stateFunctionObject ( const stateFunctionObject & )

protecteddelete

No copy construct.

◆ stateFunctionObject() [2/2]

stateFunctionObject	(	const word &	name,
		const Time &	runTime
	)

Construct from components.

Definition at line 60 of file stateFunctionObject.C.

◆ ~stateFunctionObject()

virtual ~stateFunctionObject ( )

virtualdefault

Destructor.

Member Function Documentation

◆ stateDict() [1/2]

const Foam::functionObjects::properties & stateDict ( ) const

protected

Return a const reference to the state dictionary.

Definition at line 41 of file stateFunctionObject.C.

References Time::functionObjects(), functionObjectList::propsDict(), and timeFunctionObject::time_.

Here is the call graph for this function:

◆ stateDict() [2/2]

Foam::functionObjects::properties & stateDict ( )

protected

Return non-const access to the state dictionary.

Definition at line 48 of file stateFunctionObject.C.

◆ operator=()

void operator= ( const stateFunctionObject & )

protecteddelete

No copy assignment.

◆ propertyDict()

Foam::dictionary & propertyDict ( )

Return access to the property dictionary.

Definition at line 71 of file stateFunctionObject.C.

References Foam::name().

Referenced by runTimeCondition::setConditionDict().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ foundProperty()

bool foundProperty ( const word & entryName ) const

Return true if the property exists.

Definition at line 100 of file stateFunctionObject.C.

References Foam::name().

Here is the call graph for this function:

◆ clearTrigger()

void clearTrigger ( )

Remove the trigger index from the properties.

Definition at line 77 of file stateFunctionObject.C.

◆ getTrigger()

Foam::label getTrigger ( ) const

Get the current trigger index.

Definition at line 83 of file stateFunctionObject.C.

◆ setTrigger()

bool setTrigger	(	const label	triggeri,
		bool	increaseOnly = `true`
	)

Set the trigger index. Normally only if greater than current.

Parameters

triggeri	the new trigger index
increaseOnly	(default) only change if new index is greater than the current index.

Returns: True if the index changed

Definition at line 90 of file stateFunctionObject.C.

Referenced by runTimeControl::execute().

Here is the caller graph for this function:

◆ getDict()

bool getDict	(	const word &	entryName,
		dictionary &	dict
	)		const

Set dictionary, return true if set.

Definition at line 109 of file stateFunctionObject.C.

References dict, and Foam::name().

Here is the call graph for this function:

◆ getObjectDict()

bool getObjectDict	(	const word &	objectName,
		const word &	entryName,
		dictionary &	dict
	)		const

Set dictionary from named object, return true if set.

Definition at line 119 of file stateFunctionObject.C.

References dict.

◆ getProperty() [1/2]

Type getProperty	(	const word &	entryName,
		const Type &	defaultValue = `Type(Zero)`
	)		const

Retrieve generic property.

Definition at line 35 of file stateFunctionObjectTemplates.C.

◆ getProperty() [2/2]

bool getProperty	(	const word &	entryName,
		Type &	value
	)		const

Set generic property, return true if set.

Definition at line 48 of file stateFunctionObjectTemplates.C.

References Foam::name().

Here is the call graph for this function:

◆ setProperty()

void setProperty	(	const word &	entryName,
		const Type &	value
	)

Add generic property.

Definition at line 59 of file stateFunctionObjectTemplates.C.

References Foam::name().

Referenced by runTimeControl::execute().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getObjectProperty() [1/2]

Type getObjectProperty	(	const word &	objectName,
		const word &	entryName,
		const Type &	defaultValue = `Type(Zero)`
	)		const

Retrieve generic property from named object.

Definition at line 70 of file stateFunctionObjectTemplates.C.

◆ getObjectProperty() [2/2]

bool getObjectProperty	(	const word &	objectName,
		const word &	entryName,
		Type &	value
	)		const

Set generic property from named object, return true if set.

Definition at line 84 of file stateFunctionObjectTemplates.C.

◆ setObjectProperty()

void setObjectProperty	(	const word &	objectName,
		const word &	entryName,
		const Type &	value
	)

Add generic property from named object.

Definition at line 96 of file stateFunctionObjectTemplates.C.

◆ setResult()

void setResult	(	const word &	entryName,
		const Type &	value
	)

Add result.

Definition at line 108 of file stateFunctionObjectTemplates.C.

References Foam::name().

Referenced by solverInfo::updateSolverInfo().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setObjectResult()

void setObjectResult	(	const word &	objectName,
		const word &	entryName,
		const Type &	value
	)

Add result from named object.

Definition at line 119 of file stateFunctionObjectTemplates.C.

◆ getResult()

Type getResult	(	const word &	entryName,
		const Type &	defaultValue = `Type(Zero)`
	)		const

Retrieve result.

Definition at line 131 of file stateFunctionObjectTemplates.C.

References Foam::name().

Here is the call graph for this function:

◆ getObjectResult() [1/2]

Type getObjectResult	(	const word &	objectName,
		const word &	entryName,
		const Type &	defaultValue = `Type(Zero)`
	)		const

Retrieve result from named object.

Definition at line 142 of file stateFunctionObjectTemplates.C.

◆ getObjectResult() [2/2]

bool getObjectResult	(	const word &	objectName,
		const word &	entryName,
		Type &	value
	)		const

Set result from named object, return true if set.

Definition at line 156 of file stateFunctionObjectTemplates.C.

◆ resultType()

Foam::word resultType ( const word & entryName ) const

Retrieve the result type.

Definition at line 130 of file stateFunctionObject.C.

References Foam::name().

Here is the call graph for this function:

◆ objectResultType()

Foam::word objectResultType	(	const word &	objectName,
		const word &	entryName
	)		const

Return the type of result.

Definition at line 139 of file stateFunctionObject.C.

Referenced by minMaxCondition::apply(), and multiFieldValue::write().

Here is the caller graph for this function:

◆ objectResultEntries() [1/2]

Foam::wordList objectResultEntries ( ) const

Retrieve the result entries.

Definition at line 149 of file stateFunctionObject.C.

References Foam::name().

Referenced by multiFieldValue::write().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ objectResultEntries() [2/2]

Foam::wordList objectResultEntries ( const word & objectName ) const

Return result entries for named object.

Definition at line 157 of file stateFunctionObject.C.

◆ writeResultEntries() [1/2]

void writeResultEntries ( Ostream & os ) const

Write the results entries for all objects to stream.

Definition at line 166 of file stateFunctionObject.C.

References Foam::name(), and os().

Here is the call graph for this function:

◆ writeResultEntries() [2/2]

void writeResultEntries	(	const word &	objectName,
		Ostream &	os
	)		const

Write the results entries for named object to stream.

Definition at line 175 of file stateFunctionObject.C.

References os().

Here is the call graph for this function:

◆ writeAllResultEntries()

void writeAllResultEntries ( Ostream & os ) const

Write the results entries for all objects to stream.

Definition at line 185 of file stateFunctionObject.C.

References os().

Here is the call graph for this function:

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

src/OpenFOAM/db/functionObjects/stateFunctionObject/stateFunctionObject.H
src/OpenFOAM/db/functionObjects/stateFunctionObject/stateFunctionObject.C
src/OpenFOAM/db/functionObjects/stateFunctionObject/stateFunctionObjectTemplates.C

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ stateFunctionObject() [1/2]

◆ stateFunctionObject() [2/2]

◆ ~stateFunctionObject()

Member Function Documentation

◆ stateDict() [1/2]

◆ stateDict() [2/2]

◆ operator=()

◆ propertyDict()

◆ foundProperty()

◆ clearTrigger()

◆ getTrigger()

◆ setTrigger()

◆ getDict()

◆ getObjectDict()

◆ getProperty() [1/2]

◆ getProperty() [2/2]

◆ setProperty()

◆ getObjectProperty() [1/2]

◆ getObjectProperty() [2/2]

◆ setObjectProperty()

◆ setResult()

◆ setObjectResult()

◆ getResult()

◆ getObjectResult() [1/2]

◆ getObjectResult() [2/2]

◆ resultType()

◆ objectResultType()

◆ objectResultEntries() [1/2]

◆ objectResultEntries() [2/2]

◆ writeResultEntries() [1/2]

◆ writeResultEntries() [2/2]

◆ writeAllResultEntries()