Writes out various standard Lagrangian data elements of particles hitting on a given list of patches or face zones. More...

Inheritance diagram for ParticlePostProcessing< CloudType >:

[legend]

Collaboration diagram for ParticlePostProcessing< CloudType >:

[legend]

Public Member Functions
	TypeName ("particlePostProcessing")
	Runtime type information. More...

	ParticlePostProcessing (const dictionary &dict, CloudType &owner, const word &modelName)
	Construct from dictionary. More...

	ParticlePostProcessing (const ParticlePostProcessing< CloudType > &ppp)
	Copy construct. More...

void	operator= (const ParticlePostProcessing< CloudType > &)=delete
	No copy assignment. More...

virtual autoPtr< CloudFunctionObject< CloudType > >	clone () const
	Construct and return a clone. More...

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

label	maxStoredParcels () const noexcept
	Return maximum number of parcels to store per surface. More...

virtual void	postPatch (const parcelType &p, const polyPatch &pp, bool &keepParticle)
	Post-patch hook. More...

virtual void	postFace (const parcelType &p, bool &keepParticle)
	Post-face hook. More...

virtual void	write ()
	Write post-processing info. More...

Public Member Functions inherited from CloudFunctionObject< CloudType >
	TypeName ("cloudFunctionObject")
	Runtime type information. More...

	declareRunTimeSelectionTable (autoPtr, CloudFunctionObject, dictionary,(const dictionary &dict, CloudType &owner, const word &modelName),(dict, owner, modelName))
	Declare runtime constructor selection table. More...

	CloudFunctionObject (CloudType &owner)
	Construct null from owner. More...

	CloudFunctionObject (const dictionary &dict, CloudType &owner, const word &objectType, const word &modelName)
	Construct from dictionary. More...

	CloudFunctionObject (const CloudFunctionObject< CloudType > &ppm)
	Construct copy. More...

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

virtual void	preEvolve (const typename parcelType::trackingData &td)
	Pre-evolve hook. More...

virtual void	postEvolve (const typename parcelType::trackingData &td)
	Post-evolve hook. More...

virtual void	postMove (parcelType &p, const scalar dt, const point &position0, bool &keepParticle)
	Post-move hook. More...

const fileName &	outputDir () const
	Return the output path. More...

fileName	writeTimeDir () const
	Return the output time path. More...

Public Member Functions inherited from CloudSubModelBase< CloudType >
	CloudSubModelBase (CloudType &owner)
	Construct null from owner cloud. More...

	CloudSubModelBase (CloudType &owner, const dictionary &dict, const word &baseName, const word &modelType, const word &dictExt="Coeffs")
	Construct from owner cloud without name. More...

	CloudSubModelBase (const word &modelName, CloudType &owner, const dictionary &dict, const word &baseName, const word &modelType)
	Construct from owner cloud with name. More...

	CloudSubModelBase (const CloudSubModelBase< CloudType > &smb)
	Construct as copy. More...

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

const CloudType &	owner () const
	Return const access to the owner cloud. More...

virtual bool	writeTime () const
	Flag to indicate when to write a property. More...

virtual fileName	localPath () const
	Output directory. More...

CloudType &	owner ()
	Return non-const access to the owner cloud for manipulation. More...

virtual void	info ()
	Write to info. More...

virtual void	write (Ostream &os) const
	Write to os. More...

Public Member Functions inherited from subModelBase
	subModelBase (dictionary &properties)
	Construct null. More...

	subModelBase (dictionary &properties, const dictionary &dict, const word &baseName, const word &modelType, const word &dictExt="Coeffs")
	Construct from components without name. More...

	subModelBase (const word &modelName, dictionary &properties, const dictionary &dict, const word &baseName, const word &modelType)
	Construct from components with name. More...

	subModelBase (const subModelBase &smb)
	Construct as copy. More...

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

const word &	modelName () const
	Return const access to the name of the sub-model. More...

const dictionary &	dict () const
	Return const access to the cloud dictionary. More...

const word &	baseName () const
	Return const access to the base name of the sub-model. More...

const word &	modelType () const
	Return const access to the sub-model type. More...

const dictionary &	coeffDict () const
	Return const access to the coefficients dictionary. More...

const dictionary &	properties () const
	Return const access to the properties dictionary. More...

virtual bool	defaultCoeffs (const bool printMsg) const
	Returns true if defaultCoeffs is true and outputs on printMsg. More...

virtual bool	active () const
	Return the model 'active' status - default active = true. More...

virtual void	cacheFields (const bool store)
	Cache dependent sub-model fields. More...

template<class Type >
Type	getBaseProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from the base model. More...

template<class Type >
void	getBaseProperty (const word &entryName, Type &value) const
	Retrieve generic property from the base model. More...

template<class Type >
void	setBaseProperty (const word &entryName, const Type &value)
	Add generic property to the base model. More...

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

template<class Type >
bool	getModelProperty (const word &entryName, Type &value) const
	Retrieve generic property from the sub-model. More...

template<class Type >
Type	getModelProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const
	Retrieve generic property from the sub-model. More...

template<class Type >
void	setModelProperty (const word &entryName, const Type &value)
	Add generic property to the sub-model. More...

Public Member Functions inherited from writeFile
	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name="undefined", const bool writeToFile=true)
	Construct from objectRegistry, prefix, fileName. More...

	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name, const dictionary &dict, const bool writeToFile=true)
	Construct from objectRegistry, prefix, fileName and read options from dictionary. More...

	writeFile (const writeFile &wf)
	Construct copy. More...

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

virtual bool	read (const dictionary &dict)
	Read. More...

virtual OFstream &	file ()
	Return access to the file (if only 1) More...

virtual bool	writeToFile () const
	Flag to allow writing to file. More...

virtual bool	canWriteToFile () const
	Flag to allow writing to the file. More...

virtual bool	canResetFile () const
	Flag to allow resetting the file. More...

virtual bool	canWriteHeader () const
	Flag to allow writing the header. More...

virtual label	charWidth () const
	Return width of character stream output. More...

virtual void	writeCommented (Ostream &os, const string &str) const
	Write a commented string to stream. More...

virtual void	writeTabbed (Ostream &os, const string &str) const
	Write a tabbed string to stream. More...

virtual void	writeHeader (Ostream &os, const string &str) const
	Write a commented header to stream. More...

virtual void	writeCurrentTime (Ostream &os) const
	Write the current time to stream. More...

virtual void	writeBreak (Ostream &os) const
	Write a break marker to the stream. More...

template<class Type >
void	writeHeaderValue (Ostream &os, const string &property, const Type &value) const
	Write a (commented) header property and value pair. More...

template<class Type >
void	writeValue (Ostream &os, const Type &val) const
	Write a given value to stream with the space delimiter. More...

Additional Inherited Members
Public Types inherited from CloudSubModelBase< CloudType >
typedef CloudType	cloudType
	Type of cloud this model was instantiated for. More...

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. More...

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

Static Public Attributes inherited from writeFile
static label	addChars = 8
	Additional characters for writing. More...

Protected Member Functions inherited from subModelBase
bool	inLine () const
	Flag to indicate whether data is/was read in-line. More...

Protected Member Functions inherited from writeFile
void	initStream (Ostream &os) const
	Initialise the output stream for writing. More...

fileName	baseFileDir () const
	Return the base directory for output. More...

fileName	baseTimeDir () const
	Return the base directory for the current time value. More...

fileName	filePath (const fileName &fName) const
	Return the full path for the supplied file name. More...

virtual autoPtr< OFstream >	newFile (const fileName &fName) const
	Return autoPtr to a new file using file name. More...

virtual autoPtr< OFstream >	newFileAtTime (const word &name, scalar timeValue) const
	Return autoPtr to a new file for a given time. More...

virtual autoPtr< OFstream >	newFileAtStartTime (const word &name) const
	Return autoPtr to a new file using the simulation start time. More...

virtual void	resetFile (const word &name)
	Reset internal file pointer to new file with new name. More...

Omanip< int >	valueWidth (const label offset=0) const
	Return the value width when writing to stream with optional offset. More...

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

virtual autoPtr< OFstream >	createFile (const word &name, scalar timeValue) const
	Deprecated(2022-09) Return autoPtr to a new file for a given time. More...

virtual autoPtr< OFstream >	createFile (const word &name) const
	Deprecated(2022-09) Return autoPtr to a new file using the simulation start time. More...

Protected Attributes inherited from CloudSubModelBase< CloudType >
CloudType &	owner_
	Reference to the cloud. More...

Protected Attributes inherited from subModelBase
const word	modelName_
	Name of the sub-model. More...

dictionary &	properties_
	Reference to properties dictionary e.g. for restart. More...

const dictionary	dict_
	Copy of dictionary used during construction. More...

const word	baseName_
	Name of the sub-model base class. More...

const word	modelType_
	Type of the sub-model. More...

const dictionary	coeffDict_
	Coefficients dictionary. More...

Protected Attributes inherited from writeFile
const objectRegistry &	fileObr_
	Reference to the region objectRegistry. More...

const fileName	prefix_
	Prefix. More...

word	fileName_
	Name of file. More...

autoPtr< OFstream >	filePtr_
	File pointer. More...

label	writePrecision_
	Write precision. More...

bool	writeToFile_
	Flag to enable/disable writing to file. More...

bool	updateHeader_
	Flag to update the header, e.g. on mesh changes. Default is true. More...

bool	writtenHeader_
	Flag to identify whether the header has been written. More...

bool	useUserTime_
	Flag to use the specified user time, e.g. CA deg instead of seconds. Default = true. More...

scalar	startTime_
	Start time value. More...

Detailed Description

template<class CloudType>
class Foam::ParticlePostProcessing< CloudType >

Writes out various standard Lagrangian data elements of particles hitting on a given list of patches or face zones.

Operands:

Operand	Type	Location
`input`	-	-
`output` file	dat	<case>/postProcessing/<FO>/<time>/<file>
`output` field	-	-

The output file contains columns depending on the fields entry.

Usage

Minimal example by using constant/reactingCloud1Properties.cloudFunctions:

ParticlePostProcessing1
{
    // Mandatory entries
    type                 particlePostProcessing;
    maxStoredParcels     <scalar>;

    // Optional entries
    fields               (<wordRes>);

    // Conditional entries

        // Option-1
        patches          (<wordRes>);

        // Option-2
        faceZones        (<wordRes>);

    // Inherited entries
    ...
}

where the entries mean:

Property	Description	Type	Reqd	Deflt
`type`	Type name: particlePostProcessing	word	yes	-
`maxStoredParcels`	Maximum number of parcels to process	label	yes	-
`fields`	Names of standard Lagrangian fields	wordRes	no	all
`patches`	Names of operand patches	wordRes	choice	-
`faceZones`	Names of operand face zones	wordRes	choice	-

The inherited entries are elaborated in:

Note

The underlying type of maxStoredParcels is set as a scalar for I/O.
Empty files indicate that no particles hit selected surfaces.

Source files

Definition at line 157 of file ParticlePostProcessing.H.

Constructor & Destructor Documentation

◆ ParticlePostProcessing() [1/2]

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

Construct from dictionary.

Definition at line 49 of file ParticlePostProcessing.C.

References Foam::exit(), Foam::FatalIOError, FatalIOErrorInFunction, and Foam::blockMeshTools::read().

Here is the call graph for this function:

◆ ParticlePostProcessing() [2/2]

ParticlePostProcessing ( const ParticlePostProcessing< CloudType > & ppp )

Copy construct.

Definition at line 89 of file ParticlePostProcessing.C.

◆ ~ParticlePostProcessing()

virtual ~ParticlePostProcessing ( )

virtualdefault

Destructor.

Member Function Documentation

◆ TypeName()

TypeName ( "particlePostProcessing" )

Runtime type information.

◆ operator=()

void operator= ( const ParticlePostProcessing< CloudType > & )

delete

No copy assignment.

◆ clone()

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

inlinevirtual

Construct and return a clone.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 243 of file ParticlePostProcessing.H.

◆ maxStoredParcels()

label maxStoredParcels ( ) const

inlinenoexcept

Return maximum number of parcels to store per surface.

Definition at line 265 of file ParticlePostProcessing.H.

◆ postPatch()

void postPatch	(	const parcelType &	p,
		const polyPatch &	pp,
		bool &	keepParticle
	)

virtual

Post-patch hook.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 108 of file ParticlePostProcessing.C.

References p, and pp().

Here is the call graph for this function:

◆ postFace()

void postFace	(	const parcelType &	p,
		bool &	keepParticle
	)

virtual

Post-face hook.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 144 of file ParticlePostProcessing.C.

References PtrList< T >::append(), forAll, and p.

Here is the call graph for this function:

◆ write()

void write ( )

virtual

Write post-processing info.

Reimplemented from CloudFunctionObject< CloudType >.

Definition at line 191 of file ParticlePostProcessing.C.

References Foam::combineReduce(), forAll, Foam::PtrListOps::names(), Foam::nl, os(), autoPtr< T >::ref(), Foam::sortedOrder(), Foam::tab, x, and y.

Here is the call graph for this function:

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

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

Public Member Functions

Additional Inherited Members

Detailed Description

template<class CloudType> class Foam::ParticlePostProcessing< CloudType >

Constructor & Destructor Documentation

◆ ParticlePostProcessing() [1/2]

◆ ParticlePostProcessing() [2/2]

◆ ~ParticlePostProcessing()

Member Function Documentation

◆ TypeName()

◆ operator=()

◆ clone()

◆ maxStoredParcels()

◆ postPatch()

◆ postFace()

◆ write()

template<class CloudType>
class Foam::ParticlePostProcessing< CloudType >