Creates a droplet size distribution via interrogating a continuous phase fraction field. More...

Inheritance diagram for regionSizeDistribution:

Collaboration diagram for regionSizeDistribution:

Public Member Functions
	TypeName ("regionSizeDistribution")

	regionSizeDistribution (const word &name, const Time &runTime, const dictionary &)

	regionSizeDistribution (const regionSizeDistribution &)=delete

void	operator= (const regionSizeDistribution &)=delete

virtual	~regionSizeDistribution ()=default

virtual bool	read (const dictionary &)

virtual bool	execute ()

virtual bool	write ()

template<class Type >
Foam::Map< Type >	regionSum (const regionSplit &regions, const Field< Type > &fld) const

template<class Type >
Foam::List< Type >	extractData (const labelUList &keys, const Map< Type > &regionData) const

Public Member Functions inherited from fvMeshFunctionObject
	TypeName ("fvMeshFunctionObject")

	fvMeshFunctionObject (const word &name, const Time &runTime, const dictionary &dict)

	fvMeshFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)

virtual	~fvMeshFunctionObject ()=default

Public Member Functions inherited from regionFunctionObject
	TypeName ("regionFunctionObject")

	regionFunctionObject (const word &name, const Time &runTime, const dictionary &dict)

	regionFunctionObject (const word &name, const objectRegistry &obr, const dictionary &dict)

virtual	~regionFunctionObject ()=default

template<class ObjectType >
const ObjectType *	lookupObjectPtr (const word &fieldName) const

template<class ObjectType >
ObjectType *	lookupObjectRefPtr (const word &fieldName) const

Public Member Functions inherited from stateFunctionObject
	stateFunctionObject (const word &name, const Time &runTime)

virtual	~stateFunctionObject ()=default

dictionary &	propertyDict ()

bool	foundProperty (const word &entryName) const

void	clearTrigger ()

label	getTrigger () const

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

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

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

template<class Type >
Type	getProperty (const word &entryName, const Type &defaultValue=Type(Zero)) const

template<class Type >
bool	getProperty (const word &entryName, Type &value) const

template<class Type >
void	setProperty (const word &entryName, const Type &value)

template<class Type >
Type	getObjectProperty (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const

template<class Type >
bool	getObjectProperty (const word &objectName, const word &entryName, Type &value) const

template<class Type >
void	setObjectProperty (const word &objectName, const word &entryName, const Type &value)

template<class Type >
void	setResult (const word &entryName, const Type &value)

template<class Type >
void	setObjectResult (const word &objectName, const word &entryName, const Type &value)

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

template<class Type >
Type	getObjectResult (const word &objectName, const word &entryName, const Type &defaultValue=Type(Zero)) const

template<class Type >
bool	getObjectResult (const word &objectName, const word &entryName, Type &value) const

word	resultType (const word &entryName) const

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

wordList	objectResultEntries () const

wordList	objectResultEntries (const word &objectName) const

void	writeResultEntries (Ostream &os) const

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

void	writeAllResultEntries (Ostream &os) const

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

virtual	~timeFunctionObject ()=default

const Time &	time () const

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)

autoPtr< functionObject >	clone () const

virtual	~functionObject ()=default

virtual const word &	type () const =0

const word &	name () const noexcept

bool	useNamePrefix () const noexcept

bool	useNamePrefix (bool on) noexcept

virtual bool	execute (const label subIndex)

virtual bool	end ()

virtual bool	adjustTimeStep ()

virtual bool	filesModified () const

virtual void	updateMesh (const mapPolyMesh &mpm)

virtual void	movePoints (const polyMesh &mesh)

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

	writeFile (const objectRegistry &obr, const fileName &prefix, const word &name, const dictionary &dict, const bool writeToFile=true)

	writeFile (const writeFile &wf)

virtual	~writeFile ()=default

virtual OFstream &	file ()

virtual bool	writeToFile () const

virtual bool	canWriteHeader () const

virtual label	charWidth () const

virtual void	writeCommented (Ostream &os, const string &str) const

virtual void	writeTabbed (Ostream &os, const string &str) const

virtual void	writeHeader (Ostream &os, const string &str) const

virtual void	writeCurrentTime (Ostream &os) const

virtual void	writeBreak (Ostream &os) const

template<class Type >
void	writeHeaderValue (Ostream &os, const string &property, const Type &value) const

Additional Inherited Members
Static Public Member Functions inherited from functionObject
static autoPtr< functionObject >	New (const word &name, const Time &runTime, const dictionary &dict)

Public Attributes inherited from functionObject
bool	log

Static Public Attributes inherited from functionObject
static int	debug

static bool	postProcess

static bool	defaultUseNamePrefix

static word	outputPrefix

Static Public Attributes inherited from writeFile
static label	addChars = 8

Protected Member Functions inherited from fvMeshFunctionObject
	fvMeshFunctionObject (const fvMeshFunctionObject &)=delete

void	operator= (const fvMeshFunctionObject &)=delete

Protected Member Functions inherited from regionFunctionObject
virtual const objectRegistry &	obr () const

template<class ObjectType >
bool	foundObject (const word &fieldName) const

template<class ObjectType >
const ObjectType *	cfindObject (const word &fieldName) const

template<class ObjectType >
const ObjectType *	findObject (const word &fieldName) const

template<class ObjectType >
ObjectType *	findObject (const word &fieldName)

template<class ObjectType >
ObjectType *	getObjectPtr (const word &fieldName) const

template<class ObjectType >
const ObjectType &	lookupObject (const word &fieldName) const

template<class ObjectType >
ObjectType &	lookupObjectRef (const word &fieldName) const

template<class ObjectType >
bool	store (word &fieldName, const tmp< ObjectType > &tfield, bool cacheable=false)

template<class ObjectType >
bool	storeInDb (const word &fieldName, const tmp< ObjectType > &tfield, const objectRegistry &obr)

bool	writeObject (const word &fieldName)

bool	clearObject (const word &fieldName)

void	clearObjects (const wordList &objNames)

	regionFunctionObject (const regionFunctionObject &)=delete

void	operator= (const regionFunctionObject &)=delete

Protected Member Functions inherited from stateFunctionObject
const functionObjects::properties &	stateDict () const

functionObjects::properties &	stateDict ()

	stateFunctionObject (const stateFunctionObject &)=delete

void	operator= (const stateFunctionObject &)=delete

Protected Member Functions inherited from timeFunctionObject
void	clearOutputObjects (const wordList &objNames)

	timeFunctionObject (const timeFunctionObject &)=delete

void	operator= (const timeFunctionObject &)=delete

Protected Member Functions inherited from functionObject
word	scopedName (const word &name) const

Protected Member Functions inherited from writeFile
void	initStream (Ostream &os) const

fileName	baseFileDir () const

fileName	baseTimeDir () const

virtual autoPtr< OFstream >	createFile (const word &name, scalar timeValue) const

virtual autoPtr< OFstream >	createFile (const word &name) const

virtual void	resetFile (const word &name)

Omanip< int >	valueWidth (const label offset=0) const

void	operator= (const writeFile &)=delete

Protected Attributes inherited from fvMeshFunctionObject
const fvMesh &	mesh_

Protected Attributes inherited from regionFunctionObject
word	subRegistryName_

const objectRegistry &	obr_

const objectRegistry *	obrPtr_

Protected Attributes inherited from timeFunctionObject
const Time &	time_

Protected Attributes inherited from writeFile
const objectRegistry &	fileObr_

const fileName	prefix_

word	fileName_

autoPtr< OFstream >	filePtr_

label	writePrecision_

bool	writeToFile_

bool	updateHeader_

bool	writtenHeader_

bool	useUserTime_

scalar	startTime_

Detailed Description

Creates a droplet size distribution via interrogating a continuous phase fraction field.

Looks up a phase-fraction (alpha) field and splits the mesh into regions based on where the field is below the threshold value. These regions ("droplets") can now be analysed.

Regions:

print the regions connected to a user-defined set of patches. (in spray calculation these form the liquid core)
print the regions with too large volume. These are the 'background' regions.
(debug) write regions as a volScalarField
(debug) print for all regions the sum of volume and alpha*volume

Output (volume scalar) fields include:

alpha_liquidCore : alpha with outside liquid core set to 0
alpha_background : alpha with outside background set to 0.

Histogram:

determine histogram of diameter (given minDiameter, maxDiameter, nBins)
write graph of number of droplets per bin
write graph of sum, average and deviation of droplet volume per bin
write graph of sum, average and deviation of user-defined fields. For volVectorFields these are those of the 3 components and the magnitude.
(optional) write graph of histogram of centroids on iso planes downstream of the injector determined by origin, direction and maxDiameter up to maxDownstream

Operands:

Operand	Type	Location
`input`	-	-
`output` file	-	$FOAM_CASE/postProcessing/<FO>/<time>/<files>
`output` field	-	-

Usage

Minimal example by using system/controlDict.functions:

regionSizeDistribution1
{
    // Mandatory entries (unmodifiable)
    type            regionSizeDistribution;
    libs            (fieldFunctionObjects);

    // Mandatory entries (runtime modifiable)
    field           alpha;
    patches         (inlet);
    fields          (p U);
    threshold       0.4;
    maxDiameter     5e-5;
    nBins           100;
    setFormat       gnuplot;

    // Optional entries (runtime modifiable)
    minDiameter     0.0;
    coordinateSystem
    {
        origin  (0 0 0);
        rotation
        {
            type    axes;
            e3      (0 0 1);
            e1      (1 0 0);
        }
    }

    // Optional downstream iso-plane bins
    isoPlanes       true;

        // Mandatory entries if isoPlanes=true   (runtime modifiable)
        // Plane normal and point definition
        origin          (1e-4 0 5e-4);
        direction       (1 0 1);

        // Maximum diameter of the cylinder formed by the origin point
        // and direction
        maxD            3e-4;

        // Maximum downstream distance
        maxDownstream   6e-4;

        // Number of iso-plane bins
        nDownstreamBins 20;

    // Optional (inherited) entries
    ...
}

where the entries mean:

Property	Description	Type	Req'd	Dflt
`type`	Type name: regionSizeDistribution	word	yes	-
`libs`	Library name: fieldFunctionObjects	word	yes	-
`field`	Phase field to interrogate	word	yes	-
`patches`	Patches wherefrom the liquid core is identified	wordList	yes	-
`fields`	Fields to sample	wordList	yes	-
`threshold`	Phase fraction applied to delimit regions	scalar	yes	-
`maxDiameter`	Maximum droplet diameter	scalar	yes	-
`minDiameter`	Minimum droplet diameter	scalar	no	0.0
`nBins`	Number of bins for histogram	label	yes	-
`setFormat`	Output format	word	yes	-
`isoPlanes`	Flag for isoPlanes	bool	no	false
`origin`	Origin of the plane when isoPlanes is used	vector	yes	-
`direction`	Direction of the plane when isoPlanes is used	vector	yes	-
`maxD`	Maximum diameter of the sampling cylinder when isoPlanes is used	vector	yes	-
`nDownstreamBins`	Number of bins when isoPlanes is used	label	yes	-
`maxDownstream`	Maximum distance from origin when isoPlanes is used	scalar	yes	-

The inherited entries are elaborated in:

Usage by the postProcess utility is not available.

See also

Foam::functionObject
Foam::functionObjects::fvMeshFunctionObject
Foam::functionObjects::writeFile
ExtendedCodeGuide::functionObjects::field::regionSizeDistribution

Source files

Definition at line 327 of file regionSizeDistribution.H.

Constructor & Destructor Documentation

◆ regionSizeDistribution() [1/2]

regionSizeDistribution	(	const word &	name,
		const Time &	runTime,
		const dictionary &	dict
	)

Definition at line 307 of file regionSizeDistribution.C.

References dict, and Foam::read().

Here is the call graph for this function:

◆ regionSizeDistribution() [2/2]

regionSizeDistribution ( const regionSizeDistribution & )

delete

◆ ~regionSizeDistribution()

virtual ~regionSizeDistribution ( )

virtualdefault

Member Function Documentation

◆ TypeName()

TypeName ( "regionSizeDistribution" )

◆ operator=()

void operator= ( const regionSizeDistribution & )

delete

◆ read()

bool read ( const dictionary & dict )

virtual

Reimplemented from writeFile.

Definition at line 325 of file regionSizeDistribution.C.

References dict, Foam::endl(), format(), Foam::Info, writer< Type >::New(), coordinateSystem::New(), regionFunctionObject::read(), and writeFile::read().

Here is the call graph for this function:

◆ execute()

bool execute ( )

virtual

Implements functionObject.

Definition at line 371 of file regionSizeDistribution.C.

◆ write()

bool write ( )

virtual

Implements functionObject.

Definition at line 377 of file regionSizeDistribution.C.

References Foam::constant::atomic::alpha, alphaPtr, Foam::cbrt(), VectorSpace< Vector< scalar >, scalar, 3 >::componentNames, GeometricField::correctBoundaryConditions(), fvPatchField::coupled(), Foam::expressions::patchExpr::debug, delta, Foam::dimless, Foam::fvc::domainIntegrate(), Foam::endl(), fld, forAll, forAllConstIters(), forAllIters, Foam::gSum(), Foam::Info, Log, Foam::mag(), UPstream::master(), IOobject::MUST_READ, Foam::name(), dimensioned::name(), VectorSpace< Vector< scalar >, scalar, 3 >::nComponents, Foam::nl, IOobject::NO_READ, IOobject::NO_WRITE, regionSplit::nRegions(), fvPatch::patch(), fvPatchField::patch(), fvPatchField::patchInternalField(), fvPatchField::patchNeighbourField(), Foam::constant::mathematical::pi(), Foam::pow3(), polyPatch::start(), token::TAB, Foam::type(), dimensioned::value(), x, and Foam::Zero.

Here is the call graph for this function:

◆ regionSum()

Foam::Map<Type> regionSum	(	const regionSplit &	regions,
		const Field< Type > &	fld
	)		const

Definition at line 30 of file regionSizeDistributionTemplates.C.

References fld, forAll, regionSplit::nRegions(), and Foam::Zero.

Here is the call graph for this function:

◆ extractData()

Foam::List<Type> extractData	(	const labelUList &	keys,
		const Map< Type > &	regionData
	)		const

Definition at line 53 of file regionSizeDistributionTemplates.C.

References forAll, and UList::size().

Here is the call graph for this function:

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

src/functionObjects/field/regionSizeDistribution/regionSizeDistribution.H
src/functionObjects/field/regionSizeDistribution/regionSizeDistribution.C
src/functionObjects/field/regionSizeDistribution/regionSizeDistributionTemplates.C

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ regionSizeDistribution() [1/2]

◆ regionSizeDistribution() [2/2]

◆ ~regionSizeDistribution()

Member Function Documentation

◆ TypeName()

◆ operator=()

◆ read()

◆ execute()

◆ write()

◆ regionSum()

◆ extractData()