Reports cloud information for particles passing through a specified cell zone. More...

#include <ParticleZoneInfo.H>

Inheritance diagram for ParticleZoneInfo< CloudType >:

[legend]

Collaboration diagram for ParticleZoneInfo< CloudType >:

[legend]

Public Member Functions
	TypeName ("particleZoneInfo")
	Runtime type information.
	ParticleZoneInfo (const dictionary &dict, CloudType &owner, const word &modelName)
	Construct from dictionary.
	ParticleZoneInfo (const ParticleZoneInfo< CloudType > &pe)
	Construct copy.
virtual autoPtr< CloudFunctionObject< CloudType > >	clone () const
	Construct and return a clone.
virtual	~ParticleZoneInfo ()=default
	Destructor.
virtual void	preEvolve (const typename parcelType::trackingData &td)
	Pre-evolve hook.
virtual void	postEvolve (const typename parcelType::trackingData &td)
	Post-evolve hook.
virtual bool	postMove (parcelType &p, const scalar dt, const point &position0, const typename parcelType::trackingData &td)
	Post-move hook.
virtual void	write ()
	Write.
Public Member Functions inherited from CloudFunctionObject< CloudType >
	TypeName ("cloudFunctionObject")
	Runtime type information.
	declareRunTimeSelectionTable (autoPtr, CloudFunctionObject, dictionary,(const dictionary &dict, CloudType &owner, const word &modelName),(dict, owner, modelName))
	Declare runtime constructor selection table.
	CloudFunctionObject (CloudType &owner)
	Construct null from owner.
	CloudFunctionObject (const dictionary &dict, CloudType &owner, const word &objectType, const word &modelName)
	Construct from dictionary.
	CloudFunctionObject (const CloudFunctionObject< CloudType > &ppm)
	Construct copy.
virtual	~CloudFunctionObject ()=default
	Destructor.
virtual bool	postPatch (const parcelType &p, const polyPatch &pp, const typename parcelType::trackingData &td)
	Post-patch hook.
virtual bool	postFace (const parcelType &p, const typename parcelType::trackingData &td)
	Post-face hook.
const fileName &	outputDir () const
	Return the output path.
fileName	writeTimeDir () const
	Return the output time path.
Public Member Functions inherited from CloudSubModelBase< CloudType >
	CloudSubModelBase (CloudType &owner)
	Construct null from owner cloud.
	CloudSubModelBase (CloudType &owner, const dictionary &dict, const word &baseName, const word &modelType, const word &dictExt="Coeffs")
	Construct from owner cloud without name.
	CloudSubModelBase (const word &modelName, CloudType &owner, const dictionary &dict, const word &baseName, const word &modelType)
	Construct from owner cloud with name.
	CloudSubModelBase (const CloudSubModelBase< CloudType > &smb)
	Construct as copy.
virtual	~CloudSubModelBase ()=default
	Destructor.
const CloudType &	owner () const
	Return const access to the owner cloud.
virtual bool	writeTime () const
	Flag to indicate when to write a property.
virtual fileName	localPath () const
	Output directory.
CloudType &	owner ()
	Return non-const access to the owner cloud for manipulation.
virtual void	info ()
	Write to info.
virtual void	write (Ostream &os) const
	Write to os.
Public Member Functions inherited from subModelBase
	subModelBase (dictionary &properties)
	Construct null.
	subModelBase (dictionary &properties, const dictionary &dict, const word &baseName, const word &modelType, const word &dictExt="Coeffs")
	Construct from components without name.
	subModelBase (const word &modelName, dictionary &properties, const dictionary &dict, const word &baseName, const word &modelType)
	Construct from components with name.
	subModelBase (const subModelBase &smb)
	Construct as copy.
virtual	~subModelBase ()=default
	Destructor.
const word &	modelName () const
	Return const access to the name of the sub-model.
const dictionary &	dict () const
	Return const access to the cloud dictionary.
const word &	baseName () const
	Return const access to the base name of the sub-model.
const word &	modelType () const
	Return const access to the sub-model type.
const dictionary &	coeffDict () const
	Return const access to the coefficients dictionary.
const dictionary &	properties () const
	Return const access to the properties dictionary.
virtual bool	defaultCoeffs (const bool printMsg) const
	Returns true if defaultCoeffs is true and outputs on printMsg.
virtual bool	active () const
	Return the model 'active' status - default active = true.
virtual void	cacheFields (const bool store)
	Cache dependent sub-model fields.
template<class Type>
Type	getBaseProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from the base model.
template<class Type>
void	getBaseProperty (const word &entryName, Type &value) const
	Retrieve generic property from the base model.
template<class Type>
void	setBaseProperty (const word &entryName, const Type &value)
	Add generic property to the base model.
bool	getModelDict (const word &entryName, dictionary &dict) const
	Retrieve dictionary, return true if set.
template<class Type>
bool	getModelProperty (const word &entryName, Type &value) const
	Retrieve generic property from the sub-model.
template<class Type>
Type	getModelProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from the sub-model.
template<class Type>
void	setModelProperty (const word &entryName, const Type &value)
	Add generic property to the sub-model.
Public Member Functions inherited from writeFile
	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name="undefined", const bool writeToFile=true, const string &ext=".dat")
	Construct from objectRegistry, prefix, fileName.
	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name, const dictionary &dict, const bool writeToFile=true, const string &ext=".dat")
	Construct from objectRegistry, prefix, fileName and read options from dictionary.
	writeFile (const writeFile &wf)
	Construct copy.
virtual	~writeFile ()=default
	Destructor.
virtual bool	read (const dictionary &dict)
	Read.
virtual const string &	setExt (const string &ext)
	Set extension.
virtual OFstream &	file ()
	Return access to the file (if only 1).
virtual bool	writeToFile () const
	Flag to allow writing to file.
virtual bool	canWriteToFile () const
	Flag to allow writing to the file.
virtual bool	canResetFile () const
	Flag to allow resetting the file.
virtual bool	canWriteHeader () const
	Flag to allow writing the header.
virtual label	charWidth () const
	Return width of character stream output.
virtual void	writeCommented (Ostream &os, const string &str) const
	Write a commented string to stream.
virtual void	writeTabbed (Ostream &os, const string &str) const
	Write a tabbed string to stream.
virtual void	writeHeader (Ostream &os, const string &str) const
	Write a commented header to stream.
virtual void	writeCurrentTime (Ostream &os) const
	Write the current time to stream.
virtual void	writeBreak (Ostream &os) const
	Write a break marker to the stream.
template<class Type>
void	writeHeaderValue (Ostream &os, const string &property, const Type &value) const
	Write a (commented) header property and value pair.
template<class Type>
void	writeValue (Ostream &os, const Type &val) const
	Write a given value to stream with the space delimiter.

Additional Inherited Members
Public Types inherited from CloudSubModelBase< CloudType >
typedef CloudType	cloudType
	Type of cloud this model was instantiated for.
Static Public Member Functions inherited from CloudFunctionObject< CloudType >
static autoPtr< CloudFunctionObject< CloudType > >	New (const dictionary &dict, CloudType &owner, const word &objectType, const word &modelName)
	Selector.
Public Attributes inherited from subModelBase
bool	log
	Flag to write log into Info.
Static Public Attributes inherited from writeFile
static label	addChars = 8
	Additional characters for writing.
Protected Member Functions inherited from subModelBase
bool	inLine () const
	Flag to indicate whether data is/was read in-line.
Protected Member Functions inherited from writeFile
void	initStream (Ostream &os) const
	Initialise the output stream for writing.
fileName	baseFileDir () const
	Return the base directory for output.
fileName	baseTimeDir () const
	Return the base directory for the current time value.
fileName	filePath (const fileName &fName) const
	Return the full path for the supplied file name.
virtual autoPtr< OFstream >	newFile (const fileName &fName) const
	Return autoPtr to a new file using file name.
virtual autoPtr< OFstream >	newFileAtTime (const word &name, scalar timeValue) const
	Return autoPtr to a new file for a given time.
virtual autoPtr< OFstream >	newFileAtStartTime (const word &name) const
	Return autoPtr to a new file using the simulation start time.
virtual void	resetFile (const word &name)
	Reset internal file pointer to new file with new name.
Omanip< int >	valueWidth (const label offset=0) const
	Return the value width when writing to stream with optional offset.
void	operator= (const writeFile &)=delete
	No copy assignment.
virtual autoPtr< OFstream >	createFile (const word &name, scalar timeValue) const
	Deprecated(2022-09) Return autoPtr to a new file for a given time.
virtual autoPtr< OFstream >	createFile (const word &name) const
	Deprecated(2022-09) Return autoPtr to a new file using the simulation start time.
Protected Attributes inherited from CloudSubModelBase< CloudType >
CloudType &	owner_
	Reference to the cloud.
Protected Attributes inherited from subModelBase
const word	modelName_
	Name of the sub-model.
dictionary &	properties_
	Reference to properties dictionary e.g. for restart.
const dictionary	dict_
	Copy of dictionary used during construction.
const word	baseName_
	Name of the sub-model base class.
const word	modelType_
	Type of the sub-model.
const dictionary	coeffDict_
	Coefficients dictionary.
Protected Attributes inherited from writeFile
const objectRegistry &	fileObr_
	Reference to the region objectRegistry.
const fileName	prefix_
	Prefix.
word	fileName_
	Name of file.
autoPtr< OFstream >	filePtr_
	File pointer.
label	writePrecision_
	Write precision.
bool	writeToFile_
	Flag to enable/disable writing to file.
bool	updateHeader_
	Flag to update the header, e.g. on mesh changes. Default is true.
bool	writtenHeader_
	Flag to identify whether the header has been written.
bool	useUserTime_
	Flag to use the specified user time, e.g. CA deg instead of seconds. Default = true.
scalar	startTime_
	Start time value.
string	ext_
	File extension; default = .dat.

Detailed Description

template<class CloudType>
class Foam::ParticleZoneInfo< CloudType >

Reports cloud information for particles passing through a specified cell zone.

Usage

Example usage:

cloudFunctions
{
    particleZoneInfo1
    {
        // Mandatory entries
        type            particleZoneInfo;
        cellZone        leftFluid;

        // Optional entries
        writer          vtk;
    }
}

Results are written to file:

<case>/postProcessing/lagrangian/<cloudName>/<functionName>/<time>

# cellZone        : leftFluid
# time            : 1.0000000000e+00
#
# origID    origProc    (x y z)    time0    age    d0    d    mass0    mass

Where

origID : particle ID
origProc : processor ID
(x y z) : Cartesian co-ordinates
time0 : time particle enters the cellZone
age : time spent in the cellZone
d0 : diameter on entry to the cellZone
d : current diameter
mass0 : mass on entry to the cellZone
mass : current mass

If the optional writer entry is supplied, cloud data is written in the specified format.

During the run, output statistics are reported after the cloud solution, e.g.:

particleZoneInfo:
    Cell zone                       = leftFluid
    Contributions                   = 257

Here, 'Contributions' refers to the number of incremental particle-move contributions recorded during this time step. At write times, the output is extended, e.g.:

particleZoneInfo:
    Cell zone                       = leftFluid
    Contributions                   = 822
    Number of particles             = 199
    Written data to "postProcessing/lagrangian/reactingCloud1/

Source files

Definition at line 202 of file ParticleZoneInfo.H.

Constructor & Destructor Documentation

◆ ParticleZoneInfo() [1/2]

template<class CloudType>

ParticleZoneInfo	(	const dictionary &	dict,
		CloudType &	owner,
		const word &	modelName )

Construct from dictionary.

Definition at line 173 of file ParticleZoneInfo.C.

References CloudFunctionObject< CloudType >::CloudFunctionObject(), subModelBase::coeffDict(), subModelBase::dict(), Foam::endl(), Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, coordSetWriter::formatOptions(), subModelBase::getModelProperty(), dictionary::getWord(), Foam::GlobalIOList< Tuple2< scalar, vector > >::typeName, Foam::Info, CloudSubModelBase< CloudType >::localPath(), UPstream::master(), subModelBase::modelName(), coordSetWriter::New(), UPstream::nProcs(), CloudSubModelBase< CloudType >::owner(), UList< T >::size(), WarningInFunction, writeFile::writeFile(), and Foam::Zero.

Referenced by clone(), ParticleZoneInfo(), and TypeName().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ParticleZoneInfo() [2/2]

template<class CloudType>

ParticleZoneInfo ( const ParticleZoneInfo< CloudType > & pe )

Construct copy.

Definition at line 251 of file ParticleZoneInfo.C.

References CloudFunctionObject< CloudType >::CloudFunctionObject(), ParticleZoneInfo(), and writeFile::writeFile().

Here is the call graph for this function:

◆ ~ParticleZoneInfo()

template<class CloudType>

virtual ~ParticleZoneInfo ( )

virtualdefault

Destructor.

References p, and td().

Here is the call graph for this function:

Member Function Documentation

◆ TypeName()

template<class CloudType>

TypeName ( "particleZoneInfo" )

Runtime type information.

References subModelBase::dict(), subModelBase::modelName(), CloudSubModelBase< CloudType >::owner(), and ParticleZoneInfo().

Here is the call graph for this function:

◆ clone()

template<class CloudType>

virtual autoPtr< CloudFunctionObject< CloudType > > clone ( ) const

inlinevirtual

Construct and return a clone.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 301 of file ParticleZoneInfo.H.

References ParticleZoneInfo().

Here is the call graph for this function:

◆ preEvolve()

template<class CloudType>

void preEvolve ( const typename parcelType::trackingData & td )

virtual

Pre-evolve hook.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 270 of file ParticleZoneInfo.C.

References td().

Here is the call graph for this function:

◆ postEvolve()

template<class CloudType>

void postEvolve ( const typename parcelType::trackingData & td )

virtual

Post-evolve hook.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 278 of file ParticleZoneInfo.C.

References Foam::endl(), Log_, Foam::max(), Foam::nl, p, CloudFunctionObject< CloudType >::postEvolve(), Foam::returnReduce(), td(), Foam::type(), and CloudSubModelBase< CloudType >::writeTime().

Here is the call graph for this function:

◆ postMove()

template<class CloudType>

bool postMove	(	parcelType &	p,
		const scalar	dt,
		const point &	position0,
		const typename parcelType::trackingData &	td )

virtual

Post-move hook.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 319 of file ParticleZoneInfo.C.

References particleInfo::age, particleInfo::d, particleInfo::d0, particleInfo::mass, particleInfo::mass0, particleInfo::origID, particleInfo::origProc, CloudSubModelBase< CloudType >::owner(), p, particleInfo::position, td(), and particleInfo::time0.

Here is the call graph for this function:

◆ write()

template<class CloudType>

void write ( )

virtual

Write.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 348 of file ParticleZoneInfo.C.

References DynamicList< T, SizeMin >::append(), Foam::endl(), forAll, Pstream::listCombineGather(), Pstream::listReduce(), Log_, UPstream::master(), n, writeFile::newFileAtTime(), Foam::nl, UPstream::nProcs(), os(), CloudSubModelBase< CloudType >::owner(), p, UPstream::parRun(), List< T >::resize(), Foam::returnReduce(), and subModelBase::setModelProperty().

Here is the call graph for this function:

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

src/lagrangian/intermediate/submodels/CloudFunctionObjects/ParticleZoneInfo/ParticleZoneInfo.H
src/lagrangian/intermediate/submodels/CloudFunctionObjects/ParticleZoneInfo/ParticleZoneInfo.C

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ParticleZoneInfo() [1/2]

◆ ParticleZoneInfo() [2/2]

◆ ~ParticleZoneInfo()

Member Function Documentation

◆ TypeName()

◆ clone()

◆ preEvolve()

◆ postEvolve()

◆ postMove()

◆ write()