List of finite-area options. More...

#include <faOptionList.H>

Inheritance diagram for optionList:

[legend]

Collaboration diagram for optionList:

[legend]

Public Member Functions
	TypeName ("optionList")
	Runtime type information.
	optionList (const fvMesh &mesh, const word &defaultAreaName=word())
	Default construct from mesh.
	optionList (const fvMesh &mesh, const dictionary &dict, const word &defaultAreaName=word())
	Construct from mesh and dictionary.
	optionList (const optionList &)=delete
	No copy construct.
void	operator= (const optionList &)=delete
	No copy assignment.
virtual	~optionList ()=default
	Destructor.
const word &	areaName () const noexcept
	The finite-area mesh name.
void	reset (const dictionary &dict)
	Reset the source list.
bool	appliesToField (const word &fieldName) const
	Return whether there is something to apply to the field.
template<class Type>
tmp< faMatrix< Type > >	operator() (const areaScalarField &h, GeometricField< Type, faPatchField, areaMesh > &field)
	Return source for equation.
template<class Type>
tmp< faMatrix< Type > >	operator() (const areaScalarField &h, GeometricField< Type, faPatchField, areaMesh > &field, const word &fieldName)
	Return source for equation with specified name.
template<class Type>
tmp< faMatrix< Type > >	operator() (const areaScalarField &h, const areaScalarField &rho, GeometricField< Type, faPatchField, areaMesh > &field)
	Return source for equation.
template<class Type>
tmp< faMatrix< Type > >	operator() (const areaScalarField &h, const areaScalarField &rho, GeometricField< Type, faPatchField, areaMesh > &field, const word &fieldName)
	Return source for equation with specified name.
template<class Type>
tmp< faMatrix< Type > >	operator() (const areaScalarField &rho, GeometricField< Type, faPatchField, areaMesh > &field, const dimensionSet &ds)
	Return source for equation with specified name and dimensios.
template<class Type>
tmp< faMatrix< Type > >	d2dt2 (GeometricField< Type, faPatchField, areaMesh > &field)
	Return source for equation with second time derivative.
template<class Type>
tmp< faMatrix< Type > >	d2dt2 (GeometricField< Type, faPatchField, areaMesh > &field, const word &fieldName)
	Return source for equation with second time derivative.
template<class Type>
void	constrain (faMatrix< Type > &eqn)
	Apply constraints to equation.
template<class Type>
void	correct (GeometricField< Type, faPatchField, areaMesh > &field)
	Apply correction to field.
virtual bool	read (const dictionary &dict)
	Read dictionary.
virtual bool	writeData (Ostream &os) const
	Write data to Ostream.
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	source (GeometricField< Type, fvPatchField, volMesh > &field, const word &fieldName, const dimensionSet &ds)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (GeometricField< Type, fvPatchField, volMesh > &field, const word &fieldName)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const volScalarField &rho, GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const volScalarField &rho, GeometricField< Type, fvPatchField, volMesh > &field, const word &fieldName)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const volScalarField &alpha, const volScalarField &rho, GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const volScalarField &alpha, const volScalarField &rho, GeometricField< Type, fvPatchField, volMesh > &field, const word &fieldName)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const geometricOneField &alpha, const geometricOneField &rho, GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const volScalarField &alpha, const geometricOneField &rho, GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	operator() (const geometricOneField &alpha, const volScalarField &rho, GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	d2dt2 (GeometricField< Type, fvPatchField, volMesh > &field)
template<class Type>
Foam::tmp< Foam::fvMatrix< Type > >	d2dt2 (GeometricField< Type, fvPatchField, volMesh > &field, const word &fieldName)
Public Member Functions inherited from PtrList< fa::option >
Foam::PtrList< fa::option >	clone (Args &&... args) const
constexpr	PtrList () noexcept
	Default construct.
	~PtrList ()
	Destructor. Frees all pointers.
const fa::option *	set (const label i) const
	Return const pointer to element (can be nullptr), or nullptr for out-of-range access (ie, with bounds checking).
void	clear ()
	Clear the PtrList. Delete allocated entries and set size to zero.
void	free ()
	Free memory and nullify all entries. Does not change the list size.
void	resize (const label newLen)
	Adjust size of PtrList.
void	resize_null (const label newLen)
	Set the addressed list to the given size, deleting all existing entries. Afterwards the list contains all `nullptr` entries.
fa::option &	emplace_back (Args &&... args)
	Construct and append an element to the end of the list, return reference to the new list element.
void	push_back (fa::option *ptr)
	Append an element to the end of the list.
fa::option &	emplace_set (const label i, Args &&... args)
	Construct and set a new element at given position, (discard old element at that location).
fa::option &	emplace (const label i, Args &&... args)
	Same as emplace_set().
fa::option &	try_emplace (const label i, Args &&... args)
	Like emplace_set() but will not overwrite an occupied (non-null) location.
autoPtr< fa::option >	release (const label i)
	Release ownership of the pointer at the given position.
void	transfer (PtrList< fa::option > &list)
	Transfer into this list and annul the argument list.
void	operator= (const UPtrList< fa::option > &list)
	Copy assignment.
void	setSize (const label n)
	Same as resize().
void	append (autoPtr< fa::option > &ptr)
	Move append an element to the end of the list.
Public Member Functions inherited from UPtrList< fa::option >
bool	empty () const noexcept
	True if the list is empty (ie, size() is zero).
label	size () const noexcept
	The number of entries in the list.
label	capacity () const noexcept
	Size of the underlying storage.
label	count_nonnull () const noexcept
	The number of non-nullptr entries in the list.
fa::option &	front ()
	Reference to the first element of the list.
fa::option &	back ()
	Reference to the last element of the list.
const fa::option *	test (const label i) const
	Return const pointer to element (can be nullptr), or nullptr for out-of-range access (ie, with bounds checking).
const fa::option *	get (const label i) const
	Return const pointer to element (can be nullptr), or nullptr for out-of-range access (ie, with bounds checking).
const fa::option *	set (const label i) const
	Return const pointer to element (can be nullptr), or nullptr for out-of-range access (ie, with bounds checking).
void	clear ()
	Set list size to zero.
void	free ()
	Nullify all entries. Does not change the list size.
void	resize (const label newLen)
	Change the size of the list. Any new entries are `nullptr`.
void	resize_null (const label newLen)
	Set the list to the given size and set all entries to `nullptr`.
label	squeezeNull ()
	Squeeze out nullptr entries in the list of pointers after which any null pointers will be at the end of the list.
void	push_back (fa::option *ptr)
	Append an element to the end of the list.
void	swap (UPtrList< fa::option > &list) noexcept
	Swap content.
void	transfer (UPtrList< fa::option > &list)
	Transfer contents into this list and annul the argument.
void	reorder (const labelUList &oldToNew, const bool check=false)
	Reorder elements. Reordering must be unique (ie, shuffle).
void	sortOrder (const labelUList &order, const bool check=false)
	Reorder elements according to new order mapping (newToOld). Reordering must be unique (ie, shuffle).
void	checkNonNull () const
	Check and raise FatalError if any nullptr exists in the list.
const fa::option &	at (const label i) const
	Return const reference to the element at given position. FatalError for bounds problem or nullptr.
const fa::option &	operator[] (const label i) const
	Return const reference to the element at given position. FatalError for bounds problem or nullptr. Same as at().
	FOAM_DEPRECATED_FOR (2022-09, "get(), set() or test() methods") const fa::option *operator()(const label i) const
	Deprecated(2022-09) - same as get().
void	operator= (const UPtrList< fa::option > &list)
	Copy assignment (shallow copies addresses).
Ostream &	printAddresses (Ostream &os) const
	Print pointer addresses to Ostream (debugging only).
Ostream &	writeList (Ostream &os, const bool trimNull=false) const
	Write UPtrList to Ostream, optionally ignoring null entries.
fa::option **	begin_ptr () noexcept
	Iterator to begin of raw pointers traversal (use with caution).
fa::option **	end_ptr () noexcept
	Iterator beyond end of raw pointers traversal (use with caution).
iterator	begin ()
	Return iterator to begin traversal of non-nullptr entries.
iterator	end () noexcept
	Return iterator beyond end of UPtrList traversal.
const_iterator	cbegin () const
	Return const_iterator to begin traversal of non-nullptr entries.
const_iterator	cend () const noexcept
	Return const_iterator beyond end of UPtrList traversal.
void	setSize (const label n)
	Alias for resize().
fa::option &	first ()
	Reference to the first element of the list.
fa::option &	last ()
	Return reference to the last element of the list.
void	append (fa::option *ptr)
	Append an element to the end of the list.
label	count () const noexcept
	The number of non-nullptr entries in the list.

Protected Member Functions
bool	readOptions (const dictionary &dict)
	Read options dictionary.
void	checkApplied () const
	Check that all sources have been applied.
template<class Type>
tmp< faMatrix< Type > >	source (GeometricField< Type, faPatchField, areaMesh > &field, const areaScalarField &h, const word &fieldName, const dimensionSet &ds)
	Return source for equation with specified name and dimensions.
Protected Member Functions inherited from PtrList< fa::option >
void	readIstream (Istream &is, const INew &inew)
	Read from Istream using Istream constructor class.
Protected Member Functions inherited from UPtrList< fa::option >
void	setAddressableSize (const label n) noexcept
	Adjust addressable size.
label	find_next (label pos) const
	The next non-null entry after the specified position.
	UPtrList (Detail::PtrListDetail< fa::option > &&ptrs) noexcept
	Low-level move construct.

Static Protected Member Functions
static const dictionary &	optionsDict (const dictionary &dict)
	Return "options" sub-dictionary (if present) or return dict.

Protected Attributes
const fvMesh &	mesh_
	Reference to the mesh database.
word	areaName_
	The finite-area mesh name.
label	checkTimeIndex_
	Time index to check that all defined sources have been applied.
Protected Attributes inherited from UPtrList< fa::option >
Detail::PtrListDetail< fa::option >	ptrs_
	The list of pointers.

Friends
Ostream &	operator<< (Ostream &os, const optionList &options)
	Ostream operator.

Additional Inherited Members
Public Types inherited from UPtrList< fa::option >
typedef fa::option	value_type
	Type of values the list contains.
typedef fa::option &	reference
	A non-const reference to the value_type.
typedef const fa::option &	const_reference
	A const reference to the value_type.

Detailed Description

List of finite-area options.

SourceFile faOptionList.cxx faOptionList.txx

Definition at line 62 of file faOptionList.H.

Constructor & Destructor Documentation

◆ optionList() [1/3]

optionList	(	const fvMesh &	mesh,
		const word &	defaultAreaName = word() )

explicit

Default construct from mesh.

Parameters

defaultAreaName The expected finite-area mesh name

References mesh.

Referenced by operator<<, operator=(), and optionList().

Here is the caller graph for this function:

◆ optionList() [2/3]

optionList	(	const fvMesh &	mesh,
		const dictionary &	dict,
		const word &	defaultAreaName = word() )

Construct from mesh and dictionary.

Parameters

defaultAreaName The expected finite-area mesh name

References dict, and mesh.

◆ optionList() [3/3]

optionList ( const optionList & )

delete

No copy construct.

References optionList().

Here is the call graph for this function:

◆ ~optionList()

virtual ~optionList ( )

virtualdefault

Destructor.

Member Function Documentation

◆ optionsDict()

const dictionary & optionsDict ( const dictionary & dict )

staticprotected

Return "options" sub-dictionary (if present) or return dict.

References dict.

◆ readOptions()

bool readOptions ( const dictionary & dict )

protected

Read options dictionary.

References dict.

◆ checkApplied()

void checkApplied ( ) const

protected

Check that all sources have been applied.

Referenced by operator()(), and operator()().

Here is the caller graph for this function:

◆ source() [1/2]

template<class Type>

tmp< faMatrix< Type > > source	(	GeometricField< Type, faPatchField, areaMesh > &	field,
		const areaScalarField &	h,
		const word &	fieldName,
		const dimensionSet &	ds )

protected

Return source for equation with specified name and dimensions.

References field(), and h.

Referenced by d2dt2(), operator()(), operator()(), operator()(), and source().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TypeName()

TypeName ( "optionList" )

Runtime type information.

◆ operator=()

void operator= ( const optionList & )

delete

No copy assignment.

References optionList().

Here is the call graph for this function:

◆ areaName()

const word & areaName ( ) const

inlinenoexcept

The finite-area mesh name.

Definition at line 168 of file faOptionList.H.

References areaName_, and Foam::noexcept.

◆ reset()

void reset ( const dictionary & dict )

Reset the source list.

References dict.

◆ appliesToField()

bool appliesToField ( const word & fieldName ) const

Return whether there is something to apply to the field.

◆ operator()() [1/14]

template<class Type>

tmp< faMatrix< Type > > operator()	(	const areaScalarField &	h,
		GeometricField< Type, faPatchField, areaMesh > &	field )

Return source for equation.

References field(), and h.

Referenced by operator()(), operator()(), operator()(), operator()(), operator()(), and operator()().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ operator()() [2/14]

template<class Type>

tmp< faMatrix< Type > > operator()	(	const areaScalarField &	h,
		GeometricField< Type, faPatchField, areaMesh > &	field,
		const word &	fieldName )

Return source for equation with specified name.

References field(), and h.

Here is the call graph for this function:

◆ operator()() [3/14]

template<class Type>

tmp< faMatrix< Type > > operator()	(	const areaScalarField &	h,
		const areaScalarField &	rho,
		GeometricField< Type, faPatchField, areaMesh > &	field )

Return source for equation.

References field(), h, and rho.

Here is the call graph for this function:

◆ operator()() [4/14]

template<class Type>

tmp< faMatrix< Type > > operator()	(	const areaScalarField &	h,
		const areaScalarField &	rho,
		GeometricField< Type, faPatchField, areaMesh > &	field,
		const word &	fieldName )

Return source for equation with specified name.

References field(), h, and rho.

Here is the call graph for this function:

◆ operator()() [5/14]

template<class Type>

tmp< faMatrix< Type > > operator()	(	const areaScalarField &	rho,
		GeometricField< Type, faPatchField, areaMesh > &	field,
		const dimensionSet &	ds )

Return source for equation with specified name and dimensios.

References field(), and rho.

Here is the call graph for this function:

◆ d2dt2() [1/4]

template<class Type>

tmp< faMatrix< Type > > d2dt2 ( GeometricField< Type, faPatchField, areaMesh > & field )

Return source for equation with second time derivative.

References field().

Referenced by d2dt2().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ d2dt2() [2/4]

template<class Type>

tmp< faMatrix< Type > > d2dt2	(	GeometricField< Type, faPatchField, areaMesh > &	field,
		const word &	fieldName )

Return source for equation with second time derivative.

References field().

Here is the call graph for this function:

◆ constrain()

template<class Type>

void constrain ( faMatrix< Type > & eqn )

Apply constraints to equation.

Referenced by kinematicThinFilm::evolveRegion(), kinematicThinFilmIBM::evolveRegion(), and thermalShell::solveEnergy().

Here is the caller graph for this function:

◆ correct()

template<class Type>

void correct ( GeometricField< Type, faPatchField, areaMesh > & field )

Apply correction to field.

References field().

Referenced by kinematicThinFilm::evolveRegion(), kinematicThinFilmIBM::evolveRegion(), and thermalShell::solveEnergy().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ read()

virtual bool read ( const dictionary & dict )

virtual

Read dictionary.

Reimplemented in options.

References dict.

Referenced by options::~options().

Here is the caller graph for this function:

◆ writeData()

virtual bool writeData ( Ostream & os ) const

virtual

Write data to Ostream.

References os().

Here is the call graph for this function:

◆ source() [2/2]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > source	(	GeometricField< Type, fvPatchField, volMesh > &	field,
		const word &	fieldName,
		const dimensionSet &	ds )

Definition at line 29 of file fvOptionListTemplates.C.

References addProfiling, checkApplied(), Foam::endl(), field(), Foam::Info, Foam::New(), and source().

Here is the call graph for this function:

◆ operator()() [6/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator() ( GeometricField< Type, fvPatchField, volMesh > & field )

Definition at line 79 of file fvOptionListTemplates.C.

References field(), and operator()().

Here is the call graph for this function:

◆ operator()() [7/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	GeometricField< Type, fvPatchField, volMesh > &	field,
		const word &	fieldName )

Definition at line 89 of file fvOptionListTemplates.C.

References Foam::dimTime, Foam::dimVolume, field(), and source().

Here is the call graph for this function:

◆ operator()() [8/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const volScalarField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field )

Definition at line 100 of file fvOptionListTemplates.C.

References field(), operator()(), and rho.

Here is the call graph for this function:

◆ operator()() [9/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const volScalarField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field,
		const word &	fieldName )

Definition at line 111 of file fvOptionListTemplates.C.

References addProfiling, checkApplied(), Foam::dimTime, Foam::dimVolume, Foam::endl(), field(), Foam::Info, Foam::New(), rho, and source().

Here is the call graph for this function:

◆ operator()() [10/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const volScalarField &	alpha,
		const volScalarField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field )

Definition at line 166 of file fvOptionListTemplates.C.

References alpha, field(), operator()(), and rho.

Here is the call graph for this function:

◆ operator()() [11/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const volScalarField &	alpha,
		const volScalarField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field,
		const word &	fieldName )

Definition at line 178 of file fvOptionListTemplates.C.

References addProfiling, alpha, checkApplied(), Foam::dimTime, Foam::dimVolume, Foam::endl(), field(), Foam::Info, Foam::New(), rho, and source().

Here is the call graph for this function:

◆ operator()() [12/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const geometricOneField &	alpha,
		const geometricOneField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field )

Definition at line 235 of file fvOptionListTemplates.C.

References alpha, field(), operator()(), and rho.

Here is the call graph for this function:

◆ operator()() [13/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const volScalarField &	alpha,
		const geometricOneField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field )

Definition at line 247 of file fvOptionListTemplates.C.

References alpha, Foam::dimless, field(), mesh_, IOobjectOption::NO_READ, IOobjectOption::NO_REGISTER, IOobjectOption::NO_WRITE, operator()(), and rho.

Here is the call graph for this function:

◆ operator()() [14/14]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > operator()	(	const geometricOneField &	alpha,
		const volScalarField &	rho,
		GeometricField< Type, fvPatchField, volMesh > &	field )

Definition at line 274 of file fvOptionListTemplates.C.

References alpha, field(), operator()(), and rho.

Here is the call graph for this function:

◆ d2dt2() [3/4]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > d2dt2 ( GeometricField< Type, fvPatchField, volMesh > & field )

Definition at line 286 of file fvOptionListTemplates.C.

References d2dt2(), and field().

Here is the call graph for this function:

◆ d2dt2() [4/4]

template<class Type>

Foam::tmp< Foam::fvMatrix< Type > > d2dt2	(	GeometricField< Type, fvPatchField, volMesh > &	field,
		const word &	fieldName )

Definition at line 296 of file fvOptionListTemplates.C.

References Foam::dimTime, Foam::dimVolume, field(), source(), and Foam::sqr().

Here is the call graph for this function:

◆ operator<<

Ostream & operator<<	(	Ostream &	os,
		const optionList &	options )

friend

Ostream operator.

References optionList(), and os().

Member Data Documentation

◆ mesh_

const fvMesh& mesh_

protected

Reference to the mesh database.

Definition at line 73 of file faOptionList.H.

Referenced by operator()().

◆ areaName_

word areaName_

protected

The finite-area mesh name.

Definition at line 78 of file faOptionList.H.

Referenced by areaName().

◆ checkTimeIndex_

label checkTimeIndex_

protected

Time index to check that all defined sources have been applied.

Definition at line 83 of file faOptionList.H.

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

src/faOptions/faOption/faOptionList.H
src/finiteVolume/cfdTools/general/fvOptions/fvOptionListTemplates.C

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ optionList() [1/3]

◆ optionList() [2/3]

◆ optionList() [3/3]

◆ ~optionList()

Member Function Documentation

◆ optionsDict()

◆ readOptions()

◆ checkApplied()

◆ source() [1/2]

◆ TypeName()

◆ operator=()

◆ areaName()

◆ reset()

◆ appliesToField()

◆ operator()() [1/14]

◆ operator()() [2/14]

◆ operator()() [3/14]

◆ operator()() [4/14]

◆ operator()() [5/14]

◆ d2dt2() [1/4]

◆ d2dt2() [2/4]

◆ constrain()

◆ correct()

◆ read()

◆ writeData()

◆ source() [2/2]

◆ operator()() [6/14]

◆ operator()() [7/14]

◆ operator()() [8/14]

◆ operator()() [9/14]

◆ operator()() [10/14]

◆ operator()() [11/14]

◆ operator()() [12/14]

◆ operator()() [13/14]

◆ operator()() [14/14]

◆ d2dt2() [3/4]

◆ d2dt2() [4/4]

Friends And Related Symbol Documentation

◆ operator<<

Member Data Documentation

◆ mesh_

◆ areaName_

◆ checkTimeIndex_